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

# ローカライズされたメール テンプレート

> 1 つのテンプレート ID の下に複数の翻訳バージョンを持つ PlayFab メール テンプレートを作成し、プレイヤーが優先する言語でアカウント メールを受け取れるようにします。

PlayFab は、ゲーム開発者に代わってローカライズされた文字列を保存するためのサポートを導入しています。加えて、プレイヤーが希望する言語の正しい文字列を提供するのに必要なロジックを追加します。

このチュートリアルでは、ローカライズされたメール テンプレートの使用方法を説明します。ローカライズされたメール テンプレートを使用すると、メールの複数の翻訳バージョンを作成し、それらのすべてを 1 つのテンプレート ID に関連付けることができます。

<Note>
  この機能がリリースされる前に導入されたテンプレートは、その動作を保持します。ただし、新しいメール テンプレートで使用される新しいローカライズ形式を使用するように簡単に更新できます。
</Note>

## 要件

これは *上級* チュートリアルです。すべての要件が満たされていることを確認してください。満たされていない場合、このチュートリアルを完了できません。

* メール テンプレートの概要については、[メール テンプレートを使用したアカウント リカバリ メールの送信](/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email) チュートリアルを参照してください。
* タイトルの既定の言語と、プレイヤーの優先言語を扱う方法については、[既定の言語の設定](/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages) チュートリアルの情報を確認してください。ローカライズされたメール テンプレートを続行するには、タイトルの既定の言語を設定する必要があります。

## 既存のメール テンプレートの更新

最初に、上記の [メール テンプレートを使用したアカウント リカバリ メールの送信](/services/playfab/live-service-management/game-configuration/title-communications/emails/using-email-templates-to-send-an-account-recovery-email) チュートリアルで作成した既存のアカウント リカバリ メール テンプレートを更新します。

1. 左のメニューから **Content** を選択します。
2. **Email Templates** タブに移動します。
3. **Template name** フィールドに移動し、**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 - Content - Email Templates - メール テンプレートの編集" width="1366" height="1256" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/game-manager-content-edit-email-template.png" />

このチュートリアルでは、タイトルの既定の言語が英語であると仮定します。テンプレートの既存バージョンが既定の言語バージョンとして表示されます。

<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="メール テンプレートの編集 - 件名と本文 - 既定の言語" 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" />

さらに言語を追加するのは簡単で、提供される **+ ADD LANGUAGE** リンクを選択し、テンプレートに追加する言語を選択して、ローカライズされた文字列を入力するだけです。

この例では、既存のテンプレートに次のフランス語文字列を追加します。

フランス語のメール件名:

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

フランス語のメール本文:

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

以下のようになります:

<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="メール テンプレートの編集 - 件名と本文 - フランス語" 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" />

**SAVE EMAIL TEMPLATE** ボタンを選択すると、メール テンプレートのリストを含むページにリダイレクトされます。

ご覧のとおり、新しい言語バージョンが追加されましたが、すべての言語バージョンが同じテンプレート ID の下に保存されるため、新しいテンプレートは追加 *されません*。

## ローカライズされたメールの送信

次に、メールの新しくローカライズされたバージョンを送信します。[既定の言語の設定](/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages) チュートリアルで述べたように、PlayFab はタイトルのサポート言語をプレイヤーの優先言語と一致させる面倒な作業を行います。メールを送信するよう指示するだけで済みます。

この動作を確認するには、2 つのテスト プレイヤーを作成します。

新しいプレイヤーの 1 つには、優先言語を設定しないままにします。これにより、言語が指定されていない場合や、タイトルの言語とプレイヤーの言語の間に一致がない場合に、PlayFab がタイトルの既定にフォールバックする方法が示されます。

*もう一方* の新しいプレイヤーの言語を、Game Manager または [SetProfileLanguage](xref:titleid.playfabapi.com.profiles.accountmanagement.setprofilelanguage) API を使用して設定します。この例ではフランス語を使用しました。

<Note>
  `SetProfileLanguage` API を使用する場合、言語文字列は ISO 639-1 形式で指定する必要があります (たとえば、"en"、"es"、"ja")。現時点では、コード "zh" はサポートされていません。
</Note>

次の手順に進む前に、[メール テンプレートを使用したアカウント リカバリ メールの送信のステップ 2](/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) チュートリアルで説明されているように、両方のプレイヤーに連絡先メールを設定していることを確認してください。

このテンプレートを送信するには、プレイヤーごとに 1 回、[SendCustomAccountRecoveryEmail](xref:titleid.playfabapi.com.server.accountmanagement.sendcustomaccountrecoveryemail) API を使用します:

* 優先言語がフランス語のプレイヤーには、フランス語で 1 回。
* 優先言語が設定されていないプレイヤーには、既定の言語で 1 回。

*優先言語を持たない* プレイヤーへのサンプル メールを以下に示します。

<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="メール - パスワード リセット - 既定の言語" width="1180" height="388" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-default-language.png" />

*優先言語がフランス語* のプレイヤーへのサンプル メールを以下に示します。

<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="メール - パスワード リセット - フランス語" width="1185" height="390" data-path="images/playfab/live-service-management/game-configuration/title-communications/emails/tutorials/email-password-reset-french-language.png" />

## まとめ

ご覧のとおり、PlayFab はテンプレートのフランス語サポートとプレイヤーの言語設定の一致を認識しました。

一致 *しない* 場合、または優先が *ない* 場合、プレイヤーはタイトルの既定の言語文字列を受け取りました。

このチュートリアルに関するご質問やフィードバックがある場合は、[フォーラム](https://community.playfab.com/questions/ask.html) または Slack チャンネルからお問い合わせください。


## Related topics

- [ローカライズとグローバライゼーションの概要](/ja-jp/build/game-principles/localization.md)
- [プッシュ通知テンプレート](/ja-jp/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/push-notification-templates.md)
- [メール](/ja-jp/services/playfab/live-service-management/game-configuration/title-communications/emails/index.md)
- [MicrosoftGame.config のローカライズ](/ja-jp/build/core-features/common/game-config/MicrosoftGameConfig-Localization.md)
- [ディスク パッケージの要件](/ja-jp/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-disc-packaging.md)
