Verwenden einer Regel zum Überprüfen einer Kontakt-E-Mail-Adresse

  • Artikel

Dieses Tutorial führt Sie durch die Schritte zum Erstellen einer Regel, die eine Überprüfungs-E-Mail sendet, wenn ein Spieler seine Kontakt-E-Mail-Adresse ändert.

Voraussetzungen

Wichtig

Dies ist ein erweitertes Tutorial. Stellen Sie sicher, dass alle Anforderungen erfüllt wurden, andernfalls können Sie dieses Tutorial nicht abschließen.

  • Um benutzerdefinierte E-Mails mit E-Mail-Vorlagen zu senden, benötigen Sie einen eigenen SMTP-Server mit einem Benutzernamen und Kennwort. Vergewissern Sie sich, dass Sie über Einen eigenen SMTP-Server verfügen, bevor Sie unser Tutorial Einrichten eines SMTP-Servers mit Add-Ons befolgen.

Notiz

Sie können Gmail zu Testzwecken verwenden, aber mit Gmail sind Sie auf 2.000 E-Mails pro Tag beschränkt.

  • Grundkenntnisse in der Erstellung eines Spielers sind erforderlich, da Spieler mit einem Benutzernamen und Kennwort vorhanden sein müssen, bevor die Kontowiederherstellungslogik aufgerufen wird.
  • Lesen Sie den Game Manager-Schnellstart , wenn Sie mit Game Manager nicht vertraut sind, da dort E-Mail-Vorlagen erstellt werden.
  • Kenntnisse über die Arbeit mit Spielerprofilen sind erforderlich, um zu bestätigen, dass E-Mails erforderlich sind, um zu überprüfen, ob dem Profil eines Spielers eine Kontakt-E-Mail hinzugefügt wurde. Lesen Sie im Tutorial Abrufen von Spielerprofilen , wie Sie das Profil eines Spielers abrufen, und stellen Sie sicher, dass Sie unter den Clientprofiloptionen in Ihrem TitelKontakt-E-Mail-Adressen zulassen.
  • Das Erstellen einer Regel ist in diesem Tutorial erforderlich. Es empfiehlt sich, sich mit der Funktionsweise von Regeln zu informieren.

Schritt 1: Erstellen einer E-Mail-Vorlage

Als Erstes erstellen wir eine E-Mail-Vorlage für die Kontowiederherstellung.

  • Wählen Sie im Menü auf der linken Seite Inhalt aus.
  • Wechseln Sie zur Registerkarte Email Vorlagen.
  • Wählen Sie die Schaltfläche NEUE E-MAIL-VORLAGE aus.

Game Manager – Inhalt – Email Vorlagen

Fügen Sie nun eine Neue Email-Vorlage hinzu, füllen Sie die Felder wie folgt aus, und lassen Sie die Fehlerrückruf-URL leer:

  • Vorlagenname: MyFirstEmailVerificationTemplate
  • Vorlagentyp: Email Überprüfung
  • Email Betreff: Überprüfen Ihrer E-Mail-Adresse
  • Email Text: (geben Sie wie unten angegeben ein)
<head></head>
<body><p> You recently registered a new email with us.</p>
<p>Please click <a href="$ConfirmationUrl$">here</a> confirm your email. Thanks!</p>

  • Aus Name: Der Name, den Sie im Feld Von in der E-Mail anzeigen möchten.

  • Von Email Adresse: Die E-Mail-Adresse, die in der E-Mail im Feld Von angezeigt werden soll. Dies muss eine E-Mail-Domäne sein, über die der SMTP-Server E-Mails senden kann.

    Notiz

    Einige E-Mail-Server, z. B. Gmail, ignorieren dieses Feld und senden über das Konto, das mit dem SMTP-Server eingerichtet wurde.

  • Rückruf-URL: https://www.example.com

Ein paar Dinge, die Sie sich merken sollten

  • Der $ConfirmationUrl$ im E-Mail-Text generiert eine angepasste URL, die bei Auswahl nachverfolgt, dass ein Benutzer die URL ausgewählt hat, und gibt dann eine Umleitung zur Rückruf-URL aus. In diesem Fall wird es in ein Ankertag eingefügt.
  • Die Rückruf-URL ist die URL, an die PlayFab umleitet, nachdem der Spieler den Link Bestätigungs-URL ausgewählt hat. Dies kann eine statische Seite sein, die dem Benutzer mitteilt, dass er seine E-Mail erfolgreich bestätigt hat. In diesem Fall leiten wir zu https://www.example.comum.

Game Manager – Inhalt – Email-Vorlagen – Neue Email-Vorlage

Nachdem Sie das Formular ausgefüllt haben, wählen Sie die Schaltfläche E-Mail-Vorlage speichern aus, und Sie werden zurück zu der Seite weitergeleitet, die die Liste Ihrer E-Mail-Vorlagen enthält. Notieren Sie sich die ID der E-Mail-Vorlage, da sie in Schritt 4 verwendet wird.

Game Manager – Inhalt – Email Vorlagen-ID

Schritt 2: Erstellen einer Regel zum Senden einer E-Mail beim Aktualisieren einer Kontakt-E-Mail

Als Nächstes erstellen wir eine Regel zum Senden einer Überprüfungs-E-Mail, wenn ein Spieler seine Kontakt-E-Mail aktualisiert. In Game Manager:

  • Wählen Sie im Menü auf der linken Seite Automatisierung aus.
  • Wählen Sie die Registerkarte Regeln aus.
  • Wählen Sie NEUE REGEL aus.
  • Füllen Sie das Feld Regelname mit Ihrer Regel VerifyUpdatedEmail aus.
  • Wählen Sie in der Dropdownliste Ereignistypdie Option com.playfab.player_updated_contact_email aus.
  • Wählen Sie unter der Überschrift Aktionendie Option +AKTION HINZUFÜGEN aus.

Game Manager – Automatisierung – Neue Regel – Aktion hinzufügen

Wählen Sie in der Dropdownliste Typ die Option Email senden aus.

  • Die Dropdownliste Email Vorlage sollte mit der vorlage aufgefüllt werden, die in Schritt 1 MyFirstEmailVerificationTemplate erstellt wurde.
  • Wenn dies nicht der Fall ist, wählen Sie in der Dropdownliste MyFirstEmailVerificationTemplate aus.

Game Manager – Automatisierung – Neue Regel – Aktion speichern

Schritt 3: Hinzufügen einer Kontakt-E-Mail zu einem Spieler

Für diesen nächsten Schritt benötigen Sie ein vorhandenes Spielerkonto.

Wir fügen dem Spieler mithilfe von AddOrUpdateContactEmail eine Kontakt-E-Mail hinzu.

Notiz

Ein Feld "Kontakt Email" in einem Spielerprofil unterscheidet sich vom Feld "Anmeldung Email" in einem Spielerprofil, obwohl beide die gleiche E-Mail-Adresse enthalten können. Jedes Mal, wenn Sie eine E-Mail an den Spieler senden, wird diese nur an die E-Mail-Adresse des Kontakts gesendet.

C#-Codebeispiel

Im folgenden Beispiel melden wir einen Spieler an und fügen dann mithilfe von AddOrUpdateContactEmail eine Kontakt-E-Mail-Adresse hinzu. Stellen Sie sicher, dass es sich bei der dem Spieler zugeordneten E-Mail-Adresse um eine E-Mail-Adresse handelt, auf die Sie zugreifen können.

void AddContactEmailToPlayer()
{
    var loginReq = new LoginWithCustomIDRequest
    {
        CustomId = "SomeCustomID", // replace with your own Custom ID
        CreateAccount = true // otherwise this will create an account with that ID
    };

    var emailAddress = "testaddress@example.com"; // Set this to your own email

    PlayFabClientAPI.LoginWithCustomID(loginReq, loginRes =>
    {
        Debug.Log("Successfully logged in player with PlayFabId: " + loginRes.PlayFabId);
        AddOrUpdateContactEmail(loginRes.PlayFabId, emailAddress);
    }, FailureCallback);
}

void AddOrUpdateContactEmail(string playFabId, string emailAddress)
{
    var request = new AddOrUpdateContactEmailRequest
    {
        EmailAddress = emailAddress
    };
    PlayFabClientAPI.AddOrUpdateContactEmail(request, result =>
    {
        Debug.Log("The player's account has been updated with a contact email");
    }, FailureCallback);
}

void FailureCallback(PlayFabError error)
{
    Debug.LogWarning("Something went wrong with your API call. Here's some debug information:");
    Debug.LogError(error.GenerateErrorReport());
}

Schritt 4 : Bestätigen, dass die Kontakt-E-Mail dem Profil des Spielers hinzugefügt wurde

Bestätigen Sie als Nächstes, dass die Kontakt-E-Mail dem Profil des Spielers hinzugefügt wurde. Melden Sie sich beim Game Manager an, und besuchen Sie die Seite Spielerprofil .

Es sollte eine Kontakt-Email für diesen Spieler mit überprüfungsstatus: Ausstehend angezeigt werden.

Notiz

Der Überprüfungsstatus könnte nicht überprüft lauten, wenn die Überprüfungs-E-Mail noch nicht gesendet wurde, aber in den Status Ausstehend wechselt, sobald die E-Mail gesendet wird.

Game Manager – Spielerprofil – Kontakt-E-Mail – Überprüfung ausstehend

Sie können getPlayerProfile auch mit ShowContactEmailAddresses in der PlayerProfileViewConstraints aufrufen, die auf True festgelegt ist, um anzuzeigen, dass der Spieler jetzt über die Kontakt-E-Mail verfügt, die wir gerade hinzugefügt haben.

Schritt 5 : Überprüfen, ob die E-Mail gesendet wurde

Schließlich können wir überprüfen, ob die E-Mail zur Kontowiederherstellung gesendet wurde.

Das erste, was Sie tun können, ist, zum PlayStream des Spielers in Game Manager zu wechseln:

  • Wählen Sie im Menü auf der linken Seite Player aus.
  • Wechseln Sie auf der Registerkarte Spieler zum Bereich PlayStream .
  • Es sollte ein Gesendetes Email-Ereignis angezeigt werden.

Game Manager – Spieler – PlayStream – Gesendetes E-Mail-Ereignis

Wenn Sie auf dem Ereignis das Symbol Info auswählen, sollte JSON ähnlich dem unten gezeigten angezeigt werden.

{
    "EventName": "sent_email",
    "EventNamespace": "com.playfab",
    "Source": "PlayFab",
    "EntityType": "player",
    "TitleId": "YourTitleId",
    "EventId": "a05625e48b1f4194bd08d1ff6a889cf8",
    "EntityId": "64647AA368D6448E",
    "SourceType": "BackEnd",
    "Timestamp": "2017-10-27T09:35:16.2946918Z",
    "History": null,
    "CustomTags": null,
    "Reserved": null,
    "emailTemplateId": "7D6438687903D4DC",
    "emailTemplateName": "MyFirstEmailVerificationTemplate",
    "emailTemplateType": "EmailVerification",
    "success": true,
    "emailName": "Primary"
}

Um zu überprüfen, ob Sie die E-Mail tatsächlich erhalten haben, wechseln Sie zu der E-Mail des Spielers, den Sie in Schritt 3 erstellt haben. Es sollte eine E-Mail geben, die der unten gezeigten ähnelt.

Überprüfen Ihrer E-Mail-Adresse – E-Mail

Wenn Sie die URL in dieser E-Mail überprüfen, sehen Sie, dass sie in etwa wie diese aussieht.

https://a5f3.playfabapi.com/EmailConfirmation/Confirm/?token=2346241B7C277796&titleId=A5F3&templateId=38017AAE7F494AB3

Wenn der Spieler diese URL auswählt, geschieht folgendes:

  1. PlayFab generiert ein neues PlayStream-Ereignis namens auth_token_validated. So wissen Sie, dass der Spieler diese URL in der E-Mail ausgewählt hat.
    • Sie können dieses Ereignis verwenden, um Aktionen wie das Gewähren von Münzen oder Gegenständen an den Spieler auszulösen.
  2. Da diese E-Mail-Vorlage die spezielle Vorlage Email Überprüfung war, markiert PlayFab die Spieler-E-Mail dann als verifiziert.
  3. PlayFab gibt eine Umleitungs-URL zurück, die den Spieler an die Rückruf-URL-Website sendet.

    • Auf dieser Website können Sie einen statischen Dank für die Überprüfung Ihrer E-Mail-Nachricht oder etwas aufwändiger zeigen. Die Umleitungs-URL sieht in etwa wie folgt aus: https://www.example.com/?token=2346241B7C277796.

    • Wählen Sie die url aus, die in der E-Mail gefunden wurde.

    • Sie werden zur example.com Website weitergeleitet.

    • Zeigen Sie Ihr Spielerprofil mit dem Game Manager an.

    • Sie sehen, dass sich die überprüfungs-status geändert hat.

Game Manager – Spielerprofil – Kontakt-E-Mail – Überprüfung bestätigt

Abschluss

Das ist es also für dieses Tutorial. Sie haben erfahren, wie Sie Ihren SMTP-Server einrichten, eine E-Mail-Vorlage erstellen und eine Regel erstellen, die eine E-Mail an einen Spieler sendet, der seine E-Mail-Adresse überprüft.

Wenn Sie Fragen oder Feedback zu diesem Tutorial haben, teilen Sie uns dies bitte in unseren Communityforen mit.