> 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/de/what-would-you-like-to-learn-about/platform-features/tracking/set-up-tracking/troubleshooting-universal-links-in-app-to-app-tracking.md).

# Fehlerbehebung bei Universal Links im App-zu-App-Tracking

<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">Nehmen Sie am PXA-Kurs teil</a>

Universelle Links werden auf Betriebssystemebene (OS) validiert und erfordern eine vom Nutzer ausgelöste Aktion wie einen Klick auf einen Weblink, um die mobile App zu öffnen.

#### Fehlerbehebung bei Universal Links

{% stepper %}
{% step %}

#### **Stellen Sie sicher, dass der Klick aus der App des Partners ein vom Nutzer initiierter Klick ist**

Nehmen wir an, der Link ist kein regulärer Anker-Tag, sondern instanziiert stattdessen ein neues **WebView** (Siehe Erläuterung am Ende dieser Seite). In diesem Fall wird dies nicht als vom Nutzer initiierte Navigation gezählt, sodass das OS den Universal Link nicht öffnet. Dies ist das häufigste Szenario. Um das zu beheben, sollten Sie für den Universal Link in einer WebView (WKWebView, UIWebView oder SFSafariViewController) einen regulären Anker-Link in Betracht ziehen, damit die App gestartet wird.

Weitere Beispiele für Klicks, die nicht vom Nutzer instanziiert wurden, sind das direkte Kopieren und Einfügen der URL in die Suchleiste oder das Navigieren zum Link in JavaScript mit `onload()` oder `click()`.
{% endstep %}

{% step %}

#### **Prüfen Sie, ob die Seite, auf die Sie den Nutzer weiterleiten, Universal Links unterstützt**

In einigen Fällen verlässt sich impact.com darauf, dass Universal Links bei einer nachfolgenden Weiterleitung konfiguriert sind, in der Regel auf der Domain des Werbetreibenden.

* Zum Beispiel würde die Tracking-Domain von impact.com (`goto.advertiser.com`) zu `advertiser.com`. Universal Links sind auf der `advertiser.com` Domain konfiguriert. Daher ist es wichtig zu prüfen, dass die Seite, zu der Sie den Nutzer schicken, für Universal Links aktiviert ist. Sie können dies tun, indem Sie die Apple-Zuordnungsdatei prüfen, die sich auf der Domain des Werbetreibenden befindet.
* In unserem Beispiel, `http://advertiser.com/.well-known/apple-app-site-association`, werden Sie feststellen, dass die Zuordnungsdatei der Tracking-Domain von impact.com standardmäßig alle Unterverzeichnisse einschließt.

{% hint style="info" %}
**Hinweis:** Obwohl Universal Links nicht funktionieren, wenn ein JavaScript-Redirect verwendet wird, bewahren HTTP-3xx-Weiterleitungen dennoch die Referenz auf das ursprüngliche Nutzerereignis. impact.com verwendet HTTP-3xx-Weiterleitungen im Tracking, und daher öffnen Links nach einem Klick auf die Tracking-Domain die App des Werbetreibenden erfolgreich, wenn andere Kriterien erfüllt sind.
{% endhint %}

Die folgende Zuordnungsdatei würde beispielsweise Universal Links für `advertiser.com/item/123` aber nicht für `advertiser.com` oder `advertiser.com/section/furniture`.

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

{% endstep %}

{% step %}

#### **Prüfen Sie, ob auch die anfängliche WebView, die geöffnet wird, Weiterleitungen über Universal Links unterstützt**

Einige WebViews können Universal Links blockieren, wodurch Tracking-Links innerhalb der WebView geöffnet würden, statt die App des Werbetreibenden zu öffnen. Obwohl selten, kann dies passieren, wenn die Navigationsrichtlinie der WebView auf WKNavigationActionPolicyAllow + 2 gesetzt ist. Dadurch kann die WebView zum Link navigieren, ohne den Universal Link zu versuchen.
{% endstep %}

{% step %}

#### **Richtlinien für soziale Medien prüfen**

Einige Social-Media-Apps wie Facebook blockieren Universal Links. Falls dies der Fall ist, kann die Verwendung eines **Mobile App Interstitial** hilfreich sein, und wir empfehlen, sich hierfür an Ihren CSM zu wenden (oder [wende dich an den Support](https://app.impact.com/support/portal.ihtml?createTicket=true)). impact.com arbeitet aktiv an Möglichkeiten, Deep-Linking und Attribution aus Social-Media-Apps zu verbessern.
{% endstep %}
{% endstepper %}

#### Weitere Erläuterungen von Apple

Wenn Sie ein [SFSafariViewController](https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller) , [WKWebView](https://developer.apple.com/documentation/webkit/wkwebview) oder [UIWebView](https://developer.apple.com/documentation/uikit/uiwebview) Objekt instanziieren, um einen Universal Link zu verarbeiten, öffnet iOS Ihre Website in Safari statt Ihre App zu öffnen. Wenn der Nutzer jedoch innerhalb eines eingebetteten SFSafariViewController-, WKWebView- oder UIWebView-Objekts auf einen Universal Link tippt, öffnet iOS Ihre App.

Lesen Sie den [Support Universal Links](https://developer.apple.com/library/archive/documentation/General/Conceptual/AppSearch/UniversalLinks.html) Hilfsartikel von Apple für weitere Informationen.


---

# 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/de/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.
