Did you find this helpful?
Localized Email Templates
PlayFab is introducing the support for storing localized strings on behalf of game developers. We are also adding the necessary logic to provide your players with the correct strings for the language they prefer. The first feature using this new behavior is localized email templates. Now, you can make multiple translated versions of an email and associate all of them with one template id. Any templates that already existed before the release of this feature will continue to behave as they had before; however, you can easily update them to use the new localized format used by new email templates.
This tutorial walks you through how to use localized email templates.
This is an advanced tutorial. Please make sure that all requirements have been met or you will not be able to complete this tutorial.
- For an introduction to email templates, refer to the Using Email Templates to Send an Account Recovery Email tutorial
- Please read up on how to work with default languages on your title and preferred languages for your players in the Setting Default Languages tutorial. You must have a title default language set to continue with localized email templates.
Updating an existing email template
The first thing we will do is update the existing account recovery email template we made in the tutorial mentioned above. Go to Content -> Email Templates and click on the “PasswordRecoveryTemplate”.
For the purposes of this tutorial, we will assume your title’s default language is English. You’ll see that your existing version of the template shows up as the default language version.
Adding more languages is as simple as clicking on “add language”, choosing the language you want to add to the template, and then typing in the localized strings. In this example, we're going to add the following French strings to our existing template.
French email subject:
Réinitialisation du mot de passe demandée
French email body:
<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.
Here's what it should look like:
When you click SAVE EMAIL TEMPLATE, you will be redirected back to the page containing the list of your email templates. As you can see, a new template was not added, since all language versions are stored under the same id.
Sending localized emails
Next, we will send our new localized version of the email. As was mentioned in the Setting Default Languages tutorial, PlayFab does the heavy lifting to match your title's supported languages with your players' preferred language. All you need to do is tell us to send the email.
To verify this behavior, create two test players. Leave one of the new players without a preferred language--this will demonstrate how PlayFab falls back to the title's default if there is no language specified (or if there is no match between the title language and the player's language). For the other new player, set their language by using Game Manager or by using the SetProfileLanguage API. We have used French in this example.
Make sure you have set the contact email on both players as explained in step 2 of the Send an Account Recovery Email tutorial before continuing on to the next step.
Use the SendCustomAccountRecoveryEmail API once per player to send this template: once in French to the player whose preferred language is French, and once in the default language to a player with no preferred language set.
Email to the player with no preferred language:
Email to the player whose preferred language is French:
As you can see, PlayFab noticed there was a match between your template's support for French and the player's language preference. Where there was no match or no preference, the player received your title's default language strings. If you have any questions or feedback on this tutorial, please contact us through our forums or slack channel.