> ## 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 de courriel localisés

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

PlayFab introduit la prise en charge de le 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 de courriel localisés. Avec les modèles de courriel localisés, vous pouvez créer plusieurs versions traduites d'un courriel 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 de courriel.
</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 de courriel, consultez le tutoriel [Utilisation de modèles de courriel pour envoyer un courriel de récupération de compte](/fr-CA/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-CA/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 de courriel localisés.

## Mise à jour d'un modèle de courriel existant

Nous allons d'abord mettre à jour le modèle de courriel de récupération de compte existant que nous avons créé dans le tutoriel [Utilisation de modèles de courriel pour envoyer un courriel de récupération de compte](/fr-CA/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 **Courriel 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 de courriel, modifier un modèle de courriel" 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 de courriel : 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 du courriel en français :

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

Corps du courriel 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 de courriel : 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 Courriel TEMPLATE**, vous êtes redirigé vers la page contenant la liste de vos modèles de courriel.

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 de courriels localisés

Nous allons ensuite envoyer notre nouvelle version localisée du courriel. Comme indiqué dans le tutoriel [Définition des langues par défaut](/fr-CA/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 le courriel.

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 (p. ex., "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 courriel de contact des deux joueurs comme expliqué à l'[étape 2 du tutoriel Utilisation de modèles de courriel pour envoyer un courriel de récupération de compte](/fr-CA/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 de courriel 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="Courriel : 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 de courriel 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="Courriel : 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 au moyen de nos [forums](https://community.playfab.com/questions/ask.html) ou notre canal Slack.


## Related topics

- [Utilisation de modèles de courriel pour envoyer un courriel de récupération de compte](/fr-CA/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 courriel de contact](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/emails/using-a-rule-to-verify-a-contact-email-address.md)
- [Modèles de projet dans Visual Studio pour le développement de jeux sur PC](/fr-CA/tools/tools-pc/visualstudio/gr-vs-templates.md)
- [Courriels](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/emails/index.md)
- [Démarrage rapide de la messagerie par courriel](/fr-CA/services/playfab/live-service-management/game-configuration/title-communications/emails/quickstart.md)
