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.
Pour transférer des données vers Launcher, une fonctionnalité étendue de mot de passe à usage unique est utilisée (le scénario de base est décrit dans les instructions).

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é.
Exemple de requête d’obtention de mot de passe à usage unique :
Copy
Full screen
Small screen
    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.
    Vous pouvez également passer le tracking_payload comme paramètre de requête.
    Copy
    Full screen
    Small screen
      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è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.
      Copy
      Full screen
      Small screen
        game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
        
        Note
        Launcher envoie les données utilisateur au jeu à chaque fois que le jeu est lancé.
        Lors du lancement d’un jeu sur navigateur, Launcher passe les données reçues dans le paramètre tracking_payload en tant que valeur du paramètre de requête tracking_payload, comme le montre l’exemple ci-dessous.
        Copy
        Full screen
        Small screen
          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 !
          Que pouvons-nous améliorer ? Message
          Nous sommes désolés de l'apprendre
          Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
          Merci pour votre commentaire !
          Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
          Dernière mise à jour: 24 Septembre 2024

          Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

          Signaler un problème
          Nous améliorons continuellement notre contenu grâce à vos commentaires.
          Indiquez votre adresse e-mail pour un suivi
          Merci pour votre commentaire !