AppsFlyer ESP 2.0 Integration

Hilfe von Entwicklern erforderlich

Sie benötigen Hilfe von Ihrem Entwicklungsteam, um die Integration einzurichten. Teilen Sie diese Anleitung mit ihnen.

AppsFlyer ist eine Plattform für mobile Attribution und Marketinganalysen. AppsFlyer ESP 2.0 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
• AppsFlyer-Konto mit der AppsFlyer ESP 2.0 Integration. 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

Pushwoosh vs. AppsFlyer

Pushwoosh ist nur an der anfänglichen Einrichtung der CTD beteiligt. Der Rest der Integration wird auf Seiten von AppsFlyer abgeschlossen.

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.

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.

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.

Hinweis

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 ab.

4. Geben Sie Ihre CTD in das Feld Domain ein und wählen Sie 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.

DNS-Propagierung

DNS-Änderungen werden normalerweise innerhalb von Minuten wirksam, können aber bis zu 48 Stunden dauern.

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

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.

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

Tipp

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=...

Schritt 2. Die Integration in AppsFlyer starten

Starten Sie in der AppsFlyer-Plattform die ESP 2.0 Integration. Folgen Sie der Anleitung von AppsFlyer zur Einrichtung Ihrer ESP-Integration.

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)

Propagierungszeit

Nachdem Sie den CNAME aktualisiert haben, kann es bis zu 24 Stunden dauern, bis die Integration funktioniert.

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:

Richten Sie Ihre ESP-Integration mit AppsFlyer ein

Integrationsanleitung für E-Mail-Dienstanbieter