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"
}