Sie können das Web-SDK in AppsFlyer integrieren, um Advanced Analytics für Ereignisse zu erhalten, sofern Sie:

• die AppsFlyer Measurement Platform verwenden und People-Based Attribution für das Konto aktiviert haben
• Xsolla Site Builder verwenden

Die folgenden Ereignisse sind über die Web-SDK-Integration von Xsolla und AppsFlyer verfügbar:

So funktioniert's

Nachfolgend ist beispielhaft beschrieben, wie das System bei der Umsetzung einer Nutzergewinnungs- und Retargeting-Kampagne interagiert. Der Nutzer gelangt über ein Werbebanner zum Web Shop und kauft etwas. Die Ereignisse, die dabei an AppsFlyer gesendet werden, geben Aufschluss über Folgendes:

• wie viele Nutzer von welchem Banner kamen
• wie viel die Nutzer bezahlt haben
• ob die Retargeting-Kampagne effektiv war

1. Der Nutzer klickt auf das Werbekampagnenbanner.
2. Der Nutzer wird zum Web Shop weitergeleitet, und die URL dieser Weiterleitung enthält die AppsFlyer-Parametergruppe, die angibt, von welchem Banner und welcher Website der Nutzer weitergeleitet wurde.
3. Ein Ereignis über den Seitenaufruf/Besuch wird vom Web-Shop-Client an AppsFlyer gesendet.
4. Der Nutzer meldet sich mit der CUID im Web Shop an.
5. Das Autorisierungsereignis wird an AppsFlyer gesendet.
6. Der Nutzer kauft etwas im Web Shop.
7. Das Kaufereignis wird an AppsFlyer gesendet.

Einrichtung in AppsFlyer

Konfigurieren Sie zunächst die folgenden Einstellungen auf der AppsFlyer-Plattform:

1. Anwendung hinzufügen:
   1. Klicken Sie auf Add app.
   2. Wählen Sie in der Liste die Plattform Web (PBA) aus.
   3. Geben Sie als Anwendungs-URL die Domain Ihres Web Shops an, z. B.: https://www.webshop.example.com/.
   4. Vergeben Sie einen Anwendungsnamen, z. B.: Xsolla.
   5. Klicken Sie auf Add my app.

2. Bundle hinzufügen:
   1. Klicken Sie auf Add bundle.
   2. Geben Sie Xsolla-bundle als Namen an.
   3. Wählen Sie in der Liste der Webanwendungen die zuvor hinzugefügte Xsolla-App aus.
   4. Klicken Sie auf Create bundle.

Einrichtung im Kundenportal

1. Öffnen Sie Ihr Projekt im Publisher-Konto.
2. Rufen Sie den Seitenbaukasten über einen der folgenden Wege auf:
   • Klicken Sie im Seitenmenü auf Seitenbaukasten.
   • Klicken Sie in der Seitenleiste auf Integrationen. In dem sich öffnenden Abschnitt:
     1. Klicken Sie auf den Bereich AppsFlyer.
     2. Klicken Sie im Bereich Web SDK (Site Builder) auf Konfigurieren.

3. Wählen Sie Ihre Seite und klicken Sie Konfigurieren.
4. Auf dem Seiteneinstellungsreiter, gehen Sie zum Bereich Apps.
5. Im AppsFlyer-Bereich, klicken Sie Verbinden.

6. Geben Sie im Feld AppsFlyer Dev Key den Entwicklerschlüssel ein. Diesen finden Sie in Ihrem Konto bei AppsFlyer:
   1. Wechseln Sie zu My Apps.
   2. Klicken Sie auf View brand bundles.
   3. Klicken Sie in der Zeile mit dem Brand Bundle Xsolla-bundle auf das Kopieren-Symbol in der Spalte Web dev key.
7. Klicken Sie auf Verbinden.

So finden Sie Informationen zu Ereignissen in Ihrem Konto bei AppsFlyer:

1. Wechseln Sie zu My Apps.
2. Wählen Sie unter Available Apps die App Xsolla aus, und klicken Sie auf View in PBA.

Die Analytics-Ereignisse sind ebenfalls im Abschnitt Dashboards > People-Based Attribution einsehbar.

Die Mobile-Apps-Integration lässt sich so konfigurieren, dass Sie Advanced Analytics für Ereignisse erhalten, sofern Sie:

• eine Android-/iOS-App haben
• die AppsFlyer Measurement Platform nutzen
• Ingame-Items über den Web Shop verkaufen

Die folgenden Ereignisse sind über die S2S-Integration von Xsolla und AppsFlyer verfügbar:

So funktioniert's

Die Integration ermöglicht einen bidirektionalen Datenfluss zwischen Xsolla und AppsFlyer. Im Folgenden ist erläutert, wie das System interagiert, wenn ein Nutzer etwas kauft.

1. Der Nutzer (Spieler) registriert sich bei der Android-/iOS-App oder meldet sich an.
2. Ihre App sendet ein standardmäßiges In-App-Ereignis an AppsFlyer: af_login, af_signup oder ein beliebiges Ereignis, das die CUID enthält.
3. AppsFlyer sendet ein Postback mitsamt der Anwendungs-ID, der AppsFlyer-ID und der CUID an Xsolla.
4. Der Nutzer meldet sich mit der CUID im Web Shop an.
5. Der Nutzer kauft etwas im Web Shop.
6. Das Kaufereignis wird an das Xsolla-Backend gesendet und mit den von AppsFlyer erhaltenen Informationen abgeglichen.
7. Das Xsolla-Backend sendet ein S2S-In-App-Ereignis mitsamt der AppsFlyer-ID an AppsFlyer.

AppsFlyer weist dieses neue Ereignis, den Kauf und den Umsatz der Medienquelle zu, die für die Nutzerakquise bzw. das erneute Nutzer-Engagement verantwortlich war.

Einrichtung im Kundenportal

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Integrationen.
3. Klicken Sie den AppsFlyer-Bereich.

4. Im S2S-Integration von Mobile Apps, klicken Sie Konfigurieren.

5. Es öffnet sich ein Fenster, geben Sie darin die folgenden Daten ein:
   1. AppsFlyer-S2S-Token.
   2. Anwendungs-IDs auf den Veröffentlichungsplattformen (Android/iOS). Klicken Sie auf Anwendungs-ID hinzufügen, um eine Plattform hinzuzufügen.
6. Klicken Sie auf Speichern.

Nach dem Speichern wird der Schalter im AppsFlyer-Bereich aktiviert.
So nehmen Sie Änderungen an der verknüpften Integration vor:

1. Klicken Sie auf den AppsFlyer-Bereich.
2. Es öffnet sich ein Fenster, nehmen Sie darin die nötigen Änderungen vor.
3. Klicken Sie auf Speichern.

Einrichtung in AppsFlyer

In AppsFlyer müssen Sie:

1. einen S2S-Token abrufen,
2. die Integration für Xsolla aktivieren.

S2S-Token abrufen

So rufen Sie den S2S-Token ab:

1. Melden Sie sich bei Ihrem AppsFlyer HQ-Konto an.
2. Navigieren Sie zu Account > Security Center > AppsFlyer API and S2S tokens and S2S tokens.
3. Klicken Sie in der Zeile mit dem S2S-Token auf das Kopieren-Symbol in der Spalte Token.

Wenn Sie noch kein S2S-Token haben, erstellen Sie einen.

Integration für Xsolla aktivieren

1. Wählen Sie in Ihrem AppsFlyer HQ-Konto die gewünschte Android-/iOS-Anwendung aus, und navigieren Sie zu Collaborate > Partner marketplace.

2. Geben Sie in der Suchleiste die Bezeichnung Xsolla ein, und wählen Sie die Option aus.

3. Klicken Sie auf Set up integration.

4. Gehen Sie auf der Registerkarte "Integration" wie folgt vor:
   1. Aktivieren Sie den Schalter Activate Partner.
   2. Nur bei iOS-Anwendungen: Aktivieren oder deaktivieren Sie den Schalter Advanced Privacy gemäß Ihrer Datenschutzrichtlinie:
      • Aktiviert – alle Ereignisse werden an Xsolla gesendet
      • Deaktiviert – nur von ATT zugelassene Ereignisse werden an Xsolla gesendet

1. 3. Lassen Sie den Wert Default postbacks deaktiviert – off (voreingestellt).
   4. Deaktivieren Sie den Schalter In-app event postbacks.
   5. Konfigurieren Sie mindestens ein In-App-Ereignis, das Anmeldedaten (CUID) enthält.
   6. Geben Sie im Feld mapped to partner event einen beliebigen Wert ein. Xsolla unterstützt beliebige Ereignisnamen.
   7. Speichern Sie die Integration.

Weitere Informationen zu den Integrationseinstellungen aufseiten von AppsFlyer finden Sie in der Dokumentation.

Ereigniswert-Struktur

Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie ein bestimmtes Ereignis einrichten möchten oder die aktuellen Integrationsfunktionen für Ihre Anforderungen nicht ausreichen.

Artikelkauf

Wenn ein Nutzer etwas im Web Shop kauft, sendet Xsolla das Ereignis xsolla-billing-payment an AppsFlyer. Die folgenden Kaufinformationen werden in den Ereignisparametern übermittelt:

Beispielereignis mit einer einzelnen SKU:

{
    "af_content_id": "test-coin",
    "af_quantity": "11",
    "af_revenue": "99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

Beispielereignis mit mehreren SKU:

{
    "af_content_id": ["test-coin-1", "test-coin-2"],
    "af_quantity": ["5", "60"],
    "af_revenue": "99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}

Erstattung

Wenn ein Nutzer beantragt, eine Zahlung zu erstatten, sendet Xsolla das Ereignis xsolla-billing-refund an AppsFlyer. Die folgenden Erstattungsinformationen werden in den Ereignisparametern übermittelt:

Beispielereignis mit mehreren SKU:

{
    "af_content_id": ["test-coin-1", "test-coin-2"],
    "af_quantity": ["5", "60"],
    "af_revenue": "-99.99",
    "af_currency": "USD",
    "af_purchase_currency": "USD",
    "af_receipt_id": "1234567890"
}