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.
Beispielanfrage zum Abrufen eines Einmalpassworts:
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.
        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.
        Diese Seite bewerten
        Diese Seite bewerten
        Gibt es etwas, das wir verbessern können?

        Jetzt nicht

        Vielen Dank für Ihr Feedback!
        Letztmalig aktualisiert: 9. November 2023

        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!