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:

1. Abruf eines Einmalpassworts
2. Ergänzung des Installer-Namens um das Passwort
3. Verarbeitung der an das Spiel übertragenen Nutzerdaten (optional)

Einmalpasswort abrufen

Um ein Einmalpasswort abzurufen, müssen Sie eine POST-Anfrage an die URL-Adresse https://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 Parameter common_payload übermittelten Daten. Erforderlich, sofern common_payload übertragen wird.

1curl -X POST "https://launcher.xsolla.com/otp?common_payload=<common_payload>" \
2  -H "accept: application/json" \
3  -H "Content-Type: application/json"

1curl -X POST "https://launcher.xsolla.com/otp?tracking_payload=<tracking_payload>" \
2  -H "accept: application/json" \
3  -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 Parameter tracking_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.

1game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=

1https://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.