> 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/set-up-tracking/troubleshooting-universal-links-in-app-to-app-tracking.md).

# Solução de problemas de Universal Links no rastreamento de app para app

<a href="https://pxa.impact.com/student/activity/1117597?sid=0c0e3e5c-54c9-4435-9bee-ebcdccb7f292&#x26;sid_i=0?utm_source=app.impact.com&#x26;utm_medium=owned-platform&#x26;utm_content=tra-350&#x26;utm_campaign=help-center" class="button primary">Faça o curso PXA</a>

Os Links Universais são validados no nível do sistema operacional (SO) e exigem uma ação iniciada pelo usuário, como clicar em um link da web, para abrir o aplicativo móvel.

#### Solucionar problemas de Links Universais

{% stepper %}
{% step %}

#### **Verifique se o clique no app do parceiro é um clique instanciado pelo usuário**

Suponha que o link não seja uma tag âncora comum, mas em vez disso instancie uma nova **WebView** (Veja a explicação no final desta página). Nesse caso, isso não é contado como navegação iniciada pelo usuário, então o SO não abrirá o Link Universal. Este é o cenário mais comum. Para resolver isso, considere usar um link âncora comum dentro de uma WebView (WKWebView, UIWebView ou SFSafariViewController) para que o Link Universal abra o aplicativo.

Outros exemplos de cliques não instanciados pelo usuário são colar a URL diretamente na barra de pesquisa ou navegar para o link em JavaScript usando `onload()` ou `click()`.
{% endstep %}

{% step %}

#### **Verifique se a página para a qual você está enviando o usuário permite Links Universais**

Em alguns casos, o impact.com depende de Links Universais configurados em um redirecionamento subsequente, geralmente no domínio do anunciante.

* Por exemplo, o domínio de rastreamento do impact.com (`goto.advertiser.com`) redirecionaria para `advertiser.com`. Os Links Universais são configurados no `advertiser.com` domínio. Portanto, é importante verificar se a página para a qual você está enviando o usuário está habilitada para Links Universais. Você pode fazer isso verificando o arquivo de associação da Apple localizado no domínio do anunciante.
* Em nosso exemplo, `http://advertiser.com/.well-known/apple-app-site-association`, você observará que o arquivo de associação do domínio de rastreamento do impact.com é padronizado para incluir todos os subdiretórios.

{% hint style="info" %}
**Observação:** Embora os Links Universais não funcionem quando um redirecionamento em JavaScript está em uso, os redirecionamentos HTTP 3xx ainda preservam a referência ao evento original do usuário. O impact.com usa redirecionamentos HTTP 3xx no rastreamento e, por isso, os links após um clique no domínio de rastreamento abrem o app do anunciante com sucesso quando os demais critérios são atendidos.
{% endhint %}

Por exemplo, o arquivo de associação abaixo permitiria Links Universais para `advertiser.com/item/123` mas não os permitiria para `advertiser.com` ou `advertiser.com/section/furniture`.

```programlisting
{
   "applinks":{
      "apps":[
      ],
      "details":[
         {
            "appID":"A1AAA22BBB.com.advertiser.Advertiser",
            "paths":[
               "NOT /section/*",
               "/item/*"
            ]
         }
      ]
   }
} 
```

{% endstep %}

{% step %}

#### **Veja se a WebView inicial que abre também oferece suporte a redirecionamentos por meio de Links Universais**

Algumas WebViews podem bloquear Links Universais, o que faria com que os links de rastreamento fossem abertos dentro da WebView em vez de abrir o app do anunciante. Embora incomum, isso pode acontecer quando a política de navegação da WebView é definida como WKNavigationActionPolicyAllow + 2. Isso pode fazer com que a WebView navegue até o link sem tentar o Link Universal.
{% endstep %}

{% step %}

#### **Revise as políticas das redes sociais**

Alguns aplicativos de mídia social, como o Facebook, bloqueiam Links Universais. Se for esse o caso, usar um **Mobile App Interstitial** pode ser útil, e recomendamos entrar em contato com seu CSM para obter ajuda com isso (ou [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml?createTicket=true)). O impact.com está trabalhando ativamente em maneiras de melhorar o deep linking e a atribuição de aplicativos de mídia social.
{% endstep %}
{% endstepper %}

#### Esclarecimento adicional da Apple

Se você instanciar um [SFSafariViewController](https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller) , [WKWebView](https://developer.apple.com/documentation/webkit/wkwebview) , ou [UIWebView](https://developer.apple.com/documentation/uikit/uiwebview) objeto para tratar um Link Universal, o iOS abre seu site no Safari em vez de abrir seu app. No entanto, se o usuário tocar em um Link Universal dentro de um objeto SFSafariViewController, WKWebView ou UIWebView incorporado, o iOS abre seu app.

Consulte o [Suporte a Links Universais](https://developer.apple.com/library/archive/documentation/General/Conceptual/AppSearch/UniversalLinks.html) artigo de ajuda da Apple para obter mais informações.


---

# 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/set-up-tracking/troubleshooting-universal-links-in-app-to-app-tracking.md?ask=<question>&goal=<endgoal>
```

`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.