> 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 Alguns 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 um rastreamento consistente quando o deep linking padrão falhar. Siga as etapas deste artigo para aumentar a precisão do rastreamento de conversões quando os usuários acessarem 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 direcionar 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ê vai querer direcioná-los para a versão web dessa página. Você também pode configurar uma página de destino intersticial 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 dos URLs da web precisam ser mapeados para o esquema de URI do seu app móvel para que o redirecionamento funcione; por exemplo, se o URL da ACME Corporation for `https://acme.com/item/view/12345`, o URI será `acmeapp://item/view/12345`. * Você deve conhecer quaisquer caminhos não compatíveis (ou seja, caminhos que não estejam mapeados) no seu app móvel para que possa implementar filtros correspondentes à página intersticial nas condições da regra, conforme detalhado abaixo. #### Configurar rastreamento do esquema de URI {% stepper %} {% step %} **Etapa 1: Configure o rastreamento do 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 carregamento de página](https://integrations.impact.com/brand-api-reference/reference/page-load/page-load) Consulte a referência da API para obter 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 ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**. 2. Na coluna da direita, em *Rastreamento*, selecione **Geral**. 3. No campo Esquema de URI, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-a600f51d86cbf3c02c36ea5cf311867b2bb4cf89%2F00a06da7505c774dc36762a66bcd169b1d62cb35af729e3383729755194758fb.svg?alt=media) **\[Editar]**. 4. Insira o **esquema de URI**, excluindo `://` do final do esquema. * Se vários esquemas de URI forem listados, o impact.com usará o primeiro esquema por padrão. 5. Selecione **Salvar**. {% endstep %} {% step %} **Etapa 3: Crie a regra de redirecionamento** 1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[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 um *Condição* com o **Nome do app** parâmetro e informe as plataformas de app móvel às quais a regra se aplica. * O impact.com recomenda incluir *Facebook*, *Instagram*, e *X*. 6. Opcionalmente, ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[Adicionar outro]** condição com o **Página de destino** parâmetro e especifique os 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 o seu app pode 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, ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[Adicionar outro]** condição com o **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 intersticial para Mobile Deep Linking** 1. No *Ação* campo, use o ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Menu suspenso]** para selecionar **Mobile Deep Linking**. 2. Personalize o modelo da página intersticial para alinhá-lo à sua marca: | Campos | Descrição | | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Texto do cabeçalho e cor da fonte | Seu texto de cabeçalho é uma frase curta exibida na página intersticial em fonte grande. Você pode especificar o texto 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 | Seu texto de subtítulo é uma frase curta exibida na página intersticial abaixo do texto do cabeçalho. Você pode especificar o texto e definir a cor da fonte usando o seletor de cores ou [hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) notação. | | Fazer upload do logotipo | Envie o logotipo da sua marca nos formatos .gif, .jpg, .png ou .svg. A imagem não pode ter mais de 1 MB. | | Fazer upload da imagem de capa | Envie uma imagem de fundo adequada nos formatos .gif, .jpg, .png ou .svg. A imagem não pode ter mais de 1 MB. | | Rótulo do botão Abrir app e cores | O rótulo do botão é o texto exibido no botão que abre o esquema de URI do seu app móvel. Você pode especificar o texto 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 o URL da página da web de destino. Você pode especificar o texto 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. No *Ação* campo, role até o final das opções de personalização visual e preencha os campos a seguir. | Campo | Descrição | | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Abertura do app |

Indique quando abrir seu app móvel:

• Assim que a página intersticial for carregada \[Recomendado] — abra automaticamente seu app móvel no dispositivo do usuário assim que a página intersticial carregar.

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

| | Redirecionamento automático | Selecione o ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[caixa desmarcada]** para definir um tempo limite caso a abertura do app falhe; após isso, eles serão redirecionados automaticamente para o link da web. O impact.com recomenda um **10**tempo limite de - 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 do URL. Isso garante que seu app seja aberto com sucesso até mesmo por um navegador personalizado no app que, de outra forma, falharia ao abrir o app. Por exemplo, se o URL da sua página de destino for `https://acme.com`, e você inserir um caminho URI padrão de `home`, o link resultante do esquema de URI será `acmeapp://home`. | | Expressão regular de URI personalizada |

Por padrão, o impact.com cria um link de esquema de URI acrescentando os caminhos do URL da página de destino ao esquema de URI. Por exemplo, se o 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 de um URL de página de destino devem ser extraídas e acrescentadas ao esquema de URI. Por exemplo, se o 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** salvar sua regra quando terminar. {% endstep %} {% endstepper %} #### Usando páginas intersticiais 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 programas do impact.com, o impact.com recomenda implementar a página intersticial 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 enviada para um dos programas filhos. --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.