> 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 links universais no rastreamento app-to-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 Universal Links são validados no nível do sistema operacional (SO) e exigem uma ação iniciada pelo usuário, como um clique em um link da web, para abrir o aplicativo móvel.

#### Solucionar problemas de Universal Links

{% 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 um novo **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 Universal Link. Este é o cenário mais comum. Para resolver isso, você deve considerar um link âncora comum dentro de uma WebView (WKWebView, UIWebView ou SFSafariViewController) para que o Universal Link abra o app.

Outros exemplos de cliques não instanciados pelo usuário são copiar e colar a URL diretamente na barra de pesquisa ou navegar até 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 Universal Links**

Em alguns casos, a impact.com depende de que os Universal Links sejam configurados em um redirecionamento subsequente, geralmente no domínio do anunciante.

* Por exemplo, o domínio de rastreamento da impact.com (`goto.advertiser.com`) redirecionaria para `advertiser.com`. Os Universal Links 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 Universal Links. Você pode fazer isso verificando o arquivo de associação da Apple localizado no domínio do anunciante.
* No nosso exemplo, `http://advertiser.com/.well-known/apple-app-site-association`, você notará que o arquivo de associação do domínio de rastreamento da impact.com inclui todos os subdiretórios por padrão.

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

Por exemplo, o arquivo de associação abaixo permitiria Universal Links 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 é aberta também oferece suporte a redirecionamentos via Universal Links**

Algumas WebViews podem bloquear Universal Links, 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 está definida como WKNavigationActionPolicyAllow + 2. Isso pode fazer com que a WebView navegue até o link sem tentar o Universal Link.
{% endstep %}

{% step %}

#### **Revise as políticas de mídia social**

Alguns apps de mídia social, como o Facebook, bloqueiam Universal Links. Se for esse o caso, usar um **Intersticial de App Móvel** 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)). A impact.com está trabalhando ativamente em maneiras de melhorar a deep linking e a atribuição a partir de apps de mídia social.
{% endstep %}
{% endstepper %}

#### Mais esclarecimentos 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 lidar com um Universal Link, o iOS abre seu site no Safari em vez de abrir seu app. No entanto, se o usuário tocar em um Universal Link dentro de um objeto SFSafariViewController, WKWebView ou UIWebView incorporado, o iOS abre seu app.

Consulte o artigo de ajuda da Apple sobre [Suporte a Universal Links](https://developer.apple.com/library/archive/documentation/General/Conceptual/AppSearch/UniversalLinks.html) para 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 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/set-up-tracking/troubleshooting-universal-links-in-app-to-app-tracking.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.