> 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 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 o 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á-los 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 da 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`, a URI deles 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 para a 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 de outros parâmetros relevantes de rastreamento do gateway. 2. Chame a API PageLoad, passando a URI para o campo PageUrl em eventos de abertura do app. * Consulte a [Crie um Page Load](https://integrations.impact.com/brand-api-reference/reference/page-load/page-load) na 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 ![](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 URI Scheme, 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 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 ![](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** nomeie a regra de forma descritiva. * O nome deve indicar a finalidade da regra. 5. Adicione um *Condição* com o **App Name** 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 deseja redirecionar os usuários. * Esta etapa é recomendada e permitirá que você use o recurso apenas para caminhos que seu app consegue reconhecer. * Use [expressão regular](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, ![](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 para 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 ![](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 intermediária para alinhá-lo à sua marca: | tabela 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 definir o texto e 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 definir o texto e a cor da fonte usando o seletor de cores ou [hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) notação. | | 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 de URI do seu app móvel. Você pode definir o texto e a cor da fonte usando o seletor de cores ou [hexadecimal](https://en.wikipedia.org/wiki/Hexadecimal) notação. | | Rótulo e cor da fonte do link Continuar | O rótulo do link é o texto exibido no link que abre a URL da sua página web de destino. Você pode definir o texto e 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 | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Abertura do app |

Indique quando abrir seu app móvel:

• Assim que a página intermediária carregar \[Recomendado] — abra automaticamente o seu 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, solicite 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 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 | 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 de esquema de URI resultante será `acmeapp://home`. | | Regex de URI personalizado |

Por padrão, o impact.com cria um link de esquema de URI acrescentando 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 o seu esquema de URI for acmeapp, o esquema de URI resultante será acmeapp\://product/12345.

No entanto, você também pode usar expressão regular para especificar quais partes de uma URL da página de destino devem ser extraídas e adicionadas ao esquema de URI. Ex.: 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** 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 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.