# AppsFlyer ESP 2.0 Integration

<Aside type="caution" icon="setting" title="Hilfe von Entwicklern erforderlich">
Sie benötigen Hilfe von Ihrem Entwicklungsteam, um die Integration einzurichten. Teilen Sie diese Anleitung mit ihnen.
</Aside>

[AppsFlyer](https://www.appsflyer.com/) ist eine Plattform für mobile Attribution und Marketinganalysen. [AppsFlyer ESP 2.0](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide) ist die Integration von AppsFlyer für E-Mail-Dienstanbieter (ESPs). Verbinden Sie Pushwoosh mit ESP 2.0, um das Link-Tracking in E-Mail-Kampagnen zu ermöglichen. Bei dieser Integration umschließt Pushwoosh URLs, und die ESP 2.0-Lösung sorgt dafür, dass das Deep-Linking für iOS Universal Links und Android App Links auch dann funktioniert, wenn Links zum Tracking umschlossen werden.

Diese Integration sendet auch Daten zu Link-Klicks an AppsFlyer, was Ihnen volle Transparenz über die Leistung Ihrer E-Mails neben Ihren anderen Marketingkanälen gibt und es Ihnen ermöglicht, den tatsächlichen Einfluss von E-Mails auf die Benutzerakquise und das Engagement zu messen.

## Integrationsübersicht


### Voraussetzungen

* Pushwoosh-Anwendung mit [konfiguriertem E-Mail-Versand](/de/product/first-steps/start-with-your-project/configure-platforms/email-verification/)
* AppsFlyer-Konto mit der [AppsFlyer ESP 2.0 Integration](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide). Dies ist eine Premium-Funktion. Wenden Sie sich an Ihren AppsFlyer CSM oder den AppsFlyer-Support, um Zugriff zu erhalten.



### Synchronisierte Entitäten

Klicks auf E-Mail-Links über Ihre Click-Tracking-Domain werden als Klickstatistiken in Pushwoosh und als Klick-Events mit Attributionsdaten in AppsFlyer erfasst.

### Anwendungsfälle

* **E-Mail-Klick-Tracking:** Messen Sie E-Mail-Link-Klicks über AppsFlyer.
* **Deep-Linking aus E-Mails:** Stellen Sie sicher, dass Universal Links (iOS) und App Links (Android) auch bei umschlossenen Links in E-Mails funktionieren.

### Wie die Integration funktioniert


Sobald die Integration live ist, durchläuft jeder Klick drei Schritte:

1. Pushwoosh ersetzt Links in Ihren E-Mails durch Tracking-URLs auf Ihrer CTD, zum Beispiel:
   `https://clickpush.yourdomain.com/json/1.3/emailRedirect?d=...`

2. Wenn ein Benutzer auf den Link tippt, geht die Anfrage über den konfigurierten CNAME an AppsFlyer. AppsFlyer erfasst die Attribution, kümmert sich um das Deep-Linking und leitet den Benutzer zur endgültigen URL oder über einen Universal Link / App Link in die App weiter. Es sendet auch eine GET-Anfrage an Pushwoosh und übergibt Ihre CTD im Host-Header, damit Pushwoosh den Klick erfassen kann:
```
   GET https://<Pushwoosh CNAME target>/json/1.3/emailRedirect
   Host: <your CTD>
```

3. Pushwoosh empfängt die Anfrage und erfasst den Klick für die eigene Statistik.

## Einrichtung der Integration

<Aside type="note" title="Pushwoosh vs. AppsFlyer">
Pushwoosh ist nur an der anfänglichen Einrichtung der CTD beteiligt. Der Rest der Integration wird auf Seiten von AppsFlyer abgeschlossen.
</Aside>

### Schritt 1. Eine Click-Tracking-Domain erstellen und aktivieren

Die **Click-Tracking-Domain (CTD)** ist der Domain-Teil einer getrackten Link-URL, die in einer E-Mail-Nachricht angezeigt wird. Sie kombiniert eine Subdomain mit Ihrer Hauptdomain, zum Beispiel `clickpush.esp-integrations1.com`. Die Subdomain wird in den DNS-Einstellungen Ihrer Domain bei Ihrem Domain-Anbieter erstellt, normalerweise durch Hinzufügen eines CNAME-Eintrags.
<Aside type="caution" title="Neue CTD erforderlich">
Das Erstellen einer neuen CTD ist für die AppsFlyer ESP 2.0 Integration zwingend erforderlich, auch wenn Sie bereits eine bestehende Click-Tracking-Domain verwenden. Die Verwendung einer neuen Domain vermeidet Auswirkungen auf den Traffic Ihrer aktuellen E-Mail-Kampagnen.

Weitere Details finden Sie in der Anleitung von AppsFlyer: [Richten Sie Ihre ESP-Integration mit AppsFlyer ein](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer#step-1-create-a-onelink-template-for-your-email-campaign).
</Aside>

1. Entscheiden Sie, welche Subdomain Sie als Ihre CTD verwenden werden (zum Beispiel `clickpush.esp-integrations1.com`).
2. Öffnen Sie in Pushwoosh die **Einstellungen** und wählen Sie dann **Plattformen konfigurieren**.
3. Scrollen Sie auf der Seite **E-Mail-Kanal-Konfiguration** zu **Benutzerdefinierte Tracking-Domain** und wählen Sie **Aktivieren**.

<Aside type="note" >
Der Abschnitt **Benutzerdefinierte Tracking-Domain** wird nur angezeigt, nachdem der E-Mail-Kanal für Ihre Anwendung konfiguriert wurde. Wenn Sie ihn nicht sehen, schließen Sie zuerst die [E-Mail-Konfiguration](/de/product/first-steps/start-with-your-project/configure-platforms/email-verification/) ab.
</Aside>

<img src="/integrations-appsflyer-esp2-email-integration-2.webp" alt="Pushwoosh Control Panel: Einstellungen, Plattformen konfigurieren, E-Mail-Kanal-Konfiguration, Benutzerdefinierte Tracking-Domain mit Aktivieren."/>

4. Geben Sie Ihre CTD in das Feld **Domain** ein und wählen Sie **Weiter**.

<img src="/integrations-appsflyer-esp2-email-integration-3.webp" alt="Dialogfeld 'Benutzerdefinierte Tracking-Domain aktivieren': Feld 'Domain', Abbrechen und Weiter."/>

5. Öffnen Sie außerhalb von Pushwoosh den Dienst, bei dem Sie das öffentliche DNS für die Domain Ihrer CTD verwalten (normalerweise Ihr Domain-Registrar, ein DNS-Host oder Ihr Hosting-Konto). Fügen Sie in dessen DNS- oder Zonen-Editor für diese Domain den **CNAME** hinzu, den Pushwoosh in diesem Schritt anzeigt, damit Ihre CTD auf `api.pushwoosh.com` verweist.

<Aside type="note" title="DNS-Propagierung">
DNS-Änderungen werden normalerweise innerhalb von Minuten wirksam, können aber bis zu 48 Stunden dauern.
</Aside>

6. Wählen Sie in Pushwoosh **Überprüfen**.

<img src="/integrations-appsflyer-esp2-email-integration-4.webp" alt="Schritt für DNS der benutzerdefinierten Tracking-Domain: CNAME zu api.pushwoosh.com, Zurück, Überprüfen und Speichern."/>

7. Wenn die Überprüfung erfolgreich ist, wählen Sie **Speichern**.
8. Wenn Sie die **Domain** oder den DNS-Eintrag ändern müssen, wählen Sie **Zurück** und passen Sie die vorherigen Schritte an.

9. Nachdem Sie auf **Speichern** geklickt haben, erscheint Ihre CTD in der Liste **Benutzerdefinierte Tracking-Domain** in der **E-Mail-Kanal-Konfiguration**.

<img src="/integrations-appsflyer-esp2-email-integration-5.webp" alt="E-Mail-Kanal-Konfiguration: Abschnitt 'Benutzerdefinierte Tracking-Domain' zeigt die gespeicherte CTD in der Liste."/>

Um sie später zu deaktivieren, wählen Sie `...` neben Ihrer CTD und dann **Benutzerdefinierte Tracking-Domain deaktivieren**.

<Aside type="tip">
Bevor Sie fortfahren, senden Sie eine Test-E-Mail und bestätigen Sie, dass der Link Ihre CTD verwendet.

**Beispiel für einen getrackten Link**

`https://clickpush.example.com/json/1.3/emailRedirect?d=...`
</Aside>

### Schritt 2. Die Integration in AppsFlyer starten

Starten Sie in der [AppsFlyer-Plattform](https://hq1.appsflyer.com/) die ESP 2.0 Integration. Folgen Sie der [Anleitung von AppsFlyer zur Einrichtung Ihrer ESP-Integration](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer).

AppsFlyer wird die folgenden Details abfragen:

* **Click-Tracking-Domain:** Ihre CTD (zum Beispiel `clickpush.example.com`)
* **ESP-Endpunkt:** `api.pushwoosh.com` (das CNAME-Ziel, das in Pushwoosh angezeigt wird, wenn Sie die benutzerdefinierte Tracking-Domain aktivieren)

AppsFlyer wird die Konfiguration validieren. Lassen Sie den CNAME der CTD auf **`api.pushwoosh.com`** zeigen, bis die Validierung abgeschlossen ist.

### Schritt 3. CNAME auf AppsFlyer aktualisieren

Nachdem AppsFlyer die Einrichtung validiert hat, erhalten Sie eine Routing-Domain (zum Beispiel `jyvls.espclicks.appsflyer.com`).

Aktualisieren Sie Ihren CNAME, sodass die CTD auf AppsFlyer anstatt auf Pushwoosh verweist:

**Vorher:**

`clickpush.example.com` → `api.pushwoosh.com`

**Nachher:**

`clickpush.example.com` → `jyvls.espclicks.appsflyer.com` (verwenden Sie die von AppsFlyer bereitgestellte Domain)

<Aside type="note" title="Propagierungszeit">
Nachdem Sie den CNAME aktualisiert haben, kann es bis zu 24 Stunden dauern, bis die Integration funktioniert.
</Aside> 

Senden Sie nach dem Wechsel des CNAME eine Test-E-Mail und überprüfen Sie, ob die Links korrekt geöffnet werden und die Klicks in AppsFlyer erscheinen.

## Was als Nächstes geschieht

Sobald die Änderung wirksam wird, läuft der Klick-Traffic über die Infrastruktur von AppsFlyer. AppsFlyer stellt die Routing-Schicht, SSL, AASA (Apple App Site Association) und Android App Links bereit.

Pushwoosh umschließt weiterhin Links und erfasst Klickstatistiken. In Pushwoosh ist keine weitere Konfiguration erforderlich.

Um mehr über die Einrichtung und das Testen auf Seiten von AppsFlyer zu erfahren, siehe:

<LinkCard title="Richten Sie Ihre ESP-Integration mit AppsFlyer ein" href="https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer#step-5-test-the-link" />

<LinkCard title="Integrationsanleitung für E-Mail-Dienstanbieter" href="https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide" />