> 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 a lógica de deep linking com esquemas 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 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 interagirem com sua landing page 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ê vai querer direcioná-lo para a versão web dessa página. Você também pode configurar uma página 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 web devem ser 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 será `acmeapp://item/view/12345`. * Você deve conhecer quaisquer caminhos não suportados (ou seja, caminhos que não estejam mapeados) no seu app móvel para poder implementar filtros correspondentes na página intermediária dentro das 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 outros parâmetros relevantes de rastreamento de gateway. 2. Chame a API PageLoad, passando a URI para o campo PageUrl nos eventos de abertura do app. * Consulte o [Criar um Page Load](https://integrations.impact.com/brand-api-reference/reference/page-load/page-load) 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/45f862e198f73982700ff092afe256a7fe2e0fff) **\[Perfil do usuário] → Configurações**. 2. Na coluna da direita, em *Rastreamento*, selecione **Geral**. 3. No campo Esquema de URI, selecione ![](/files/f88dd768cd29f591e29b89ede19728f1b980ca8c) **\[Editar]**. 4. Insira 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á por 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/45f862e198f73982700ff092afe256a7fe2e0fff) **\[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 **Nome do app** parâmetro e insira 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 outro]** condição com o **Página de destino** parâmetro 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 possa 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 **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. No *Ação* campo, use o ![](/files/fd163b7ecfbcabc8d4b0b2247a6ffecec5a92253) **\[Menu suspenso]** para selecionar **Deep linking móvel**. 2. Personalize o modelo da página intermediária para alinhar à 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 destaque. 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 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 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 do 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. |
{% 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 seguintes campos. | Campo | Descrição | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Abertura do 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 — após o carregamento da página intermediária, 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; depois disso, 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 URI, como o da página inicial do seu site, a ser usado quando nenhum for extraído da 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 seu app. Por exemplo, 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 de URI resultante será `acmeapp://home`. | | Regex URI personalizada |

Por padrão, o impact.com cria um link de esquema de URI anexando caminhos da URL da landing page de destino ao esquema de URI. Por exemplo, se a URL da sua página de destino for , e o 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. Por exemplo, se a URL da sua página de destino for , e você inserir uma expressão regular 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 %} #### Uso de 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 programas 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 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 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.