> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modèles d'e-mail localisés

> Créez des modèles d'e-mail PlayFab comportant plusieurs versions traduites sous un même ID de modèle, afin que les joueurs reçoivent les e-mails relatifs à leur compte dans leur langue préférée.

PlayFab introduit la prise en charge du stockage de chaînes localisées pour le compte des développeurs de jeux. En outre, nous ajoutons la logique nécessaire pour fournir à vos joueurs les chaînes correspondant à leur langue préférée.

Ce tutoriel vous explique comment utiliser les modèles d'e-mail localisés. Avec les modèles d'e-mail localisés, vous pouvez créer plusieurs versions traduites d'un e-mail et les associer *toutes* à un seul ID de modèle.

<Note>
  Les modèles créés avant la publication de cette fonctionnalité conservent leur comportement. Vous pouvez toutefois les mettre à jour facilement pour utiliser le nouveau format localisé employé par les nouveaux modèles d'e-mail.
</Note>

## Configuration requise

Il s'agit d'un tutoriel *avancé*. Assurez-vous que toutes les conditions requises sont remplies, sans quoi vous ne pourrez *pas* terminer ce tutoriel.

* Pour une introduction aux modèles d'e-mail, consultez le tutoriel [Utilisation de modèles d'e-mail pour envoyer un e-mail de récupération de compte](/fr/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email).
* Consultez les informations sur l'utilisation des langues par défaut de votre titre et des langues préférées de vos joueurs dans le tutoriel [Définition des langues par défaut](/fr/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages). Une langue par défaut doit être définie pour votre titre afin de poursuivre avec les modèles d'e-mail localisés.

## Mise à jour d'un modèle d'e-mail existant

Nous allons d'abord mettre à jour le modèle d'e-mail de récupération de compte existant que nous avons créé dans le tutoriel [Utilisation de modèles d'e-mail pour envoyer un e-mail de récupération de compte](/fr/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email) mentionné ci-dessus.

1. Sélectionnez **Content** dans le menu de gauche.
2. Accédez à l'onglet **Email Templates**.
3. Passez au champ **Template name** et sélectionnez le modèle **Account Recovery**.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/game-manager-content-edit-email-template.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=3ceed3a457f45f85944bb701147296a8" alt="Game Manager : contenu, modèles d'e-mail, modifier un modèle d'e-mail" width="1366" height="1256" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/game-manager-content-edit-email-template.png" />

Pour les besoins de ce tutoriel, nous supposerons que la langue par défaut de votre titre est l'anglais. Vous constaterez que la version existante de votre modèle s'affiche comme version dans la langue par défaut.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-default-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=73a86502d9ea115d84cc067bc0de8eff" alt="Modifier un modèle d'e-mail : objet et corps, langue par défaut" width="989" height="1128" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-default-language.png" />

Pour ajouter d'autres langues, il suffit de sélectionner le lien **+ ADD LANGUAGE** fourni, de choisir la langue à ajouter au modèle, puis de saisir les chaînes localisées.

Dans cet exemple, nous allons ajouter les chaînes françaises suivantes à notre modèle existant.

Objet de l'e-mail en français :

```html theme={null}
Réinitialisation du mot de passe demandée
```

Corps de l'e-mail en français :

```html theme={null}
<head></head>
<body><p>Vous avez récemment demandé un mot de passe avec nous. </p>
<p>Cliquez <a href="$ConfirmationUrl$">ici</a> s'il vous plaît pour être dirigé vers une page pour réinitialiser votre mot de passe.
```

Voici le résultat attendu :

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-french-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=dfb61a203ed9ae23c1392bfb93c6247f" alt="Modifier un modèle d'e-mail : objet et corps, langue française" width="981" height="1759" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-template-subject-and-body-french-language.png" />

Lorsque vous sélectionnez le bouton **SAVE EMAIL TEMPLATE**, vous êtes redirigé vers la page contenant la liste de vos modèles d'e-mail.

Comme vous pouvez le constater, une nouvelle version linguistique a été ajoutée, mais aucun nouveau modèle n'a été ajouté, car toutes les versions linguistiques sont stockées sous le même ID de modèle.

## Envoi d'e-mails localisés

Nous allons ensuite envoyer notre nouvelle version localisée de l'e-mail. Comme indiqué dans le tutoriel [Définition des langues par défaut](/fr/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages), PlayFab se charge de faire correspondre les langues prises en charge par votre titre avec la langue préférée de vos joueurs. Il vous suffit de nous demander d'envoyer l'e-mail.

Pour vérifier ce comportement, créez deux joueurs de test.

Laissez l'un des nouveaux joueurs sans langue préférée. Cela montrera comment PlayFab revient à la langue par défaut du titre si aucune langue n'est spécifiée ou s'il n'y a aucune correspondance entre la langue du titre et celle du joueur.

Définissez la langue de l'*autre* nouveau joueur à l'aide de Game Manager ou de l'API [SetProfileLanguage](xref:titleid.playfabapi.com.profiles.accountmanagement.setprofilelanguage). Nous avons utilisé le français dans cet exemple.

<Note>
  Lorsque vous utilisez l'API `SetProfileLanguage`, la chaîne de langue doit être spécifiée au format ISO 639-1 (par exemple, "en", "es" ou "ja"). Actuellement, le code "zh" n'est pas pris en charge.
</Note>

Avant de passer à l'étape suivante, assurez-vous d'avoir défini l'adresse e-mail de contact des deux joueurs comme expliqué à l'[étape 2 du tutoriel Utilisation de modèles d'e-mail pour envoyer un e-mail de récupération de compte](/fr/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email#step-2---add-username-password-login-email-and-contact-email-to-a-player).

Utilisez l'API [SendCustomAccountRecoveryEmail](xref:titleid.playfabapi.com.server.accountmanagement.sendcustomaccountrecoveryemail) une fois par joueur pour envoyer ce modèle :

* Une fois en français au joueur dont la langue préférée est le français.
* Une fois dans la langue par défaut au joueur sans langue préférée définie.

Un exemple d'e-mail envoyé au joueur *sans langue préférée* est présenté ci-dessous.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-default-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=bb1e0e6cf1614c5e1cf0255ef60fea0e" alt="E-mail : réinitialisation du mot de passe, langue par défaut" width="1180" height="388" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-default-language.png" />

Un exemple d'e-mail envoyé au joueur *dont la langue préférée est le français* est présenté ci-dessous.

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-french-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=ce1d58bc1351db185ae7aaae37deba3c" alt="E-mail : réinitialisation du mot de passe, langue française" width="1185" height="390" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-french-language.png" />

## Conclusion

Comme vous pouvez le constater, PlayFab a détecté une correspondance entre la prise en charge du français par votre modèle et la préférence linguistique du joueur.

En l'*absence* de correspondance ou de préférence, le joueur a reçu les chaînes dans la langue par défaut de votre titre.

Si vous avez des questions ou des commentaires sur ce tutoriel, contactez-nous via nos [forums](https://community.playfab.com/questions/ask.html) ou notre canal Slack.


## Related topics

- [Utilisation de modèles d'e-mail pour envoyer un e-mail de récupération de compte](/fr/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email.md)
- [Utilisation d'une règle pour vérifier une adresse e-mail de contact](/fr/services/playfab/live-service-management/game-configuration/title-communications/emails/using-a-rule-to-verify-a-contact-email-address.md)
- [PFAccountManagementSendEmailFromTemplateRequest](/fr/services/playfab/api-references/c/pfaccountmanagementtypes/structs/pfaccountmanagementsendemailfromtemplaterequest.md)
- [sent_email](/fr/services/playfab/api-references/events/TitleCommunications/sent-email.md)
- [auth_token_validated](/fr/services/playfab/api-references/events/PlayerIdentity/auth-token-validated.md)
