> 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 app a 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 app móvel.

#### Solucionar problemas de Universal Links

{% stepper %}
{% step %}

#### **Verifique se o clique do app do parceiro foi um clique iniciado pelo usuário**

Suponha que o link não seja uma tag âncora comum, mas em vez disso instancie um novo **WebView** (Consulte a explicação no final desta página). Nesse caso, isso não é contabilizado como navegação iniciada pelo usuário, portanto 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 um 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 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 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ê observará que o arquivo de associação do domínio de rastreamento da impact.com inclui, por padrão, todos os subdiretórios.

{% hint style="info" %}
**Observação:** Embora os Universal Links não funcionem quando um redirecionamento JavaScript está em uso, os 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 o app do anunciante com sucesso quando os 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 o WebView inicial que abre também suporta redirecionamentos via Universal Links**

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

{% step %}

#### **Revise as políticas de mídias sociais**

Alguns apps de mídia social, como o Facebook, bloqueiam Universal Links. Se for esse o caso, usar um **Interstitial de app móvel** pode ser útil, e recomendamos entrar em contato com seu CSM para obter ajuda com isso (ou [contatar o suporte](https://app.impact.com/support/portal.ihtml?createTicket=true)). A impact.com está trabalhando ativamente em maneiras de melhorar o deep linking e a atribuição em apps 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 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 de dentro de um objeto SFSafariViewController, WKWebView ou UIWebView incorporado, o iOS abre seu app.

Consulte o [Suporte a Universal Links](https://developer.apple.com/library/archive/documentation/General/Conceptual/AppSearch/UniversalLinks.html) artigo de ajuda da Apple 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 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.