So integrieren Sie das Benutzerkonto

So funktioniert's

Benutzer können folgende Daten über deren Konto verwalten:

  • Profilbild
  • Telefonnummer
  • E-Mail-Adresse
  • Nickname
  • Vor- und Nachname
  • Geburtsdatum
  • Geschlecht
  • Freundesliste (nur über API verfügbar).

Das Benutzerkonto lässt sich auf eine der folgenden Weisen integrieren:

  • Mit Benutzeroberfläche über eine URL. Die Benutzeroberfläche des Benutzerkontos ist in 20 Sprachen verfügbar und passt sich je nach Bildschirmauflösung an.
  • Ohne Benutzeroberfläche über die API. Auf diese Weise können Sie Ihre eigene Benutzeroberfläche zum Verwalten der Benutzerdaten implementieren.

Für wen ist es

Partner, die bereits den Login integriert haben.

Wie komme ich dazu

Entscheiden Sie sich für eine der beiden Integrationsmöglichkeiten und verfahren Sie gemäß folgenden Anweisungen.

Integration über URL

  1. Generieren Sie eine URL zum Aufruf des Benutzerkontos.
  2. Konfigurieren Sie den Benutzerkonto-Aufruf in der generierten URL.
  3. Konfigurieren Sie die Verarbeitung von Ereignissen (optional).

URL generieren

Der Aufruf des Benutzerkontos erfolgt über https://useraccount.xsolla.com/profile mit den in der folgenden Tabelle aufgelisteten Parametern.

ParameterTypBeschreibung
locale
stringAnfrageparameter. Sprache der Benutzeroberfläche des Benutzerkontos. Akzeptiert Werte gemäß der Norm ISO 639-1.
token
stringHash-Parameter. Benutzer-JWT. Wird nach erfolgreicher Authentifizierung in der URL übermittelt. Erforderlich.

URL-Beispiel:

Copy
Full screen
Small screen
https://useraccount.xsolla.com/profile?locale=de#token=XXXX

Benutzerkonto-Aufruf in der URL einrichten

Das Benutzerkonto lässt sich über eine bestimmte URL auf folgende Weisen aufrufen:

  • in einem iframe auf Ihrer Website
  • in einem neuen Tab

IFRAME

Fügen Sie das folgende Skript zu derjenigen Website hinzu, über die der Aufruf des Benutzerkontos erfolgen soll: <iframe src="https://useraccount.xsolla.com/profile?locale=ru#token=XXXX">, wobei src der generierten URL entspricht.

NEUES TAB

Fügen Sie eine URL zum UI-Objekt hinzu, das zum Benutzerkonto weiterleitet.

Dafür können Sie folgendes Skript verwenden: <a href="https://useraccount.xsolla.com/profile?locale=ru#token=XXXX">Your account</a>, wobei src der generierten URL entspricht.

Ereignisverarbeitung einrichten (optional)

Bei Aufruf des Benutzerkontos in einem iframe erhält das übergeordnete Fenster postMessage-Ereignisse entsprechend den Benutzeraktionen im Konto.

EreignisnameBeschreibung
user-account-closeDer Benutzer klickt auf die Schaltfläche "Beenden" und schließt das Benutzerkonto.
user-account-loadedBenutzerkonto ist geladen, aber die Benutzerdaten können nicht abgerufen werden.
user-account-page-fetchedBenutzerkonto und Benutzerdaten wurden erfolgreich geladen.

Um diese Ereignisse zu verarbeiten, fügen Sie die Methode addEventListener und Ihr Skript zur Website hinzu.

Beispiel für eine Ereignisverarbeitung:

Copy
Full screen
Small screen
window.addEventListener('message', (event) => {
  if (event.data.command === 'user-account-loaded') {
    // your script
  }
})

Integration über API-Aufrufe

Um Benutzerdaten über die API zu verwalten, implementieren Sie Ihre eigene Benutzeroberfläche und gestatten Sie den Aufruf von API-Anfragen. Eine detaillierte Beschreibung der verfügbaren API-Aufrufe und Code-Beispiele finden Sie in unserer Dokumentation.

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: 1. Dezember 2021

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!