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.

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.

Retargeting

Ansprache bestehender oder ehemaliger Nutzer durch Werbekampagnen. Bezieht sich auf die Strategie, Nutzer anzusprechen, die bereits mit Ihrer Anwendung oder Website interagiert haben. Ausführliche Informationen finden Sie in der Adjust-Dokumentation.

Web-Ereignis

Aktionen des Nutzers im Web Shop, die vom Web-Shop-Client an Adjust gesendet werden und für die Web-SDK-Integration erforderlich sind.

Integrationsszenarien

Adjust und Xsolla unterstützen die folgenden Integrationsarten:

Die S2S-Integration für Mobile Apps ermöglicht es, 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.
Die Web-SDK-Integration ermöglicht es, zu messen und zu bewerten, wie Nutzergewinnungs- und Retargeting-Kampagnen Traffic auf den Web Shop lenken. Die Integration des Web SDK ermöglicht es zu beurteilen, wie viele Nutzer über eine Retargeting-Kampagne auf die Website gelangt sind und wie die einzelnen Kanäle, die auf die Website weiterleiten, in puncto Konversionsrate abschneiden. Xsolla sendet Informationen über im Web Shop getätigte Käufe als Web-Ereignisse an Adjust, die Adjust der entsprechenden Medienquelle, Kampagne und Werbung zuordnet, die den Nutzer zum Kauf verleitet hat.

Sie können das Web-SDK in Adjust integrieren und so erweiterte Ereignisanalysen erhalten, sofern Sie:

Adjust verwenden
Ihre Website mit Xsolla Site Builder erstellt haben

Die folgenden Ereignisse sind in der Web-SDK-Integration verfügbar:

Ereignis	Beschreibung
`xsolla-web-event`	Website-Besuch-Ereignis, einschließlich URL-Parametern mit Ursprungsinformationen (also woher der Nutzer kommt) und einer Geräte-ID, die in einem Erstanbieter-Cookie gespeichert ist.
`xsolla-web-identify`	Anmeldeereignis, einschließlich der Geräte-ID und der CUID.
`xsolla-web-purchase`	Artikelkaufereignis, einschließlich Site-Builder-Ereignisse. Kann auch Transaktionsdetails umfassen.

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 Adjust gesendet werden, geben Aufschluss über Folgendes:

wie viele Nutzer auf das Banner geklickt haben und woher Sie kamen
wie viel die Nutzer bezahlt haben
ob die Retargeting-Kampagne effektiv war

  sequenceDiagram
    participant User
    participant Promo as Web Shop<br>promotional campaign<br>(ad banner)
    participant Shop as Web Shop
    participant Adjust as Adjust
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>Adjust: 3. xsolla-web-event event
    User->>Shop: 4. Logs in with CUID
    Shop->>Adjust: 5. xsolla-web-identify event
    User->>Shop: 6. Makes purchase
    Shop->>Adjust: 7. xsolla-web-purchase event

Ablauf für den Nutzer:

Der Nutzer klickt auf das Werbekampagnenbanner.
Der Nutzer wird zum Web Shop weitergeleitet. Die URL dieser Weiterleitung enthält die Parameter, die angeben, von welchem Banner und welcher Website der Nutzer weitergeleitet wurde.
Ein Ereignis über den Seitenaufruf/Besuch wird vom Web-Shop-Client an Adjust gesendet.
Der Nutzer meldet sich mit der CUID im Web Shop an.
Das Autorisierungsereignis wird an Adjust gesendet.
Der Nutzer kauft etwas im Web Shop.
Das Kaufereignis wird an Adjust gesendet.

Einrichtung in Adjust

In Adjust müssen Sie:

Ereignisse erstellen, die Sie in den Adjust-Analytics-Bericht aufnehmen möchten.
die Xsolla-Integration aktivieren.

Ereignisse erstellen

Sie benötigen eine der folgenden Rollen im Adjust-Konto, um Ereignisse anzuzeigen und zu verwalten:

Admin
Editor
Custom Editor

Melden Sie sich bei Ihrem Adjust-Konto an.
Navigieren Sie zum Menüpunkt AppView > All apps.
Klicken Sie auf den Namen der gewünschten Anwendung.

Klicken Sie auf der Registerkarte Events auf Add event.

Fügen Sie die folgenden Ereignisse nacheinander hinzu:
- Ein Ereignis, um allgemeine Informationen über den Website-Besuch zu erhalten, z. B.: xsolla-web-event.
- Ein Ereignis, um Informationen zur Benutzerauthentifizierung zu erhalten, z. B.: xsolla-web-identify.
- Ein Ereignis, um Informationen über einen Kauf zu erhalten, z. B.: xsolla-web-purchase.

Sie können die Ereignisse benennen und Regeln entsprechend Ihren Anforderungen festlegen. Sobald die Ereignisse hinzugefügt wurden, werden sie in der Liste auf der Registerkarte Events angezeigt.

Xsoll-Integration aktivieren

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

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

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

Konfigurieren Sie die Ereigniszuordnung:

1. Klicken Sie im Block Map your events auf Map event.
2. Ordnen Sie das Ereignis gemäß der Tabelle zu:

Adjust event	Partner event
Ereignis, das Sie erstellt haben, um allgemeine Informationen über den Website-Besuch zu erhalten.	Xsolla Web Events
Ereignis, das Sie erstellt haben, um Informationen zur Benutzerauthentifizierung erhalten.	Xsolla Web Identify
Ereignis, das Sie erstellt haben, um Informationen über einen Kauf zu erhalten.	Xsolla Web Purchase

1. Klicken Sie auf Apply.

Klicken Sie auf Next.
Ü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.

Einrichtung im Kundenportal

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

Klicken Sie bei Web SDK (Site Builder) auf Konfigurieren. Daraufhin werden Sie zur Website-Liste weitergeleitet.

Unter Storefronts > Websites gelangen Sie ebenfalls zu dieser Liste.

Klicken Sie bei der gewünschten Website auf Konfigurieren.

Scrollen Sie auf der Registerkarte Seiteneinstellungen zum Abschnitt Apps.
Klicken Sie bei Adjust Web SDK auf Verbinden.

Daraufhin öffnet sich ein Modalfenster, geben Sie dort den App-Token ein.
Klicken Sie auf Verbinden.

In Ihrem Adjust-Konto unter Datascape > Reports > All reports finden Sie Informationen zu Ereignissen. Ausführliche Informationen zur Arbeit mit Berichten finden Sie in der Adjust-Dokumentation.

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:

Ereignis	Beschreibung
xsolla-billing-payment	Artikelkauf. Die Ereignisparameter enthalten Informationen zu einem Kauf.

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

Der Nutzer (Spieler) registriert sich bei der App oder meldet sich an.
Ihre App sendet ein In-App-Ereignis an Adjust, beispielsweise login, signup oder ein anderes Ereignis, das die CUID enthält.
Adjust sendet einen Rückruf an Xsolla – darin enthalten sind der App-Token, die Adjust-ID, die CUID und andere zugehörige Datenparameter.
Der Nutzer meldet sich mit der CUID im Web Shop an.
Der Nutzer kauft etwas im Web Shop.
Das Kaufereignis wird an den Xsolla-Server gesendet und mit den von Adjust empfangenen Daten abgeglichen.
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

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

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

Daraufhin öffnet sich ein Fenster, dort müssen Sie bei Diese Integration aktivieren ein Häkchen setzen.
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.
Klicken Sie auf Speichern.
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:

Klicken Sie auf Adjust.
Daraufhin öffnet sich ein Fenster, nehmen Sie darin die erforderlichen Änderungen vor.
Klicken Sie auf Speichern.

Einrichtung in Adjust

In Adjust müssen Sie:

die Übermittlung von CUID als Partnerparameter konfigurieren..
einen S2S-Sicherheitstoken abrufen.
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:

Copy

Full screen

Small screen

swift

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

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

S2S-Sicherheitstoken abrufen

Sie benötigen eine der folgenden Rollen im Adjust-Konto, um S2S-Sicherheitstoken anzuzeigen und zu verwalten:

Admin
Editor
Custom Editor

So rufen Sie einen S2S-Sicherheitstoken ab:

Melden Sie sich bei Ihrem Adjust-Konto an.
Navigieren Sie zum Menüpunkt AppView > All apps, und wechseln Sie zu Ihrer Anwendungsseite.
Wechseln Sie zur Registerkarte Protection.
Klicken Sie im Block S2S security auf Open S2S security.
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

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

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

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

Konfigurieren Sie die Ereigniszuordnung:

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

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

Um ein weiteres Adjust-Ereignis mit Xsolla billing payment zu verknüpfen, müssen Sie zunächst das Ereignis gemäß den Anleitung erstellen.

Klicken Sie auf Next.
Ü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:

Parameter	Beschreibung
content_id	Einzelne SKU oder mehrere SKU aus dem Kauf.
quantity	Menge des Artikels mit der entsprechenden SKU (eine oder mehrere).
revenue	Kaufbetrag inklusive aller Rabatte, aber ohne Provisionen und Steuern.
currency	Kaufwährung.

Zusätzliche Daten

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

Parameter	Beschreibung
os_name	Gerätebetriebssystem.
adid	Geräte-ID bei Adjust (alle Plattformen).
idfa	Werbe-ID im App Store.
idfv	Lieferanten-ID bei Apple.
gps_adid	Werbe-ID bei Google Play.
app_token	App-Token bei Adjust.
{partner_parameters}	Sonstige benutzerdefinierte Parameter, über die Sie Informationen erhalten möchten.

Vielen Dank für Ihr Feedback!

Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.

Letztmalig aktualisiert: 28. Januar 2026

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Inhaltsverzeichnis

Begriffserläuterung
Integrationsszenarien
So funktioniert's
Einrichtung in Adjust
Ereignisse erstellen
Xsoll-Integration aktivieren
Einrichtung im Kundenportal
So funktioniert's
Einrichtung im Kundenportal
Einrichtung in Adjust
CUID als Partnerparameter übermitteln
S2S-Sicherheitstoken abrufen
Xsoll-Integration aktivieren
Ereigniswert-Struktur
Artikelkauf
Zusätzliche Daten

Your browser is not supported. Please try a different browser

Adjust integrieren

Begriffserläuterung

Adjust

App-Token

Adjust-ID

Lifetime Value (LTV)

Return on Advertising Spend (ROAS)

In-App-Ereignis

Nutzergewinnung

Customer User ID (CUID)

Rückruf

Server-zu-Server-/S2S-Sicherheitstoken

Retargeting

Web-Ereignis

Integrationsszenarien

So funktioniert's

Einrichtung in Adjust

Ereignisse erstellen

Xsoll-Integration aktivieren

Einrichtung im Kundenportal

So funktioniert's

Einrichtung im Kundenportal

Einrichtung in Adjust

CUID als Partnerparameter übermitteln

S2S-Sicherheitstoken abrufen

Xsoll-Integration aktivieren

Ereigniswert-Struktur

Artikelkauf

Zusätzliche Daten