# AppsFlyer-Integration

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

## Integrationsübersicht

[AppsFlyer](https://www.appsflyer.com/) 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:

<img src="/integrations-appsflyer-integration-1.webp" alt="Benutzersegmente basierend auf den Attributen der Nachrichtenkategorie"/>

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

<img src="/integrations-appsflyer-integration-2.webp" alt="Gezielte Kampagnen für Benutzer, die an bestimmten Nachrichtenkategorien 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](/de/developer/guides/personalization/dynamic-content/#personalizing-messages-sent-via-api-with-dynamic-content) mit dem Attribut _item_ hinzu:

<img src="/integrations-appsflyer-integration-3.webp" alt="Dynamic Content-Platzhalter in einem Pushwoosh Push-Preset"/>

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:

<img src="/integrations-appsflyer-integration-4.webp" alt="Vorschau der Push-Benachrichtigung für das iPhone 14 Pro Max-Angebot" width="375"/>

## Einrichtung der Integration

<Aside type="note">
Der Integrationsprozess ist für Android- und iOS-Plattformen identisch.
</Aside>

1.  Integrieren Sie das Pushwoosh SDK in Ihre App, falls Sie dies noch nicht getan haben. Für detailliertere Anweisungen [lesen Sie die Anleitung](/de/developer/pushwoosh-sdk/pushwoosh-sdk-overview).

<Aside type="caution">
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.
</Aside>

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.

<Tabs>
<TabItem label="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);
```
</TabItem>

<TabItem label="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];
```
</TabItem>
</Tabs>

<Aside type="danger">
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.
</Aside>

3.  Konfigurieren Sie die Pushwoosh-Integration in AppsFlyer. Gehen Sie dazu in Ihrem [AppsFlyer-Konto](https://hq1.appsflyer.com/auth/login) zu **Collaborate** > **Partner Marketplace**. Suchen und wählen Sie in der Partnerliste Pushwoosh aus.

<img src="/integrations-appsflyer-integration-5.webp" alt="Pushwoosh in AppsFlyer finden"/>

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

<img src="/integrations-appsflyer-integration-6.webp" alt="Aktivieren des Schalters „Partner aktivieren“ in AppsFlyer"/>

<Aside type="note">
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.
</Aside>

<img src="/integrations-appsflyer-integration-7.webp" alt="Deaktivieren des erweiterten Datenschutzmodus in AppsFlyer"/>

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](/de/developer/api-reference/api-access-token).
*   **Application Code** (XXXXX-XXXXX), den Sie unter Ihrem Anwendungsnamen in Ihrem Pushwoosh-Konto finden.

<img src="/integrations-appsflyer-integration-8.webp" alt="Hinzufügen von Pushwoosh-Anmeldeinformationen in den allgemeinen Einstellungen von AppsFlyer"/>

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

<img src="/integrations-appsflyer-integration-9.webp" alt="Konfigurieren des Abschnitts „Standard-Postback“"/>

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

<img src="/integrations-appsflyer-integration-10.webp" alt="Abschnitt für In-App-Event-Einstellungen mit Application Code und API-Token"/>

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.

<img src="/integrations-appsflyer-integration-11.webp" alt="Konfiguration des Schalters für In-App-Event-Postbacks in AppsFlyer"/>

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**                   | <p>Wählen Sie, wie Event-Daten mit Pushwoosh geteilt werden:</p><ul><li><strong>No values & no revenue:</strong> Senden Sie nur das Event selbst ohne Parameter (Werte oder Umsatz).</li><li><strong>Values & no revenue:</strong> Senden Sie alle Parameter außer dem Umsatzwert.</li><li><strong>Values & revenue:</strong> Senden Sie alle Event-Parameter, einschließlich des Umsatzwertes (falls er im Event vorhanden ist).<br/>Um Events mit zusätzlichen Attributen zu erhalten, die an Pushwoosh gesendet werden, wählen Sie „Values and Revenue“.</li></ul> |

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

<Aside type="note">
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.
</Aside>

## 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](/de/product/integrations/appsflyer-esp2-email-integration) einrichten.