So übertragen Sie Nutzerdaten über den Startprogramm-Installer
So funktioniert's
Über den Startprogramm-Installer können Sie Nutzerdaten von der Website ans Spiel übertragen, z. B.:
- Informationen zum Tracken von Werbeaktionen oder zur Download-Quelle des Startprogramm-Installers.
- Daten mit einer begrenzten Lebensdauer. Wird für die benutzerdefinierte Authentifizierung im Spiel und die Übertragung wichtiger spielbezogener Informationen verwendet.
Für wen ist es
Partner, die bereits Launcher und Login integriert und die OAuth 2.0-Authentifizierung verknüpft haben.
Wie komme ich dazu
Implementieren Sie Folgendes, um eine nahtlose Übertragung von Nutzerdaten zu gewährleisten:
- Abruf eines Einmalpassworts
- Ergänzung des Installer-Namens um das Passwort
- Verarbeitung der an das Spiel übertragenen Nutzerdaten (optional)
Einmalpasswort abrufen
Um ein Einmalpasswort abzurufen, müssen Sie eine POST-Anfrage an die URL-Adressehttps://launcher.xsolla.com/otp
stellen. Im Anfragerumpf ist eine JSON mit den folgenden Parametern zu übermitteln:tracking_payload
– Nutzerdaten mit einer unbegrenzten Lebensdauer. Der String darf maximal 255 Zeichen umfassen.common_payload
– Nutzerdaten mit einer begrenzten Lebensdauer. Diese Daten lassen sich überschreiben. Der String darf maximal 255 Zeichen umfassen.expires_in
– die Lebensdauer (angegeben in Millisekunden in Unixzeit) der im Parametercommon_payload
übermittelten Daten. Erforderlich, soferncommon_payload
übertragen wird.
Copy
curl
-X POST
"https://launcher.xsolla.com/otp?common_payload=<common_payload>"
-H
"accept: application/json"
-H
"Content-Type: application/json"
Hinweis
Werden die Parameter
tracking_payload
, common_payload
oder expires_in
verwendet, müssen dafür Werte angegeben sein.tracking_payload
als Abfrageparameter übermitteln.Copy
curl -X POST "https://launcher.xsolla.com/otp?tracking_payload=<tracking_payload>" -H "accept: application/json" -H "Content-Type: application/json"
Installer-Namen um Einmalpasswort ergänzen
Das empfangene Einmalpasswort ist ein 36 Zeichen langer String im UUID-Format. Ergänzen Sie den Namen der Installationsdatei um das Einmalpasswort, und zwar gemäß dem folgendem Format:LauncherName_<OTP>.exe
, wobei <OTP>
das Einmalpasswort ist.Abruf von Benutzerdaten durch das Spiel
Das Startprogramm übermittelt die im Parametertracking_payload
empfangenen Daten als Wert des Befehlszeilenarguments –tracking_payload
, wie im folgenden Beispiel gezeigt. Zudem prüft es, ob die im Parameter common_payload
übermittelten Daten vorhanden und gültig sind und übermittelt sie als Wert des Befehlszeilenarguments –xsolla-common-payload
, wie im folgenden Beispiel gezeigt.Copy
game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
Hinweis
Das Startprogramm sendet bei jedem Spielstart die Benutzerdaten an das Spiel.
tracking_payload
empfangenen Daten als Wert des Abfrageparameters tracking_payload
, wie im folgenden Beispiel gezeigt.Copy
https://web-game-plum.vercel.app/api?locale=en&tracking_payload=<tracking_payload>
Der Parameter tracking_payload
wird im Format UTF-8 codiert und übermittelt. Um den Parameter zu decodieren, müssen Sie aufseiten des Spiels die Ausführung der Funktion decodeURIComponent(<tracking_payload>)
implementieren.
War dieser Artikel hilfreich?
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.