Comment transférer les données utilisateur via l’installateur de Launcher

Comment ça marche

Vous pouvez transférer des données utilisateur du site Web au jeu via l’installateur de Launcher, par exemple :

• Les informations de suivi des promotions ou de la source du téléchargement de l’installateur de Launcher.
• Les données avec une durée de vie limitée. Elles sont utilisées pour l’authentification personnalisée dans le jeu et le transfert d’informations critiques liées au jeu.

Qui peut l'utiliser

Les partenaires qui ont déjà intégré Launcher et Login et connecté l’authentification OAuth 2.0.

Comment configurer

Pour activer le transfert de données utilisateur, implémentez les étapes suivantes :

1. Récupération du mot de passe à usage unique.
2. Ajout du mot de passe à usage unique au nom de l’installateur.
3. Traitement des données utilisateur passées au jeu (facultatif).

Récupération du mot de passe à usage unique

Pour implémenter l’obtention du mot de passe à usage unique, effectuez une requête POST à l’adresse URL https://launcher.xsolla.com/otp. Dans le corps de la requête, passez un JSON avec les paramètres suivants :

• tracking_payload — données utilisateur avec une durée de vie illimitée. La longueur maximale de la chaîne est de 255 caractères.
• common_payload — données utilisateur avec une durée de vie limitée. Ces données peuvent être écrasées. La longueur maximale de la chaîne est de 255 caractères.
• expires_in — durée de vie des données passées dans le paramètre common_payload au format Unix time, en millisecondes. Requis si common_payload est passé.

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"

Ajout du mot de passe à usage unique au nom de l'installateur

Le mot de passe à usage unique reçu est une chaîne de 36 caractères au format UUID. Implémentez l’ajout du mot de passe à usage unique au nom du fichier d’installation lors du téléchargement dans le format suivant : LauncherName_<OTP>.exe, où <OTP> est le mot de passe à usage unique.

Récupération des données utilisateur par le jeu

Launcher passe les données reçues dans le paramètre tracking_payload en tant que valeur de l’argument de ligne de commande –tracking_payload, comme illustré dans l’exemple ci-dessous. Il vérifie également la présence et la durée de vie des données passées dans le paramètre common_payload et les passe en tant que valeur de l’argument de ligne de commande –xsolla-common-payload, comme illustré dans l’exemple ci-dessous.

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

1https://web-game-plum.vercel.app/api?locale=en&tracking_payload=<tracking_payload>

Le paramètre tracking_payload est encodé en UTF-8. Pour le décoder, implémentez l’exécution de la fonction decodeURIComponent(<tracking_payload>) côté jeu.