AppsFlyer-Integration

Unterstützung durch Entwickler erforderlich

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 bei der Analyse der Nutzerakquise und des Engagements hilft. Sie liefert umfassende Daten zum 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 Werte des Acquisition Source Tags.

Anwendungsfälle

Mit diesen Daten können Sie Nutzersegmente erstellen und präzise zielgerichtete und personalisierte Kampagnen in Pushwoosh durchführen. Nachfolgend finden Sie zwei Beispiele für die Nutzung von AppsFlyer-Daten zur Erstellung effektiver Customer Journeys in Pushwoosh.

1. Erstellen Sie hochgradig zielgerichtete Kampagnen in Pushwoosh unter Verwendung von durch AppsFlyer getrackten Events.

Angenommen, Sie haben eine Nachrichten-App. Sie haben AppsFlyer so konfiguriert, dass das Event SubscribedToNews getrackt 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: politics, business oder sports.

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 ausgerichtet sind, 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. Angenommen, AppsFlyer trackt das Event AddToWishlist, 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 Daten des AddToWishlist Events an Pushwoosh, wo Sie Nachrichten je nach der Wahl des Nutzers personalisieren können. Sie können zum Beispiel eine Push-Voreinstellung erstellen, die einen Rabatt auf einen Artikel anbietet, den ein Nutzer zu seiner Wunschliste hinzugefügt hat. Anstelle des Artikelnamens fügen Sie einen Platzhalter für dynamische Inhalte 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 zur Identifizierung und Zielgruppenansprache von Nutzern verwenden, 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 Nutzern 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 für die Einrichtung der Integration weitergeleitet. Aktivieren Sie dort den Schalter Activate partner.

Hinweis

Für iOS-Apps ist der Advanced Privacy Mode standardmäßig aktiviert, der die Kontrolle über die Verfügbarkeit von Attributionsdaten auf Nutzerebene über die AppsFlyer-Plattform ermöglicht. Obwohl AppsFlyer diese Art von Daten nicht an Pushwoosh sendet, kann das Aktiviertlassen des Advanced Privacy-Schalters die Datenübertragung stören.

Um sicherzustellen, dass Pushwoosh alle Daten erhält, empfehlen wir, den Advanced Privacy Mode in den App Settings zu deaktivieren. Dadurch wird der Schutz der Nutzerdaten 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 den an Pushwoosh gesendeten Postbacks enthalten sein sollen.

Wählen Sie ein oder mehrere AppsFlyer-Events aus dem Dropdown-Menü aus, die an Pushwoosh gesendet werden sollen, und füllen Sie die erforderlichen Parameter aus.

Parameter	Beschreibung
the mapped to partner event	Obwohl dieses Feld obligatorisch ist, machen Sie sich keine Sorgen darüber, was Sie eingeben, da dies die Benennung der Events nicht ändert. Pushwoosh erhält die Events weiterhin mit denselben Namen, wie sie in AppsFlyer erscheinen.
for users from	Wählen Sie in diesem Feld aus, ob Postbacks ausschließlich für Nutzer 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 Umsatzwerts (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

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