> 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 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 com Universal Links

{% stepper %}
{% step %}

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

Suponha que o link não seja uma tag âncora regular, mas, em vez disso, instancie um novo **WebView** (Veja a explicação no final desta página). Nesse caso, isso não conta como navegação iniciada pelo usuário, então o SO não abrirá o Universal Link. Esse é 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 aplicativo.

Outros exemplos de cliques não iniciados 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, o impact.com depende de os Universal Links estarem configurados em um redirecionamento subsequente, geralmente o domínio do anunciante.

* Por exemplo, o domínio de rastreamento do 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 tem Universal Links ativados. 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 do impact.com, por padrão, inclui todos os subdiretórios.

{% hint style="info" %}
**Observação:** Embora os Universal Links não funcionem quando é usado um redirecionamento em JavaScript, 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, portanto, links acessados após um clique no domínio de rastreamento abrem o app do anunciante com sucesso 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 usar 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 **Intersticial de aplicativo 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)). O impact.com está trabalhando ativamente em maneiras de melhorar o 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 tratar 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 [Suporte a Universal Links](https://developer.apple.com/library/archive/documentation/General/Conceptual/AppSearch/UniversalLinks.html) artigo de ajuda 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.