E-Mail-Adressen und Telefonnummern erfassen

So funktioniert's

Das Login-Produkt speichert automatisch die von den Benutzern bei der Registrierung oder Anmeldung angegebenen Daten. Diese Daten werden in der Xsolla-Datenbank gespeichert und umfassen die E-Mail-Adresse und die Telefonnummer des Benutzers. In manchen Fällen werden nicht alle Kontaktdaten übermittelt, z. B.:

• Bei der passwortlosen Anmeldung werden nur die Kontaktdaten an Ihr Login-Projekt übermittelt, die der Benutzer angegeben hat, um einen einmaligen Bestätigungscode zu erhalten, d. h. nur eine E-Mail-Adresse oder eine Telefonnummer.
• Bei der Autorisierung über ein soziales Netzwerk übermittelt dessen Anbieter möglicherweise keine E-Mail-Adressen der Benutzer.

Sie können zusätzlich fehlende Kontaktdaten über das Login-Produkt abfragen und damit:

• die E-Mail-Adressen der Benutzer in Ihr Mailchimp-Konto exportieren und sie Ihrer Newsletter-Liste hinzuzufügen;
• eine individuelle Kennung für den Benutzer basierend auf seiner E-Mail-Adresse oder Telefonnummer erstellen.

Für wen ist es

Partner, die sowohl Login bereits integriert als auch die Option, sich über soziale Netzwerke oder per passwortloser Autorisierung bei der Anwendung anzumelden, konfiguriert haben.

Wie komme ich dazu

Je nach der für Ihr Login-Projekt gewählten Integrationsoption können Sie die Erfassung von E-Mail-Adressen und Telefonnummern wie folgt konfigurieren:

• über das Login-Widget v2.0
• über Login API-Aufrufe

E-Mail-Adressen und Telefonnummern über das Login-Widget v2.0 erfassen

Mit dem Login-Widget v2.0 können Sie Benutzer bitten, ihre E-Mail-Adressen und/oder Telefonnummern einzugeben, wenn diese in folgenden Szenarien nicht angegeben wurden:

• bei der Registrierung über soziale Netzwerke;
• beim Anmelden bei der Anwendung mithilfe eines Einmalcodes (d. h. bei Nutzung der passwortlosen Authentifizierung).

Nachdem Sie die Abfrage von E-Mail-Adressen und/oder Telefonnummern im Kundenportal aktiviert haben, wird Ihr Login-Projekt automatisch:

1. dem Benutzer Formulare zur Eingabe seiner E-Mail-Adresse und/oder Telefonnummer anzeigen;
2. nach dem Ausfüllen der Formulare dem Benutzer einen Code oder einen Link zur Bestätigung der eingegebenen Daten senden;
3. den Bestätigungscode abgleichen und die erhaltenen Daten in der Datenbank speichern.

Sie können die Benutzer verpflichten, die Formulare auszufüllen.

So aktivieren Sie die Erfassung von E-Mail-Adressen und Telefonnummern der Benutzer:

1. Öffnen Sie Ihr Projekt im Kundenportal, und wechseln Sie zum Abschnitt Login.
2. Klicken Sie beim gewünschten Login-Projekt auf Konfigurieren.
3. Scrollen Sie zum Block Authentifizierung, und klicken Sie auf Formular für sonstige Daten.

4. So legen Sie fest, dass Ihr Login-Projekt ein Formular anzeigt, in dem der Benutzer seine E-Mail-Adresse angeben kann:
   1. Stellen Sie den Umschalter E-Mail-Adresse des Benutzers erfassen auf Ein.
   2. Wählen Sie eine Methode für die Bestätigung der E-Mail-Adresse: Mittels Code oder Mittels Code und Link.
5. Stellen Sie den Umschalter Benutzer muss E-Mail-Formular ausfüllen auf Ein, wenn Benutzer verpflichtet sein sollen, ihre E-Mail-Adresse anzugeben.
6. Damit Ihr Login-Projekt ein Formular anzeigt, in dem der Benutzer seine Telefonnummer angeben kann, müssen Sie den Umschalter Telefonnummer des Benutzers erfassen auf Ein stellen.

7. Stellen Sie den Umschalter Benutzer muss Telefonnummer angeben auf Ein, wenn Benutzer verpflichtet sein sollen, ihre Telefonnummer anzugeben.
8. Wenn Sie sowohl das Formular zur Erfassung von E-Mail-Adressen als auch das Formular zur Erfassung von Telefonnummern aktiviert haben, wählen Sie in der Drop-down-Liste unten auf der Seite die Reihenfolge aus, in der die Formulare dem Benutzer angezeigt werden sollen.

E-Mail-Adressen über Login API-Aufrufe erfassen

Mit der Login API können Sie Benutzer bitten, ihre E-Mail-Adressen einzugeben, wenn diese bei der Registrierung über soziale Netzwerke nicht angegeben wurden.

Wenn Sie Ihr Login-Projekt über Login API-Aufrufe integriert haben:

• Fügen Sie den Parameter fields=email hinzu, wenn Sie den Aufruf Auth via social network mit einem JWT-Standard nutzen.

Anfragebeispiel:

GET https://login.xsolla.com/api/social/{providerName}/login_redirect?projectId={projectId}&fields=email&login_url={login_url} HTTP/1.1

curl --request GET \
  --url 'https://login.xsolla.com/api/social/providerName/login_redirect?projectId=projectId&fields=email&login_url=login_url'

• Fügen Sie den Parameter scope=email hinzu, wenn Sie den Aufruf Auth via social network mit einem OAuth 2.0-Protokoll durchführen.

Anfragebeispiel:

GET https://login.xsolla.com/api/oauth2/social/{providerName}/login_redirect?scope=email&client_id={client_id}&redirect_uri={redirect_uri}&state={state}&response_type=code HTTP/1.1

curl --request GET \
  --url 'https://login.xsolla.com/api/oauth2/social/provider_name/login_redirect?scope=email&client_id=client_id&redirect_uri=redirect_uri&state=state&response_type=code'