AppsFlyer-Integration

Hilfe vom Entwicklungsteam benötigt

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

Integrationsübersicht

AppsFlyer ist eine Plattform für mobile Attribution und Marketinganalysen, die Ihnen hilft, die Nutzerakquise und das Engagement zu analysieren. Sie liefert umfassende Daten über das Nutzerverhalten innerhalb der App und ermöglicht es Ihnen, die Quellen der Nutzerakquise zu verfolgen. Mit den von AppsFlyer erhaltenen Informationen können Sie effektive Marketingkampagnen in Pushwoosh erstellen.

Sobald die Integration konfiguriert ist, sendet AppsFlyer die folgenden Informationen an Pushwoosh:

• Das In-App-Verhalten des Nutzers als Events und deren Attribute;
• Nutzerakquisequellen als die Acquisition Source Tag-Werte.

Anwendungsfälle

Mit diesen Daten können Sie Nutzersegmente erstellen und präzise zielgerichtete und personalisierte Kampagnen in Pushwoosh durchführen. Im Folgenden finden Sie zwei Beispiele, wie Sie AppsFlyer-Daten nutzen können, um effektive Customer Journeys in Pushwoosh zu erstellen.

1. Erstellen Sie hochgradig zielgerichtete Kampagnen in Pushwoosh unter Verwendung von Events, die von AppsFlyer verfolgt werden.

Nehmen wir an, Sie haben eine Nachrichten-App. Sie haben AppsFlyer so konfiguriert, dass das SubscribedToNews-Event verfolgt wird, das jedes Mal ausgelöst wird, wenn ein Nutzer einen Nachrichtenkanal abonniert. Dieses Event hat das Attribut „Kategorie“, das die Art der Nachrichten angibt, die der Nutzer abonniert: Politik, Wirtschaft oder Sport.

Pushwoosh empfängt die Informationen über dieses Event mit seinen Attributwerten. Sie können drei Nutzersegmente basierend auf drei möglichen Werten erstellen:

Jetzt können Sie Kampagnen erstellen, die auf Nutzer abzielen, die an einer bestimmten Art von Nachrichten interessiert sind:

2. Personalisieren Sie Nachrichten basierend auf Nutzerverhaltensdaten von AppsFlyer.

In diesem Beispiel verwenden wir eine Online-Shopping-App. Nehmen wir an, AppsFlyer verfolgt das AddToWishlist-Event, das immer dann ausgelöst wird, wenn ein Nutzer einen Artikel zu seiner Wunschliste hinzufügt. Dieses Event hat das Attribut „item“, das den Namen des zur Wunschliste hinzugefügten Artikels angibt.

AppsFlyer sendet die AddToWishlist-Eventdaten an Pushwoosh, wo Sie Nachrichten je nach Wahl der Nutzer personalisieren können. Sie können beispielsweise ein Push-Preset erstellen, das einen Rabatt auf einen Artikel anbietet, den ein Nutzer zu seiner Wunschliste hinzugefügt hat. Anstelle des Artikelnamens fügen Sie einen Dynamic Content-Platzhalter mit dem Attribut item hinzu:

Wenn ein Nutzer einen Artikel zu seiner Wunschliste hinzufügt, erhält er eine Push-Benachrichtigung mit Informationen darüber. Zum Beispiel sehen diejenigen, die das iPhone 14 Pro Max auswählen, diese Nachricht:

Einrichtung der Integration

Hinweis

Der Integrationsprozess ist für Android- und iOS-Plattformen identisch.

1. Integrieren Sie das Pushwoosh SDK in Ihre App, falls Sie dies noch nicht getan haben. Für detailliertere Anweisungen lesen Sie die Anleitung.

Vorsicht

Für den korrekten Betrieb sind die Pushwoosh iOS SDK Version 6.5.7 oder höher und die Pushwoosh Android SDK Version 6.6.16 oder höher erforderlich.

2. Um sicherzustellen, dass die korrekten Daten an AppsFlyer gesendet werden, integrieren Sie diesen Code-Schnipsel in Ihren Code. Stellen Sie sicher, dass er ausgeführt wird, nachdem sowohl das Pushwoosh SDK als auch das AppsFlyer SDK initialisiert wurden.

Java

String pwhwid = Pushwoosh.getInstance().getHwid();
String pwuserid = Pushwoosh.getInstance().getUserId();
Map<String, Object> customData = new HashMap<String, Object>();
customData.put("pushwoosh_hwid", pwhwid);
customData.put("pushwoosh_user_id", pwuserid);
AppsFlyerLib.getInstance().setAdditionalData(customData);

Objective-C

NSString *pwhwid = [[Pushwoosh sharedInstance] getHWID];
NSString *pwuserid = [[Pushwoosh sharedInstance] getUserId];
NSDictionary *customData = [[NSDictionary alloc] initWithObjectsAndKeys:pwuserid, @"pushwoosh_user_id", pwhwid, @"pushwoosh_hwid", nil];
[[AppsFlyerLib shared] setAdditionalData:customData];

Gefahr

Wenn Sie benutzerdefinierte Pushwoosh UserID-Werte verwenden, um Benutzer zu identifizieren und anzusprechen, stellen Sie sicher, dass Sie den Code nach dem Aufruf der Methode setUserId() im Pushwoosh SDK mit dem benutzerdefinierten Wert ausführen.

Verfolgen Sie, wann sich die Pushwoosh UserID gemäß der Logik in Ihrer mobilen Anwendung ändert, und senden Sie die aktualisierten Werte umgehend an AppsFlyer. Dies ist wichtig für die korrekte Zuordnung der mit den Benutzern gesendeten Daten in Ihrer Pushwoosh-Datenbank.

3. Konfigurieren Sie die Pushwoosh-Integration in AppsFlyer. Gehen Sie dazu in Ihrem AppsFlyer-Konto zu Collaborate > Partner Marketplace. Suchen und wählen Sie in der Partnerliste Pushwoosh aus.

4. Klicken Sie auf Set up integration. Sie werden dann zur Seite zur Einrichtung der Integration weitergeleitet. Aktivieren Sie dort den Schalter Activate partner.

Hinweis

Für iOS-Apps ist der erweiterte Datenschutzmodus standardmäßig aktiviert, der die Verfügbarkeit von Attributionsdaten auf Benutzerebene über die AppsFlyer-Plattform steuert. Obwohl AppsFlyer diese Art von Daten nicht an Pushwoosh sendet, kann die Aktivierung des Schalters für den erweiterten Datenschutz die Datenübertragung beeinträchtigen.

Um sicherzustellen, dass Pushwoosh alle Daten erhält, empfehlen wir, den erweiterten Datenschutzmodus in den App-Einstellungen zu deaktivieren. Dadurch wird der Schutz der Benutzerdaten nicht beeinträchtigt. Pushwoosh verpflichtet sich, Daten sicher und verantwortungsbewusst zu verwalten und branchenübliche Sicherheitsprotokolle zum Schutz der Vertraulichkeit einzusetzen.

5. Geben Sie im Abschnitt General settings Ihre Pushwoosh-Anmeldeinformationen ein:

• API Access Token. Um den Token zu erhalten, gehen Sie in Ihrem Pushwoosh-Konto zu Settings > API Access und kopieren Sie den Code. Mehr über den API Access Token erfahren Sie in dieser Anleitung.
• Application Code (XXXXX-XXXXX), den Sie unter Ihrem Anwendungsnamen in Ihrem Pushwoosh-Konto finden.

6. Wählen Sie im Abschnitt Default postback die Option All media sources, including organic.

7. Geben Sie im Abschnitt In-app event settings Ihren Pushwoosh Application Code und API Access Token ein.

8. Aktivieren Sie den Schalter In-app event postback und konfigurieren Sie die Events und Daten, die in die an Pushwoosh gesendeten Postbacks aufgenommen werden sollen.

Wählen Sie ein oder mehrere AppsFlyer-Events aus dem Dropdown-Menü aus, um sie an Pushwoosh zu senden, und vervollständigen Sie die erforderlichen Parameter.

Parameter	Beschreibung
the mapped to partner event	Obwohl dieses Feld obligatorisch ist, machen Sie sich keine Sorgen darüber, was Sie eingeben, da es die Benennung der Events nicht ändert. Pushwoosh erhält die Events weiterhin mit denselben Namen, wie sie in AppsFlyer erscheinen.
for users from	In diesem Feld wählen Sie aus, ob Postbacks ausschließlich für Benutzer gesendet werden, die diesem Partner zugeordnet sind, oder für alle Medienquellen, einschließlich organischer.
including	Wählen Sie, wie Event-Daten mit Pushwoosh geteilt werden: No values & no revenue: Senden Sie nur das Event selbst ohne Parameter (Werte oder Umsatz). Values & no revenue: Senden Sie alle Parameter außer dem Umsatzwert. Values & revenue: Senden Sie alle Event-Parameter, einschließlich des Umsatzwertes (falls er im Event vorhanden ist). Um Events mit zusätzlichen Attributen zu erhalten, die an Pushwoosh gesendet werden, wählen Sie „Values and Revenue“.

9. Sobald die Integration konfiguriert ist, klicken Sie auf Save.

Hinweis

Stellen Sie sicher, dass Sie die Integration testen, bevor Sie Ihre Kampagnen starten. Fehler treten oft während der Einrichtung auf, daher hilft ein schneller Test, die Verschwendung von Ressourcen für Kampagnen mit fehlenden oder falschen Daten zu vermeiden.

E-Mail-Klick-Tracking mit AppsFlyer ESP 2.0

Um das E-Mail-Klick-Tracking zu verwenden und Universal Links / App Links beim Senden von E-Mails über Pushwoosh beizubehalten, können Sie die AppsFlyer ESP 2.0 E-Mail-Integration einrichten.