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 :
- Récupération du mot de passe à usage unique.
- Ajout du mot de passe à usage unique au nom de l’installateur.
- 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 URLhttps://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ètrecommon_payload
au format Unix time, en millisecondes. Requis sicommon_payload
est passé.
Copy
curl
-X POST
"https://launcher.xsolla.com/otp?common_payload=<common_payload>"
-H
"accept: application/json"
-H
"Content-Type: application/json"
Note
Si les paramètres
tracking_payload
, common_payload
ou expires_in
sont utilisés, leurs valeurs ne peuvent pas être vides.tracking_payload
comme paramètre de requête.Copy
curl -X POST "https://launcher.xsolla.com/otp?tracking_payload=<tracking_payload>" -H "accept: application/json" -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ètretracking_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.Copy
game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
Note
Launcher envoie les données utilisateur au jeu à chaque fois que le jeu est lancé.
tracking_payload
en tant que valeur du paramètre de requête tracking_payload
, comme le montre l’exemple ci-dessous.Copy
https://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.
Cet article vous a été utile ?
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.