Airbridge integrieren

Begriffserläuterung

Integrationsszenario

Airbridge und Xsolla unterstützen die S2S-Integration für Apps. Dadurch ist es möglich, den LTV und den ROAS für in der App und im Web Shop getätigte Käufe zu tracken. Xsolla sendet Informationen über im Web Shop getätigte Käufe als In-App-Ereignisse an Airbridge, und Airbridge ordnet diese dann der Anzahl der App-Installationen, der Nutzergewinnungs- und der Reengagement-Kampagne zu.

Sie können die App-Integration so konfigurieren, dass Sie erweiterte Ereignisanalysen erhalten, sofern Sie:

• über eine Android-/iOS-App verfügen
• Airbridge verwenden
• die Lösung Web Shop zum Verkauf von Ingame-Items verwenden

Das folgende Ereignis ist über die Xsolla- und Airbridge-S2S-Integration verfügbar:

So funktioniert's

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

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Airbridge
    User->>Mobile App: 1. Logs in
    Mobile App->>Airbridge: 2. Sends CUID
    Airbridge-->>Xsolla Backend: 3. Sends postback
    User->>Web Shop: 4. Logs in using CUID
    User->>Web Shop: 5. Makes a purchase
    Web Shop->>Xsolla Backend: 6. Sends purchase event
    Xsolla Backend->>Airbridge: 7. Sends xsolla-billing-payment event

1. Der Nutzer (Spieler) registriert sich bei der App oder meldet sich an.
2. Ihre App sendet ein In-App-Ereignis an Airbridge, beispielsweise login, signup oder ein anderes Ereignis, das die CUID enthält.
3. Airbridge sendet einen Postback an Xsolla – darin enthalten sind die Application Store ID, die Airbridge ID, die CUID und andere zugehörige Datenparameter.
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 den Xsolla-Server gesendet und mit den von Airbridge empfangenen Daten abgeglichen.
7. Xsollas Server sendet ein S2S-In-App-Ereignis an Airbridge – darin enthalten sind die Airbridge ID, die Application Store ID und andere von Airbridge empfangene Parameter.

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

Einrichtung im Kundenportal

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Integrationen.
2. Klicken Sie auf Airbridge.

3. Klicken Sie bei S2S-Integration von Mobile Apps auf Konfigurieren.

4. Daraufhin öffnet sich ein Fenster. Aktivieren Sie darin das Kontrollkästchen Diese Integration aktivieren.
5. Geben Sie die folgenden Daten ein:
   • Airbridge-S2S-Token
   • Application Store ID für die Publishing-Plattform (Android/iOS). Klicken Sie auf Anwendungs-ID hinzufügen, um eine Plattform hinzuzufügen.

1. Kopieren Sie die Werte für diese Parameter wie unten beschrieben aus Ihrem Airbridge-Konto.

6. Klicken Sie auf Speichern.
7. Aktivieren Sie die Integration in Airbridge.

Sobald Sie die Einstellungen gespeichert haben, wird im S2S-Integrationsfenster ein grüner Punkt angezeigt.

So nehmen Sie Änderungen an der verknüpften Integration vor:

1. Klicken Sie auf Airbridge.
2. Daraufhin öffnet sich ein Fenster, nehmen Sie darin die erforderlichen Änderungen vor.
3. Klicken Sie auf Speichern.

Einrichtung in Airbridge

In Airbridge müssen Sie:

1. sich die Anmeldedaten besorgen,
2. die Integration für Xsolla aktivieren.

Anmeldedaten besorgen

1. Melden Sie sich bei Ihrem Airbridge-Konto an.
2. Navigieren Sie zu Integration > Third-party integration.
3. Klicken Sie auf Xsolla.

4. Kopieren Sie im Abschnitt Set up Xsolla dashboard die Werte für Application store ID und Airbridge S2S token, und fügen Sie diese im Kundenportal ein.

Xsoll-Integration aktivieren

Gehen Sie wie folgt vor, nachdem Sie die Integration im Kundenportal aktiviert haben:

1. Melden Sie sich bei Ihrem Airbridge-Konto an.
2. Navigieren Sie zu Integration > Third-party integration.
3. Klicken Sie auf Xsolla.
4. Aktivieren Sie den Schalter Send events.

Hinweis

Um Daten von iOS-Nutzern zu teilen, die App Tracking Transparency (ATT) ablehnen, müssen Sie den Schalter EPC (Extended Privacy Control) deaktivieren. Sollte der Schalter nicht auswählbar sein, müssen Sie zum Menüpunkt Settings > App settings navigieren und die Einstellungen aktualisieren.

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 Integrationsoptionen für Ihre Anforderungen nicht ausreichen.

Artikelkauf

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

Zusätzliche Daten

Darüber hinaus können Sie die folgenden Parameter im Postback übermitteln: