Adjust integrieren

Begriffserläuterung

Adjust

Mobile-Attribution- und Marketing-Analytics-Plattform. Mit Adjust können Anwendungsentwickler, Marketingfachleute und Marken die Effektivität ihrer Marketingkampagnen über verschiedene Kanäle und Geräte hinweg tracken, messen und optimieren.

Ausführliche Informationen zur Plattform finden Sie in der Adjust-Dokumentation.

App-Token

Anwendungs-ID, die für jede Plattform (Android, iOS usw.) eindeutig ist. Die ID wird automatisch generiert, wenn eine App bei Adjust hinzugefügt wird. Sie finden diesen Wert in Adjust unter AppView > All apps neben dem Namen der entsprechenden App.

Adjust-ID

Von Adjust generierte Benutzer-ID.

Lifetime Value (LTV)

Durchschnittlicher Erlös, den ein Nutzer während der Nutzung Ihrer App generiert. Ausführliche Informationen zum LTV finden Sie in der Adjust-Dokumentation.

Return on Advertising Spend (ROAS)

Kennzahl, die die Effektivität einer Werbekampagne misst, indem sie den generierten Umsatz pro Werbeausgaben-Einheit berechnet. Ausführliche Informationen zum ROAS finden Sie in der Adjust-Dokumentation.

In-App-Ereignis

Nutzeraktion innerhalb der App. Ausführliche Informationen zu In-App-Ereignissen finden Sie in der Adjust-Dokumentation. Nutzeraktionen im Web Shop werden bei einer S2S-Integration ebenfalls als In-App-Ereignisse betrachtet und vom Xsolla-Backend an Adjust gesendet.

Nutzergewinnung

Der Prozess, neue Nutzer durch Marketingaktivitäten für eine Website, einen Dienst, eine Plattform oder eine App zu gewinnen.

Customer User ID (CUID)

Benutzer-ID, die vom App-Inhaber bei der Registrierung des Nutzers generiert und festgelegt wird. Die СUID muss für den Web Shop und für Adjust identisch sein. Dieser Parameter wird für die Nutzerzuordnung und ‑attribution verwendet.

Achtung

Sie müssen die CUID als Partnerparameter xsolla_cuid gemäß der Anleitung übermitteln.

Wenn die CUIDs im Web Shop und in Ihrer App nicht übereinstimmen, wenden Sie sich bitte an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, um den Webhook Benutzervalidierung im Web Shop oder die Authentifizierung über einen Deep Link zu implementieren.

Rückruf

Prozess, bei dem Daten zu In-App-Ereignissen empfangen werden. Ausführliche Informationen finden Sie in der Adjust-Dokumentation.

Server-zu-Server-/S2S-Sicherheitstoken

Token, der dazu dient, S2S-Aufrufe zum Senden von Ereignisdaten an Adjust zu autorisieren. Der Token wird bei Adjust generiert. Ausführliche Informationen zum S2S-Token finden Sie in der Adjust-Dokumentation.

Integrationsszenario

Adjust 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 messen. Xsolla sendet Informationen über im Web Shop getätigte Käufe als In-App-Ereignisse an Adjust, und Adjust 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
• Adjust verwenden
• die Lösung Web Shop zum Verkauf von Ingame-Items verwenden

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

So funktioniert's

Die Integration ermöglicht einen bidirektionalen Datenfluss zwischen Xsolla und Adjust. 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 Adjust
    User->>Mobile App: 1. Logs in
    Mobile App->>Adjust: 2. Sends CUID
    Adjust-->>Xsolla Backend: 3. Sends callback
    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->>Adjust: 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 Adjust, beispielsweise login, signup oder ein anderes Ereignis, das die CUID enthält.
3. Adjust sendet einen Rückruf an Xsolla – darin enthalten sind der App-Token, die Adjust-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 Adjust empfangenen Daten abgeglichen.
7. Xsollas Server sendet ein S2S-In-App-Ereignis an Adjust – darin enthalten sind die Adjust-ID, der App-Token und andere von Adjust empfangene Parameter.

Adjust 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 Adjust.

3. Klicken Sie bei S2S-Integration von Mobile Apps auf Konfigurieren.
4. Daraufhin öffnet sich ein Fenster, dort müssen Sie bei Diese Integration aktivieren ein Häkchen setzen.
5. Geben Sie die folgenden Daten ein:
   • Adjust-S2S-Sicherheitstoken
   • App-Token für Publishing-Plattformen (Android/iOS). Klicken Sie auf App-Token hinzufügen, um eine Plattform hinzuzufügen.
6. Klicken Sie auf Speichern.
7. Aktivieren Sie die Integration in Adjust.

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 Adjust.
2. Daraufhin öffnet sich ein Fenster, nehmen Sie darin die erforderlichen Änderungen vor.
3. Klicken Sie auf Speichern.

Einrichtung in Adjust

In Adjust müssen Sie:

1. die Übermittlung von CUID als Partnerparameter konfigurieren..
2. einen S2S-Sicherheitstoken abrufen.
3. die Integration in Xsolla aktivieren.

CUID als Partnerparameter übermitteln

Konfigurieren Sie die CUID-Übermittlung selbst, wie in der Anleitung beschrieben. Rufen Sie dazu die Methode addGlobalPartnerParameter auf, und übermitteln Sie die folgenden Daten:

• Benutzer-ID in Ihrem System
• forKey: “xsolla_cuid”

Beispiel:

1Adjust.addGlobalPartnerParameter("abcd123", forKey: "xsolla_cuid")

1[Adjust addGlobalPartnerParameter:@"abcd123" forKey:@"xsolla_cuid"];

S2S-Sicherheitstoken abrufen

So rufen Sie einen S2S-Sicherheitstoken ab:

1. Melden Sie sich bei Ihrem Adjust-Konto an.
2. Navigieren Sie zum Menüpunkt AppView > All apps, und wechseln Sie zu Ihrer Anwendungsseite.
3. Wechseln Sie zur Registerkarte Protection.
4. Klicken Sie im Block S2S security auf Open S2S security.
5. Klicken Sie in der Zeile mit dem gewünschten S2S-Token auf das Kopieren-Symbol.

Wenn Sie noch keinen S2S-Token haben, erstellen Sie bitte einen, indem Sie der Anleitung folgen.

Xsoll-Integration aktivieren

1. Melden Sie sich bei Ihrem Adjust-Konto an.
2. Navigieren Sie zum Menüpunkt Campaign Lab > Partners.
3. Klicken Sie auf New partner.

4. Geben Sie in der Suchleiste Xsolla ein, und wählen Sie den Eintrag aus.
5. Klicken Sie auf Next.

6. Wählen Sie eine App aus, für die Sie die Integration konfigurieren möchten.
7. Klicken Sie auf Next.
8. Aktivieren Sie die Datenfreigabe. Klicken Sie dazu im Block Enable data sharing auf Edit, aktivieren Sie dann den Schalter, und klicken Sie auf Enable.

9. Konfigurieren Sie die Ereigniszuordnung:

1. 1. Klicken Sie im Block Map your events auf Map event.

1. 2. Wählen Sie unter Adjust event die Option xsolla-billing-payment aus.
   3. Wählen Sie unter Partner event die Option Xsolla billing payment aus.
   4. Klicken Sie auf Apply.

10. Klicken Sie auf Next.
11. Überprüfen Sie die Einstellungen, und klicken Sie auf Enable partner. Bei Bedarf können Sie zu den vorherigen Schritten zurückkehren 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 Adjust. Die folgenden Kaufinformationen werden in den Ereignisparametern übermittelt:

Zusätzliche Daten

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