# Configurar Lógica de Deep Linking com Esquemas URI

Certos apps móveis com navegadores personalizados no app não suportam todas as tecnologias de deep linking, tornando necessário usar [esquemas URI](https://en.wikipedia.org/wiki/List_of_URI_schemes) para garantir 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 landing page de vendas por meio desses navegadores personalizados no app.

#### 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 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á-lo para a versão web dessa página. Você também pode configurar uma landing page 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.

<div data-with-frame="true"><figure><img src="/files/17fb64f68802299ae4d5890da85d30fb70235fc5" alt="" width="296"><figcaption></figcaption></figure></div>

#### Pré-requisitos

* O esquema 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 web devem ser mapeados para o esquema 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 todos os caminhos não suportados (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 URI

{% stepper %}
{% step %}
**Etapa 1: Configure o rastreamento de esquema URI no seu app**

Configure seu app móvel para rastrear quando o referrer for um esquema URI.

1. Analise o `clickid` do esquema 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/impact-brand/reference/create-a-pageload) 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: Configure o esquema 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 Esquema URI, selecione ![](/files/f88dd768cd29f591e29b89ede19728f1b980ca8c) **\[Editar]**.
4. Digite o **esquema URI**do seu app móvel, excluindo `://` do final do esquema.
   * Se houver vários esquemas URI 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 ![](/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 um *Condição* com o parâmetro **Nome do app** e informe as plataformas de app móvel para as quais a regra é aplicável.
   * O impact.com recomenda incluir *Facebook*, *Instagram*, e *X*.
6. Opcionalmente, ![](/files/f04b408fd368673af7defa3c8a7a0cac711f0eb8) **\[Adicionar outro]** condição com o parâmetro **Página de destino** e especifique caminhos e domínios para os quais você quer 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 landing pages que contenham caminhos específicos — veja o exemplo abaixo.

   ```programlisting
   ^(https?:\/\/)?(www\.)?(domain\.com|sub\.domain\.com)(\/(shop|product)(\/[^?]*?)?)?(\/?(\?.*)?)?$
   ```
7. Opcionalmente, ![](/files/f04b408fd368673af7defa3c8a7a0cac711f0eb8) **\[Adicionar outro]** condição 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="/files/539e3f5c2d158876ba4e9e2c9d68d3f8791adbf5" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
**Etapa 4: Personalize a página intermediária para Mobile Deep Linking**

1. Em *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 em destaque na sua página intermediária. 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 nos formatos .gif, .jpg, .png ou .svg. A imagem não pode ter tamanho > 1 MB.                                                                                                                                                               |
| Fazer upload da imagem de capa          | Faça upload de uma imagem de fundo adequada nos formatos .gif, .jpg, .png ou .svg. A imagem não pode ter tamanho > 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 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 de destino na web. 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.               |

<div data-with-frame="true"><figure><img src="/files/47035f79755a888ab316100f32a84e491ce0dfdd" alt="" width="373"><figcaption></figcaption></figure></div>
{% endstep %}

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

1. Em *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                   | <p>Indique quando abrir seu app móvel:</p><p>• <strong>Assim que a página intermediária carregar</strong> <mark style="color:$success;">\[Recomendado]</mark> — abre automaticamente seu app móvel no dispositivo do usuário assim que a página intermediária carregar.</p><p>• <strong>Quando o botão for tocado</strong> — depois que a página intermediária carregar, exija que o usuário aprove a abertura do seu app móvel no dispositivo dele.</p>                                                                                                                                                                                                                                                                                                                                               |
   | Redirecionamento automático | Selecione o ![](/files/27a40f26b5bd84bf51b027f804aa6f07400faa96) **\[Caixa de seleção 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 **10**-segundos de tempo limite.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   | Caminho URI padrão          | Digite um caminho 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 abra 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 de esquema URI resultante será `acmeapp://home`.                                                                                                                                                                                                                                                                                                                                                                    |
   | Regex URI personalizado     | <p>Por padrão, o impact.com cria um link de esquema URI anexando caminhos da URL da landing page de destino ao esquema URI. Ex.: se a URL da sua 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">regex</a> para especificar quais partes da URL de uma página de destino devem ser extraídas e adicionadas ao esquema URI. Ex.: se a URL da sua página de destino for <code><https://acme.com/product/12345></code>, e você inserir uma regex de <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 %}

#### Usando páginas intermediárias com postbacks

Se você usar [postbacks](/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/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 secundários.


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/tracking/mobile-app-tracking/configure-deep-linking-logic-with-uri-schemes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
