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.

Singular Device ID (SDID)

Eindeutige ID, anhand der der Browser eines Besuchers identifiziert wird. Wird automatisch vom Singular Web SDK generiert.

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.

Lifetime Value (LTV)

Durchschnittlicher Erlös, den ein Nutzer während der Nutzung Ihrer Anwendung generiert. Weitere Informationen zum LTV finden Sie in der Singular-Dokumentation.

Return on Advertising Spend (ROAS)

Kennzahl, die die Wirksamkeit einer Werbekampagne misst. Hierbei wird der Umsatz pro Einheit der Werbeausgaben berechnet.

Web-Ereignis

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

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.

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.

Informationen zum Konfigurieren der CUID finden Sie in der Singular SDK-Dokumentation.

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.

SDK-Geheimnis

Komponente, die in Verbindung mit dem Singular-SDK-Schlüssel verwendet wird, um das Singular-SDK innerhalb einer Anwendung zu initialisieren und zu authentifizieren. Zusammen mit dem SDK-Schlüssel ermöglicht dieses Geheimnis es dem SDK-Schlüssel, sicher mit der Singular-Plattform zu kommunizieren und Anwendungsinstallationen, Ereignisse und andere Daten für Marketinganalysen korrekt zuzuordnen.

Integrationsablauf

Singular und Xsolla unterstützen die folgenden Arten von Integrationen:

S2S-Integration von Apps – ermöglicht es, die beiden Kennzahlen LTV und 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 Singular, die Singular dann der Anzahl der App-Installationen, den Nutzergewinnungs- und den Reengagement-Kampagnen zuordnet.
Web-SDK-Integration – Hiermit lässt sich messen und bewerten, wie effektiv Nutzergewinnungs- und Retargeting-Kampagnen Traffic auf den Web Shop lenken.
Mithilfe der Web-SDK-Integration können Sie 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 Singular, die Singular der entsprechenden Medienquelle, Kampagne und Werbung zuordnet, die den Nutzer zum Kauf verleitet hat.

Sie können das Web-SDK in Singular integrieren, um Advanced Analytics für Ereignisse zu erhalten, sofern Sie eines der Folgenden verwenden:

Die folgenden Ereignisse sind über die Web-SDK-Integration von Xsolla und Singular verfügbar:

Ereignis	Beschreibung
`load`	Website-Besuch-Ereignis, einschließlich URL-Parametern mit Ursprungsinformationen (also woher der Nutzer kommt) und einer Singular Device ID, die in einem Erstanbieter-Cookie gespeichert ist.
`identify`	Anmeldeereignis, einschließlich der Singular Device ID und der CUID.
`event`	Artikelkaufereignis, einschließlich der Singular Device ID und der CUID.

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 Singular 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 SG as Singular
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>SG: 3. load event
    User->>Shop: 4. Logs in with CUID
    Shop->>SG: 5. identify event
    User->>Shop: 6. Makes purchase
    Shop->>SG: 7. event

Ablauf für den Nutzer:

Der Nutzer klickt auf das Werbebanner.
Der Nutzer wird zum Web Shop weitergeleitet, wobei in der URL die Singular-Parameter und Makros enthalten sind, die angeben, von welchem Banner und welcher Website der Nutzer weitergeleitet wurde.
Ein Ereignis bezüglich des Besuchs wird vonseiten des Web-Shop-Clients an Singular gesendet.
Der Nutzer meldet sich mit seiner CUID im Web Shop an.
Das Autorisierungsereignis wird an Singular gesendet.
Der Nutzer kauft etwas im Web Shop.
Das Kaufereignis wird an Singular gesendet.

Einrichtung in Singular

Melden Sie sich bei Ihrem Singular-Konto an.
Navigieren Sie zum Menüpunkt Settings > Apps.

Klicken Sie auf Add new app.

Geben Sie den Namen Ihrer Webanwendung an.

Wählen Sie als Betriebssystem die Option Web aus.
Geben Sie im Feld URL die Domain Ihres Web Shops an, z. B. yourapp.yourcompany.com.
Geben Sie im Feld Bundle ID die Bundle-ID im Reverse-DNS-Format an, z. B. com.yourcompany.
Klicken Sie auf Save.

Einrichtung im Kundenportal

Öffnen Sie Ihr Projekt im Kundenportal.
Wechseln Sie zum Website-Baukasten:
- Navigieren Sie in der Seitenleiste zu Storefronts > Websites, wählen Sie die gewünschte Website aus, und klicken Sie auf Konfigurieren.
- Klicken Sie in der Seitenleiste auf Integrationen. Daraufhin öffnet sich eine neue Seite:
  1. Klicken Sie auf Singular.

- 1. Klicken Sie bei Web SDK (Site Builder) auf Konfigurieren.

- 1. Wählen Sie die gewünschte Website aus, und klicken Sie auf Konfigurieren.
  2. Scrollen Sie auf der Registerkarte Seiteneinstellungen zum Abschnitt Apps.
  3. Klicken Sie bei Singular auf Verbinden.

Füllen Sie in der Eingabemaske Singular-Verknüpfung die Felder SDK-Schlüssel, SDK-Geheimnis und Bundle-ID aus:

So finden Sie die Daten in Ihrem Singular-Konto:
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.
6. Kopieren Sie den Wert aus dem Feld SDK Secret.

1. Die Bundle-ID finden Sie unter Settings > Apps > Web Application.

Klicken Sie auf Verknüpfen.

So führen Sie Web- und In-App-Werbekampagnen für Web Shop durch

In dieser Anleitung ist beschrieben, wie Sie Nutzergewinnungs- und Retargeting-Kampagnen für den Xsolla Web Shop durchführen und tracken. Die Anleitung ist für beide relevant:

Web-to-Web-Shop-Kampagnen (Anzeigen, die Nutzer von Webquellen zu Ihrem Web Shop leiten)
In-App-to-Web-Shop-Retargeting-Kampagnen (Anzeigen, die Nutzer von Ihrer Anwendung zu Ihrem Web Shop leiten)

So erstellen Sie einen Singular-Website-Link:

Melden Sie sich bei Ihrem Singular-Konto an.
Wechseln Sie zum Bereich Attribution Setup, und wählen Sie Create Web Link aus.
Wählen Sie im Feld Target (App) Ihre Web-App aus, die mit dem Xsolla Web Shop verknüpft ist.
Wählen Sie im Feld Partner Ihren Werbenetzwerkpartner aus.

Geben Sie bei Bedarf einen Landing-Page-Pfad ein (optional).
Aktualisieren Sie die UTM-Felder, um Kampagnendetails zu erfassen (optional).
Klicken Sie auf Link generieren.

Basierend auf Ihrer Auswahl wird eine endgültige Ziel-URL für Ihre Webkampagne generiert. Leiten Sie den Traffic für Ihre Webkampagne über diesen Link weiter.

Für ein detaillierteres Kampagnen-Tracking (Granularität) können Sie der generierten URL Makros hinzufügen. Verwenden Sie die entsprechende Anleitung, um Makroparameter für das Singular Web SDK anzuhängen und so Daten auf Kampagnenebene zu erfassen. Achten Sie darauf, keine vorhandenen Parameter im Link zu überschreiben.

Die Anleitung können sich je nach ausgewähltem Werbenetzwerk ändern. Beachten Sie stets die spezifischen Hinweise für das jeweilige Werbenetzwerk, die im Web-URL-Builder angezeigt werden.

Weitere Informationen finden Sie in der Anleitung Singular Website Links.

So fügen Sie Web-/Web-Shop-Ereignisse in Singular hinzu

Melden Sie sich bei Ihrem Singular-Konto an.
Navigieren Sie zum Menüpunkt Settings > Events.
Fügen Sie die von Ihrem Web-SDK erfassten Ereignisse hinzu:
1. Wählen Sie die Option App specific Events aus.
2. Wählen Sie Ihre Anwendung aus.
3. Vergeben Sie unter Cohort Events einen Ereignisnamen, der in den Berichten angezeigt werden soll.
4. Wählen Sie im Feld Event maps to the following das SDK-Ereignis aus.
5. Klicken Sie auf Save.

Weitere Informationen finden Sie in der Anleitung How to Track In-App Events.

Umsatzereignisse werden automatisch als Kennzahl Revenue in die Singular-Berichte aufgenommen. Es muss also kein benutzerdefiniertes Ereignis hinzugefügt werden, es sei denn, Sie möchten mehrere Umsatzereignisse separat tracken.

So erhalten Sie den Leistungsbericht für Web-Shop-Werbekampagnen in Singular

So generieren Sie einen Bericht für Web-to-Web- und In-App-to-Web-Werbekampagnen:

Melden Sie sich bei Ihrem Singular-Konto an.
Navigieren Sie zum Menüpunkt Reports > Insights.
Konfigurieren Sie die entsprechenden Filter:
- Legen Sie den gewünschten Zeitraum fest.
- Wählen Sie die zu analysierende App aus.

Fügen Sie Dimensionen hinzu, um Ihre Daten zu segmentieren:
- Source
- Campaign Name
- zusätzliche Dimensionen nach Bedarf

Wählen Sie die Web-Kennzahlen aus:
- Web New Visitors
- Web Re-Engaged Visitors

Berücksichtigen Sie Kohortendaten:
- Revenue
- ROI
- alle zuvor unter Settings > Events konfigurierten benutzerdefinierten Kohortenereignisse

Klicken Sie oben rechts auf Run report.

Legen Sie eine klare Namenskonvention für Ihre Kampagnen fest, mit der sich Web-to-Web- und In-App-to-Web-Kampagnen unterscheiden lassen. Mithilfe dieser Taxonomie können Kampagnentypen schneller identifiziert werden, wodurch sich die Berichtsanalyse für Teams erheblich vereinfacht.

Mehr dazu erfahren Sie in der Reports FAQ

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:

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

Der Nutzer (Spieler) registriert sich bei der App oder meldet sich an.
Ihre App sendet ein In-App-Ereignis an Singular, beispielsweise login oder ein anderes Ereignis, das die CUID enthält.

Informationen zum Konfigurieren der CUID finden Sie in der Singular SDK-Dokumentation.

Singular sendet einen Postback an Xsolla, in dem die CUID und weitere Daten über das Gerät des Nutzers enthalten sind.
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 Singular empfangenen Daten abgeglichen.
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

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

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

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

Einrichtung in Singular

In Singular müssen Sie:

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

SDK-Schlüssel besorgen

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

Xsoll-Integration aktivieren

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

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

Stellen Sie sicher, dass die CUID eingerichtet ist:

Die SetCustomerId-Methode und Ihr Authentifizierungsereignis werden mithilfe vom Singular-SDK implementiert.
In Ihrem Xsolla Kundenportal ist die Integration mit Singular konfiguriert.
In Ihrem Singular-Konto ist die Integration mit Xsolla aktiviert.

Wenn Sie die Option Reject IAP without receipt für Ihre Anwendung in Singular aktiviert haben, kontaktieren sie Ihren Singular Client-Manager, um die Xsolla-Umsatzereignisse zu aktivieren oder zu deaktivieren.

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:

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

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

Parameter	Beschreibung
a	Singular-SDK-Schlüssel
p	Anwendungsplattform, z. B.: iOS
ip	öffentliche IP-Adresse des Nutzergeräts
ve	Betriebssystemversion des Nutzergeräts
ma	Marke des Nutzergeräts, z. B.: Apple
mo	Modell des Nutzergeräts, z. B.: iPhone 4S
lc	Gebietsschema des Nutzergeräts im Format `^[a-z]{2}-[A-Z]{2}$`, z. B.: `en_US`
i	Anwendungs-ID bei Singular
att_authorization_status	ATT-Statuscode (App Tracking Transparency)
n	Ereignisname, maximale Länge: 32 Zeichen
is_revenue_event	ob das Ereignis mit dem Umsatz verknüpt ist
amt	Währungsbetrag
cur	Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217
custom_user_id	CUID
partner	Partner – `xsolla`
e	sonstige eigene Parameter (optional)

Vielen Dank für Ihr Feedback!

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

Letztmalig aktualisiert: 30. Dezember 2025

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

Inhaltsverzeichnis

Begriffserläuterung
Integrationsablauf
So funktioniert's
Einrichtung in Singular
Einrichtung im Kundenportal
So führen Sie Web- und In-App-Werbekampagnen für Web Shop durch
So fügen Sie Web-/Web-Shop-Ereignisse in Singular hinzu
So erhalten Sie den Leistungsbericht für Web-Shop-Werbekampagnen in Singular
So funktioniert's
Einrichtung im Kundenportal
Einrichtung in Singular
SDK-Schlüssel besorgen
Xsoll-Integration aktivieren
Ereigniswert-Struktur
Artikelkauf
Zusätzliche Daten

Your browser is not supported. Please try a different browser

Singular integrieren

Begriffserläuterung

Singular

Singular Device ID (SDID)

Anwendungs-ID

Lifetime Value (LTV)

Return on Advertising Spend (ROAS)

Web-Ereignis

In-App-Ereignis

Nutzergewinnung

Retargeting

Customer User ID (CUID)

Postback

SDK-Schlüssel

SDK-Geheimnis

Integrationsablauf

So funktioniert's

Einrichtung in Singular

Einrichtung im Kundenportal

So führen Sie Web- und In-App-Werbekampagnen für Web Shop durch

So fügen Sie Web-/Web-Shop-Ereignisse in Singular hinzu

So erhalten Sie den Leistungsbericht für Web-Shop-Werbekampagnen in Singular

So funktioniert's

Einrichtung im Kundenportal

Einrichtung in Singular

SDK-Schlüssel besorgen

Xsoll-Integration aktivieren

Ereigniswert-Struktur

Artikelkauf

Zusätzliche Daten