# Solução de problemas com links universais 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 app 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 conta 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 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 busca 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 estejam configurados em um redirecionamento subsequente, normalmente o 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, por padrão, inclui 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 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 oferece suporte a redirecionamentos via Universal Links**

Alguns WebViews podem bloquear Universal Links, o que faria com que os links de rastreamento fossem abertos 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 redes sociais**

Alguns apps de redes sociais, 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 o deep linking e a atribuição a partir de apps de redes sociais.
{% 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) 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 incorporado SFSafariViewController, WKWebView ou UIWebView, 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: 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:

```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/platform-features/tracking/set-up-tracking/troubleshooting-universal-links-in-app-to-app-tracking.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
