AppsFlyer integrieren

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

  sequenceDiagram
    participant U as Nutzer
    participant WSP as Web-Shop-Werbekampagne (Werbebanner)
    participant WS as Web Shop
    participant AF as AppsFlyer
    U->>WSP: klickt auf Banner
    WSP->>WS: wird mittels URL-Parametern weitergeleitet
    WS->>AF: sendet Ladeereignis
    U->>WS: meldet sich per CUID an
    WS->>AF: sendet Identifizierungsereignis
    U->>WS: kauft etwas
    WS->>AF: sendet Kaufereignis

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.

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Rufen Sie Site Builder auf einen der folgenden Wege auf:
   • Klicken Sie in der Seitenleiste auf Storefronts > Websites.
   • Klicken Sie in der Seitenleiste auf Integrationen. Gehen Sie in dem Fenster wie folgt vor:
     1. Klicken Sie auf 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.

1. Öffnen Sie das Projekt in Ihrem Konto.
2. Rufen Sie Site Builder auf einen der folgenden Wege auf:
   • Klicken Sie in der Seitenleiste auf Storefronts > Websites.
   • Klicken Sie in der Seitenleiste auf Weitere Tools > Integrationen. Gehen Sie in dem Fenster wie folgt vor:
     1. Klicken Sie auf AppsFlyer.
     2. Klicken Sie bei 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.

1. Öffnen Sie das Projekt in Ihrem Konto.
2. Rufen Sie Site Builder auf einen der folgenden Wege auf:
   • Klicken Sie in der Seitenleiste auf Storefronts > Websites.
   • Klicken Sie in der Seitenleiste auf Weitere Tools > Integrationen. Gehen Sie in dem Fenster wie folgt vor:
     1. Klicken Sie auf AppsFlyer.
     2. Klicken Sie bei 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.

1. Öffnen Sie das Projekt in Ihrem Konto.
2. Rufen Sie Site Builder auf einen der folgenden Wege auf:
   • Klicken Sie in der Seitenleiste auf Storefronts > Websites.
   • Klicken Sie in der Seitenleiste auf Weitere Tools > Integrationen. Gehen Sie in dem Fenster wie folgt vor:
     1. Klicken Sie auf AppsFlyer.
     2. Klicken Sie bei 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.

1. Öffnen Sie Ihr Projekt im Konto für Handyspiele.
2. Rufen Sie den Site Builder auf einen der folgenden Wege auf:
   • Klicken Sie in der Seitenleiste auf Web Shop.
   • Klicken Sie in der Seitenleiste auf Betrieb > MMP. In dem sich öffnenden Abschnitt:
     1. Klicken Sie auf das AppsFlyer-Paneel.
     2. Klicken Sie im Web SDK (Site Builder)-Paneel auf Konfigurieren.

3. Klicken Sie bei der gewünschten Website auf das ⋮-Symbol und dann auf Konfigurieren.
4. Scrollen Sie auf der Registerkarte Seiteneinstellungen zum Bereich Apps.
5. Klicken Sie im AppsFlyer-Bereich auf 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.

  sequenceDiagram
    participant User
    participant App as Application
    participant Shop as Web Shop
    participant Backend as Xsolla Backend
    participant AF as AppsFlyer
    User->>App: 1. Logs in
    App->>AF: 2. Sends CUID
    AF-->>Backend: 3. Sends postback (Application ID, AppsFlyer ID, CUID)
    User->>Shop: 4. Logs in with CUID
    User->>Shop: 5. Makes purchase
    Shop->>Backend: 6. Sends purchase event
    Backend->>AF: 7. Sends xsolla-billing-payment event

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 und CUID 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.

2. Klicken Sie den AppsFlyer-Bereich.

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

4. Geben Sie im Fenster, das erscheint, folgende Daten ein:
   1. AppsFlyer S2S-Token.
   2. Anwendungs-ID für die Adroid/iOS Publishing-Plattformen im folgenden Format:
      • iOS:idXXXXXXXXX
      • Android:com.example.yourapp
      Um eine Plattform hinzuzufügen, klicken Sie Anwendungs-ID hinzufügen.
5. Klicken Sie 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.
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 [email protected], wenn Sie ein bestimmtes Ereignis einrichten möchten oder die aktuellen Integrationsfunktionen für Ihre Anforderungen nicht ausreichen.

Artikelkauf

Wenn ein Nutzer im Web Shop etwas kauft, sendet Xsolla das Ereignis xsolla-billing-payment an AppsFlyer.

Hauptparameter

Zusätzliche Parameter

Die folgenden Parameter werden weder in aggregierten Berichten noch auf Dashboards angezeigt und sind nur beim Exportieren von Rohdaten verfügbar:

Beispielereignis mit einer einzelnen SKU:

 1{
 2    "af_content_id" : "test-coin",
 3    "af_quantity" : "2",
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Beispielereignis mit mehreren SKU:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Erstattung

Wenn ein Nutzer eine Erstattung für eine Zahlung veranlasst, sendet Xsolla das Ereignis xsolla-billing-refund an AppsFlyer.

Hauptparameter

Zusätzliche Parameter

Die folgenden Parameter werden weder in aggregierten Berichten noch auf Dashboards angezeigt und sind nur beim Exportieren von Rohdaten verfügbar:

Beispielereignis mit mehreren SKU:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_revenue" : "-40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "af_net_revenue" : "-32.27",
 9    "payout_amount" : "404577.4",
10    "payout_currency" : "UZS",
11    "af_receipt_id" : "5555555550",
12    "af_store" : "xsolla",
13    "af_dry_run" : "0",
14    "date_payment" : "2026-08-27T01:50:58Z"
15}

Rechnungserstellung

Wenn im Xsolla-System eine Rechnung für einen Artikelkauf im Web Shop angelegt wird, sendet Xsolla das Ereignis xsolla-billing-created an AppFlyer.

Hauptparameter

Zusätzliche Parameter

Die folgenden Parameter werden weder in aggregierten Berichten noch auf Dashboards angezeigt und sind nur beim Exportieren von Rohdaten verfügbar:

Beispielereignis mit mehreren SKU:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}

Zahlungsfehler

Wenn ein Zahlungsfehler während eines Kaufs im Web Shop auftritt, sendet Xsolla das Ereignis xsolla-billing-error ab AppsFlyer. Die Ereignisparameter enthalten die folgenden Informationen:

Hauptparameter

Zusätzliche Parameter

Die folgenden Parameter werden weder in aggregierten Berichten noch auf Dashboards angezeigt und sind nur beim Exportieren von Rohdaten verfügbar:

Beispielereignis mit mehreren SKU:

 1{
 2    "af_content_id" : [ "test-coin", "test-coin3" ],
 3    "af_quantity" : [ "2", "3" ],
 4    "af_item_value" : "40.00",
 5    "af_currency" : "USD",
 6    "af_purchase_currency" : "UZS",
 7    "af_payment_amount" : "501470.75",
 8    "payout_amount" : "404577.4",
 9    "payout_currency" : "UZS",
10    "af_receipt_id" : "5555555550",
11    "af_store" : "xsolla",
12    "af_dry_run" : "0",
13    "date_payment" : "2026-08-27T01:50:58Z"
14}