Singular integrieren

Begriffserläuterung

Singular

Mobile-Attribution- und Marketing-Analytics-Plattform. Mit Singular 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 Singular-Dokumentation.

Anwendungs-ID

ID der App. Diese ID ist für jede Plattform (Android, iOS) eindeutig. Entspricht dem Bundle ID-Wert, den Sie in Singular unter Settings > Apps im Fenster der gewünschten Anwendung finden können.

In-App-Ereignis

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

Nutzergewinnung

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

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 Singular-Dokumentation.

Customer User ID (CUID)

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

Achtung

Dieser Parameter muss als Postback übermittelt werden. 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.

Postback

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

SDK-Schlüssel

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

Integrationsablauf

Singular und Xsolla unterstützen die S2S-Integration mobiler App. Dadurch können Sie messen und bewerten, wie effektiv die Kampagnen zur Nutzergewinnung und zum Retargeting den Traffic zum Web Shop lenken. Xsolla sendet Informationen über im Web Shop getätigte Käufe als In-App-Ereignisse an Singular, die Singular dann der entsprechenden Quelle zuordnet.

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

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

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

So funktioniert's

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

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'noteTextColor': '#495C6B' }}}%%
sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Singular
    User->>Mobile App: 1. Logs in
    Mobile App->>Singular: 2. Sends CUID
    Singular->>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->>Singular: 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 Singular, beispielsweise login oder ein anderes Ereignis, das die CUID enthält.
3. Singular sendet einen Postback an Xsolla, in dem die CUID und weitere Daten über das Gerät des Nutzers enthalten sind.
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 Singular empfangenen Daten abgeglichen.
7. Xsollas Server sendet ein In-App-Ereignis an Singular mit den für die Zuordnung erforderlichen Parametern.

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

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 an:
   1. Singular-SDK-Schlüssel.
   2. Anwendungs-ID, eindeutig für jede Plattform (Android/iOS). Klicken Sie auf Anwendungs-ID hinzufügen, um eine Plattform hinzuzufügen.
6. Klicken Sie auf Speichern.
7. Aktivieren Sie die Integration in Singular.

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

Einrichtung in Singular

In Singular müssen Sie:

1. sich den SDK-Schlüssel besorgen,
2. die Integration für Xsolla aktivieren.

SDK-Schlüssel besorgen

1. Melden Sie sich bei Ihrem Singular-Konto an.
2. Navigieren Sie zum Menüpunkt Developer Tools > SDK Integration.
3. Wechseln Sie zur Registerkarte SDK Keys.
4. Klicken Sie auf Show Keys.
5. Kopieren Sie den Wert aus dem Feld SDK Key.

Xsoll-Integration aktivieren

1. Melden Sie sich bei Ihrem Singular-Konto an.
2. Navigieren Sie zum Menüpunkt Attribution Setup > Partner Configuration.
3. Klicken Sie auf Add Partner.
4. Geben Sie in der Suchleiste Xsolla ein, und wählen Sie den Eintrag aus.

5. Wählen Sie in dem sich öffnenden Fenster eine Anwendung aus, für die Sie die Integration konfigurieren möchten.
6. Klicken Sie auf Next.
7. Vergewissern Sie sich, dass im Block Events Postbacks das Ereignis Login ausgewählt ist.
8. Klicken Sie auf Save.

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 Singular. Die folgenden Kaufinformationen werden in den Ereignisparametern übermittelt:

Zusätzliche Daten

Zusätzlich zu den im Ereignis xsolla-billing-payment übermittelten Parametern sendet Xsolla die folgenden Daten: