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.
Daten werden mithilfe eines Einmalpassworts an das Startprogramm übertragen (das Basisszenario ist in der Anleitung beschrieben).

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.
Anfrage zum Abrufen eines Einmalpassworts (Beispiel):
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"
    
    Hinweis
    Werden die Parameter tracking_payload, common_payload oder expires_in verwendet, müssen dafür Werte angegeben sein.
    Sie können auch tracking_payload als Abfrageparameter übermitteln.
    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"
      

      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.
      Copy
      Full screen
      Small screen
        game.exe --tracking_payload <tracking_payload> WU9VUiBEQVRBIEhFUkU=
        
        Hinweis
        Das Startprogramm sendet bei jedem Spielstart die Benutzerdaten an das Spiel.
        Beim Start eines Browserspiels übermittelt der Launcher die im Parameter tracking_payload empfangenen Daten als Wert des Abfrageparameters tracking_payload, wie im folgenden Beispiel gezeigt.
        Copy
        Full screen
        Small screen
          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!
          Gibt es etwas, das wir verbessern können? Nachricht
          Das tut uns leid
          Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
          Vielen Dank für Ihr Feedback!
          Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
          Letztmalig aktualisiert: 24. September 2024

          Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

          Problem melden
          Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
          Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
          Vielen Dank für Ihr Feedback!