> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/mobile-app-tracking/configure-deep-linking-logic-with-uri-schemes.md). # Configurar lógica de deep linking com esquemas de URI Certos apps móveis com navegadores personalizados no app não oferecem suporte a todas as tecnologias de deep linking, tornando necessário usar [esquemas de URI](https://en.wikipedia.org/wiki/List_of_URI_schemes) para garantir rastreamento consistente quando o deep linking padrão falha. Siga as etapas neste artigo para melhorar a precisão do rastreamento de conversões quando os usuários interagirem com a sua página de destino de vendas por meio desses navegadores personalizados no app. #### Fluxograma do resultado desejado O fluxograma abaixo representa o resultado que você deseja alcançar. Em resumo, você quer configurar uma regra de redirecionamento no impact.com para encaminhar os usuários que clicarem no seu link de rastreamento para a página relevante do app móvel sempre que possível. Se isso não for possível porque o app não está instalado no dispositivo do usuário, você deverá direcioná-lo para a versão web dessa página. Você também pode configurar uma página de destino intermediária no impact.com, pois isso permitirá garantir que o usuário seja redirecionado apenas para páginas de destino reconhecidas pelo seu app.
#### Pré-requisitos * O esquema de URI do seu app móvel, por exemplo **`acmeapp://`**`item/view/12345`, deve ser o mesmo nas versões Android e iOS do seu app. * Os caminhos da sua URL da web devem estar mapeados para o esquema de URI do seu app móvel para que o redirecionamento funcione; por exemplo, se a URL da ACME Corporation for `https://acme.com/item/view/12345`, o URI deles será `acmeapp://item/view/12345`. * Você deve conhecer quaisquer caminhos não compatíveis (ou seja, caminhos que não estão mapeados) no seu app móvel para que possa implementar filtros correspondentes na página intermediária dentro das condições da regra, conforme detalhado abaixo. #### Configurar rastreamento de esquema de URI {% stepper %} {% step %} **Etapa 1: configure o rastreamento de esquema de URI no seu app** Configure seu app móvel para rastrear quando o referenciador for um esquema de URI. 1. Analise o `clickid` do esquema de URI e de outros parâmetros relevantes de rastreamento do gateway. 2. Chame a API PageLoad, passando o URI para o campo PageUrl em eventos de abertura do app. * Consulte a [Criar um Page Load](https://integrations.impact.com/impact-brand/reference/create-a-pageload) referência da API para mais detalhes.

Exemplo: acmeapp://item/view/12345?clickid=abcdef12345.

{% endstep %} {% step %} **Etapa 2: configure o esquema de URI do seu programa** 1. Na barra de navegação superior, selecione ![](/files/24b09e08af742531bcfb4e5dc0f1976c6026280a) **\[Perfil do usuário] → Configurações**. 2. Na coluna da direita, em *Rastreamento*, selecione **Geral**. 3. No campo URI Scheme, selecione ![](/files/f88dd768cd29f591e29b89ede19728f1b980ca8c) **\[Editar]**. 4. Digite o **esquema de URI**do seu app móvel, excluindo `://` do final do esquema. * Se vários esquemas de URI estiverem listados, o impact.com usará como padrão o primeiro esquema. 5. Selecione **Salvar**. {% endstep %} {% step %} **Etapa 3: crie a regra de redirecionamento** 1. Na barra de navegação superior, selecione ![](/files/24b09e08af742531bcfb4e5dc0f1976c6026280a) **\[Perfil do usuário] → Configurações**. 2. Na coluna da direita, em *Técnico*, selecione **Bloqueio e redirecionamento**. 3. No canto superior direito, selecione **Configurar regra**. 4. **Nome** a regra de forma descritiva. * O nome deve indicar a finalidade da regra. 5. Adicione uma *Condição* com o parâmetro **Nome do app** e informe as plataformas do app móvel às quais a regra se aplica. * O impact.com recomenda incluir *Facebook*, *Instagram*, e *X*. 6. Opcionalmente, ![](/files/f04b408fd368673af7defa3c8a7a0cac711f0eb8) **\[Adicionar outra]** condição com o parâmetro **Página de destino** e especifique caminhos e domínios para os quais você deseja redirecionar os usuários. * Esta etapa é recomendada e permitirá que você use o recurso apenas para caminhos que seu app consegue reconhecer. * Use [regex](https://en.wikipedia.org/wiki/Regular_expression) para corresponder a páginas de destino que contenham caminhos específicos — veja o exemplo abaixo. ```programlisting ^(https?:\/\/)?(www\.)?(domain\.com|sub\.domain\.com)(\/(shop|product)(\/[^?]*?)?)?(\/?(\?.*)?)?$ ``` 7. Opcionalmente, ![](/files/f04b408fd368673af7defa3c8a7a0cac711f0eb8) **\[Adicionar outra]** condição com o parâmetro **Probabilidade** parâmetro e especifique uma porcentagem do tráfego a ser redirecionada para testes A/B.
{% endstep %} {% step %} **Etapa 4: personalize a página intermediária para Mobile Deep Linking** 1. Na *Ação* campo, use o ![](/files/fd163b7ecfbcabc8d4b0b2247a6ffecec5a92253) **\[Menu suspenso]** para selecionar **Mobile Deep Linking**. 2. Personalize o modelo da página intermediária para alinhar com sua marca: | Campos | Descrição | | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Texto do cabeçalho e cor da fonte | O texto do cabeçalho é uma frase curta exibida na sua página intermediária em fonte grande. Você pode especificar o que esse texto diz e definir a cor da fonte usando o seletor de cores ou [hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) notação. | | Texto do subtítulo e cor da fonte | O texto do subtítulo é uma frase curta exibida na sua página intermediária abaixo do texto do cabeçalho. Você pode especificar o que esse texto diz e definir a cor da fonte usando o seletor de cores ou [hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) notação. | | Fazer upload do logo | Faça upload do logo da sua marca no formato .gif, .jpg, .png ou .svg. A imagem não pode ter mais de 1 MB de tamanho. | | Fazer upload da imagem de capa | Faça upload de uma imagem de fundo adequada no formato .gif, .jpg, .png ou .svg. A imagem não pode ter mais de 1 MB de tamanho. | | Rótulo e cores do botão Abrir app | O rótulo do botão é o texto exibido no botão que abre o esquema de URI para o seu app móvel. Você pode especificar o que esse texto diz e definir a cor da fonte usando o seletor de cores ou [hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) notação. | | Rótulo do link Continuar e cor da fonte | O rótulo do link é o texto exibido no link que abre a URL da sua página da web de destino. Você pode especificar o que esse texto diz e definir a cor da fonte usando o seletor de cores ou [hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) notação. |
{% endstep %} {% step %} **Etapa 5: configure a lógica de abertura do app e o redirecionamento automático** 1. Na *Ação* campo, role até o final das opções de personalização visual e preencha os campos a seguir. | Campo | Descrição | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Abrir app |

Indique quando abrir seu app móvel:

• Assim que a página intermediária carregar \[Recomendado] — abra automaticamente o app móvel no dispositivo do usuário assim que a página intermediária carregar.

• Quando o botão for tocado — depois que a página intermediária carregar, exija que o usuário aprove a abertura do app móvel no dispositivo dele.

| | Redirecionamento automático | Selecione o ![](/files/27a40f26b5bd84bf51b027f804aa6f07400faa96) **\[caixa desmarcada]** para definir um tempo limite caso a abertura do app falhe, após o qual eles serão redirecionados automaticamente para o link da web. O impact.com recomenda um tempo limite de **10**segundos. | | Caminho URI padrão | Insira um caminho de URI, como o da página inicial do seu site, para ser usado quando nenhum for extraído da URL. Isso garante que seu app seja aberto com sucesso mesmo a partir de um navegador personalizado no app que, de outra forma, falharia ao abrir seu app. Ex.: se a URL da sua página de destino for `https://acme.com`, e você inserir um caminho URI padrão de `home`, o link do esquema de URI resultante será `acmeapp://home`. | | Regex de URI personalizado |

Por padrão, o impact.com cria um link de esquema de URI anexando os caminhos da URL da página de destino ao esquema de URI. Ex.: se a URL da sua página de destino for , e seu esquema de URI for acmeapp, o esquema de URI resultante será acmeapp\://product/12345.

No entanto, você também pode usar regex para especificar quais partes da URL de uma página de destino devem ser extraídas e anexadas ao esquema de URI. Ex.: se a URL da sua página de destino for , e você inserir uma regex de acme.com.\*$, o esquema de URI resultante será acmeapp\://acme.com/product/12345.

| 2. Lembre-se de **Salvar** sua regra quando terminar. {% endstep %} {% endstepper %} #### Usando páginas intermediárias com postbacks Se você usar [postbacks](/brand/pt-br/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md) para rastrear conversões em vários tipos de programa do impact.com, o impact.com recomenda implementar a página intermediária apenas no seu programa principal. O programa principal lida com o último redirecionamento antes da página de destino, garantindo que todos os cliques sejam rastreados antes de abrir seu app móvel. Essa abordagem garante que a atribuição funcione com precisão quando a conversão for registrada em um dos programas filho. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/tracking/mobile-app-tracking/configure-deep-linking-logic-with-uri-schemes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.