> 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 aplicativos móveis com navegadores internos personalizados não oferecem suporte a todas as tecnologias de deep linking, por isso é 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 internos personalizados.

#### Fluxograma do resultado desejado

O fluxograma abaixo representa o resultado que você pretende 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 à página relevante do aplicativo móvel sempre que possível. Caso isso não seja possível porque o aplicativo não está instalado no dispositivo do usuário, você deverá encaminhá-lo à versão web dessa página. Você também pode configurar uma página de destino intersticial no impact.com, o que permitirá garantir que o usuário só seja redirecionado para páginas de destino reconhecidas pelo seu aplicativo.

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-fed65268965e8e1db8473062d52095b14b220e3d%2F260dbc4571ab3a646158dccf6f817e64888da69f1fe481f7a4d9c2f90fe73003.png?alt=media" alt="" width="296"><figcaption></figcaption></figure></div>

#### Pré-requisitos

* O esquema de URI do seu aplicativo móvel, por exemplo, **`acmeapp://`**`item/view/12345`, deve ser o mesmo nas versões do seu aplicativo para Android e iOS.
* Os caminhos dos URLs da web devem ser mapeados para o esquema de URI do aplicativo móvel para que o redirecionamento funcione. Por exemplo, se o URL da ACME Corporation for `https://acme.com/item/view/12345`, o URI correspondente será `acmeapp://item/view/12345`.
* Você precisa saber quais caminhos não são compatíveis com seu aplicativo móvel (ou seja, caminhos que não estão mapeados) para implementar filtros correspondentes para a página intersticial nas condições da regra, conforme detalhado abaixo.

#### Configurar o rastreamento do esquema de URI

{% stepper %}
{% step %}
**Etapa 1: configurar o rastreamento do esquema de URI no seu aplicativo**

Configure seu aplicativo móvel para rastrear quando o referenciador for um esquema de URI.

1. Analise o `clickid` do esquema de URI e outros parâmetros relevantes de rastreamento do gateway.
2. Chame a API PageLoad, passando o URI para o campo PageUrl nos eventos de abertura do aplicativo.

   * Consulte a [Criar um carregamento de página](https://integrations.impact.com/brand-api-reference/reference/page-load/page-load) referência da API para mais detalhes.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Exemplo:</strong> <code>acmeapp://item/view/12345?clickid=abcdef12345</code>.</p></div>

{% endstep %}

{% step %}
**Etapa 2: configurar 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 à 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**do seu aplicativo móvel, sem incluir `://` no fim do esquema.
   * Se houver vários esquemas de URI listados, o impact.com usará o primeiro por padrão.
5. Selecione **Salvar**.
   {% endstep %}

{% step %}
**Etapa 3: criar uma 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 à direita, em *Técnico*, selecione **Bloqueio e redirecionamento**.
3. No canto superior direito, selecione **Configurar regra**.
4. **Dê um nome** descritivo à regra.
   * O nome deve indicar a finalidade da regra.
5. Adicione uma *Condição* com o parâmetro **Nome do app**  e informe as plataformas de aplicativos móveis às quais a regra se aplica.
   * A 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]**  condicional com o parâmetro **Página de destino**  e especifique os caminhos e domínios para os quais você deseja redirecionar os usuários.

   * Esta etapa é recomendada e permite usar o recurso apenas em caminhos que seu app consegue reconhecer.
   * Use [expressões regulares](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]**  condicional com o parâmetro **Probabilidade**  e especifique uma porcentagem do tráfego a ser redirecionada para testes A/B.

   <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FxXIQNl4H15BdQNWJdkKC%2FScreenshot%202026-05-25%20at%2011.01.54.png?alt=media&amp;token=9823e26d-1b50-4022-a1c5-24831e9b0abc" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
**Etapa 4: personalize a intersticial para Deep Linking em dispositivos móveis**

1. No campo *Ação* , 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 **Deep Linking em dispositivos móveis**.
2. Personalize o modelo da intersticial para combinar com sua marca:

| Campos                                  | Descrição                                                                                                                                                                                                                                          |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Texto do cabeçalho e cor da fonte       | O texto do cabeçalho é uma frase curta exibida em destaque na intersticial. Você pode definir o texto e escolher a cor da fonte usando o seletor de cores ou a [notação hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) .                  |
| Texto do subtítulo e cor da fonte       | O texto do subtítulo é uma frase curta exibida na intersticial, abaixo do cabeçalho. Você pode definir o texto e escolher a cor da fonte usando o seletor de cores ou a [notação hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) .         |
| Enviar logotipo                         | Envie o logotipo da sua marca nos formatos .gif, .jpg, .png ou .svg. A imagem não pode ter mais de 1 MB.                                                                                                                                           |
| Enviar 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 e cores do botão Abrir app       | O rótulo do botão é o texto exibido no botão que abre o esquema URI do seu aplicativo móvel. Você pode definir o texto e escolher a cor da fonte usando o seletor de cores ou a [notação hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) . |
| Rótulo do link Continuar e cor da fonte | O rótulo do link é o texto exibido no link que abre o URL da sua página de destino na Web. Você pode definir o texto e escolher a cor da fonte usando o seletor de cores ou a [hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) notação.    |

<div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-05ea3ea50f8f93b549691e27fe0bc882cd02a9c9%2Fbdbeb71e1227b728b8a97a7b0fa9083cd676a5ab73dd505b312ee1a60c80f751.png?alt=media" alt="" width="373"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Etapa 5: configurar a lógica de abertura do app e o redirecionamento automático**

1. No campo *Ação* , role até o fim das opções de personalização visual e preencha os campos a seguir.

   | Campo                       | Descrição                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Abertura do app             | <p>Indique quando abrir seu app para dispositivos móveis:</p><p>• <strong>Assim que o intersticial carregar</strong> <mark style="color:$success;">\[Recomendado]</mark> — abra automaticamente seu app para dispositivos móveis no dispositivo do usuário assim que o intersticial carregar.</p><p>• <strong>Quando o botão for tocado</strong> — depois que o intersticial carregar, peça que o usuário autorize a abertura do seu app para dispositivos móveis no dispositivo dele.</p>                                                                                                                                                                                                                                                                                                                                |
   | Redirecionamento automático | Selecione a ![](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 esse período, o usuário será redirecionado automaticamente para o link da web. A impact.com recomenda um tempo limite de **10**segundos.                                                                                                                                                                                                                                                                                                              |
   | Caminho URI padrão          | Insira um caminho URI, como o da página inicial do seu site, para ser usado quando nenhum caminho for extraído da URL. Isso garante que seu app seja aberto corretamente, inclusive em navegadores personalizados dentro do app que, de outra forma, não conseguiriam abri-lo. Por exemplo, se a URL da página de destino for `https://acme.com`, e você inserir o caminho URI padrão `home`, o link do esquema URI resultante será `acmeapp://home`.                                                                                                                                                                                                                                                                                                                                                                     |
   | Regex de URI personalizada  | <p>Por padrão, a impact.com cria um link de esquema URI acrescentando ao esquema URI os caminhos da URL da página de destino. Por exemplo, se a URL da página de destino for <code><https://acme.com/product/12345></code>, e seu esquema URI for <code>acmeapp</code>, o esquema URI resultante será <code>acmeapp\://product/12345</code>.</p><p>No entanto, você também pode usar <a href="https://en.wikipedia.org/wiki/Regular_expression">expressões regulares</a>  para especificar quais partes da URL da página de destino devem ser extraídas e acrescentadas ao esquema URI. Por exemplo, se a URL da página de destino for <code><https://acme.com/product/12345></code>, e você inserir a regex <code>acme.com.\*$</code>, o esquema URI resultante será <code>acmeapp\://acme.com/product/12345</code>.</p> |
2. Lembre-se de **Salvar** sua regra quando terminar.
   {% endstep %}
   {% endstepper %}

#### Como usar intersticiais com postbacks

Se você usa [postbacks](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md) para acompanhar conversões em vários tipos de programa da impact.com, a impact.com recomenda implementar o intersticial apenas no seu programa principal. O programa principal realiza o último redirecionamento antes da página de destino, garantindo que todos os cliques sejam rastreados antes da abertura do app para dispositivos móveis. Essa abordagem garante que a atribuição funcione corretamente quando a conversão é 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=<question>&goal=<user_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.
