Utilisation d'une règle pour vérifier une adresse e-mail de contact

​

Configuration requise

• Pour envoyer des e-mails personnalisés avec des modèles d’e-mail, vous devez disposer de votre propre serveur SMTP avec un nom d’utilisateur et un mot de passe. Vérifiez que vous disposez de votre propre serveur SMTP avant de suivre notre tutoriel Configuration d’un serveur SMTP avec des modules complémentaires.

• Des connaissances de base sur la création d’un joueur sont nécessaires, car des joueurs dotés d’un nom d’utilisateur et d’un mot de passe doivent exister avant d’appeler la logique de récupération de compte.
• Lisez le démarrage rapide de Game Manager si vous ne connaissez pas Game Manager, car c’est là que les modèles d’e-mail sont créés.
• Vous devez savoir utiliser les profils de joueurs afin de vérifier qu’une adresse e-mail de contact a bien été ajoutée au profil d’un joueur. Découvrez comment obtenir le profil d’un joueur dans le tutoriel Obtention des profils de joueurs et assurez-vous d’autoriser les Contact email addresses dans les Client Profile Options de votre Title.
• La création d’une règle étant nécessaire dans ce tutoriel, il est conseillé de vous renseigner sur le fonctionnement des règles.

​

Étape 1 : créer un modèle d’e-mail

• Sélectionnez Content dans le menu de gauche.
• Accédez à l’onglet Email Templates.
• Sélectionnez le bouton NEW EMAIL TEMPLATE.

• Template name : MyFirstEmailVerificationTemplate
• Template type : Email Verification
• Email subject : Verify your email
• Email body : (saisissez le contenu ci-dessous)

<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>

• From Name : le nom que vous souhaitez afficher dans le champ From de l’e-mail.
• From Email Address : l’adresse e-mail que vous souhaitez afficher dans le champ From de l’e-mail. Il doit s’agir d’un domaine de messagerie à partir duquel le serveur SMTP vous permet d’envoyer des e-mails.

• Callback URL : https://www.example.com

​

Quelques points à retenir

• Le $ConfirmationUrl$ du corps de l’e-mail génère une URL personnalisée qui, lorsqu’elle est sélectionnée, enregistre que l’utilisateur a sélectionné l’URL, puis effectue une redirection vers la Callback URL. Dans ce cas, elle est injectée dans une balise d’ancrage.
• La Callback URL est l’URL vers laquelle PlayFab redirige le joueur après qu’il a sélectionné le lien Confirmation URL. Il peut s’agir d’une page statique indiquant à l’utilisateur que la confirmation de son adresse e-mail a réussi. Dans ce cas, nous redirigerons vers https://www.example.com.

​

Étape 2 : créer une règle pour envoyer un e-mail lors de la mise à jour d’une adresse e-mail de contact

• Sélectionnez Automation dans le menu de gauche.
• Sélectionnez l’onglet Rules.
• Sélectionnez NEW RULE.
• Renseignez le champ Rule Name avec votre Rule VerifyUpdatedEmail.
• Dans la liste déroulante Event Type, sélectionnez com.playfab.player_updated_contact_email.
• Sous l’en-tête Actions, sélectionnez +ADD ACTION.

• La liste déroulante Email template doit être renseignée avec le modèle créé à l’étape 1, MyFirstEmailVerificationTemplate.
• Si ce n’est pas le cas, sélectionnez MyFirstEmailVerificationTemplate dans la liste déroulante.

​

Étape 3 : ajouter une adresse e-mail de contact à un joueur

​

Exemple de code C#

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());
}

​

Étape 4 : vérifier que l’adresse e-mail de contact a été ajoutée au profil du joueur

​

Étape 5 : vérifier que l’e-mail a été envoyé

• Sélectionnez Players dans le menu de gauche.
• Dans l’onglet Players, accédez à la zone PlayStream.
• Un Sent Email Event doit s’afficher.

{
    "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"
}

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

1. PlayFab génère un nouvel événement PlayStream, appelé auth_token_validated. C’est ainsi que vous savez que le joueur a sélectionné cette URL dans l’e-mail.
   • Vous pouvez utiliser cet événement pour déclencher des actions, comme l’octroi de pièces ou d’articles au joueur.
2. Comme ce modèle d’e-mail était le modèle spécial Email Verification, PlayFab marque ensuite l’adresse e-mail du joueur comme Verified.
3. PlayFab renvoie une URL de redirection qui envoie le joueur vers le site web de l’URL de rappel.
   • Sur ce site web, vous pouvez afficher un message statique Thanks for verifying your email, ou quelque chose de plus élaboré. L’URL de redirection ressemble à ceci : https://www.example.com/?token=2346241B7C277796.
   • Sélectionnez l’URL figurant dans l’e-mail.
   • Vous êtes redirigé vers le site web example.com.
   • Affichez votre Player Profile à l’aide de Game Manager.
   • Vous constaterez que le Verification status a changé.

​

Conclusion