次の方法で共有

メール テンプレートのローカライズ

  • [アーティクル]

PlayFab は、ゲーム デベロッパーに代わってローカライズされた文字列を格納するためのサポートを開始しました。 さらに、希望する言語の正しい文字列でプレイヤーを提供するために必要なロジックを追加しました。

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

注意

この機能がリリースされる前に導入されたテンプレートについては、その動作に影響はありません。 ただし、新しいメール テンプレートを使用する、新しいローカライズされた形式を使うよう、簡単に更新できます。

要件

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

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

最初にすべきことは、メール テンプレートを使用したアカウント回復メールの送信 チュートリアルで作成した、既存アカウントの回復メール テンプレートの更新です。

  1. 左側のメニューの [コンテンツ] を選択します。
  2. [メール テンプレート] タブに移動します。
  3. [テンプレート名] フィールドに移動し、アカウントの回復テンプレートを選択します。

ゲーム マネージャー - コンテンツ - メール テンプレート - メール テンプレートの編集

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

メール テンプレートの編集 - 件名と本文 - 既定の言語

言語を追加するには、[言語の追加] リンクを選択し、テンプレートに追加する言語を選択して、ローカライズされた文字列を入力するだけです。

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

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

Réinitialisation du mot de passe demandée

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

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

次のように表示されます。

メール テンプレートの編集 - 件名と本文 - フランス語

[メール テンプレートの保存] ボタンを選択する場合、メール テンプレートの一覧のあるページに戻されます。

お分かりのように、新しい言語バージョンは追加されましたが、新しいテンプレートは追加されて いません。同じテンプレート ID の下にすべての言語バージョンが格納されているためです。

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

次に、新しいローカライズされたバージョンのメールを送信します。 既定の言語の設定チュートリアルで説明したように、PlayFab は複雑な作業を行って、タイトルのサポートする言語とプレイヤーに適した言語を一致させます。 必要なのは、メールを送信すると知らせることだけです。

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

新しいプレイヤーの内の 1 つは、適切な言語がないままにします。 言語が指定されていない場合や、タイトルの言語とプレイヤーの言語が一致しない場合に、PlayFab がどうやってタイトルの既定の言語に戻るのか説明します。

ゲーム マネージャーか、SetProfileLanguage API を使用して、もう 1 つ の新しいプレイヤーの言語を設定します。 この例では、フランス語を使用しています。

注意

SetProfileLanguage API を使用する場合、言語文字列は ISO 639-1 形式 ("en"、"es"、"ja" など) で指定する必要があります。 現在、コード "zh" はサポートされていません。

メール テンプレートを使用したアカウント回復メールの送信の手順 2 チュートリアルで説明したように、両方のプレイヤーの連絡先メールを設定し、次の手順に進みます。

SendCustomAccountRecoveryEmail API を使用して、各プレイヤーに1回ずつ、このテンプレートを送信します。

  • 優先言語をフランス語としたプレイヤーに、フランス語で 1 回送信しました。
  • 優先言語を設定していないプレイヤーには、既定の言語で 1 回送信しました。

優先言語なし としたプレイヤーに送信したサンプル メールを次に示します。

メール - パスワードのリセット - 既定の言語

優先言語をフランス語としたプレイヤーに送信したサンプル メールを次に示します。

メール - パスワードのリセット - フランス語

まとめ

PlayFab では、テンプレートがフランス語をサポートしていることと、プレイヤーの優先言語の間で一致していることがわかりました。

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

このチュートリアルに関するご質問やフィードバックがある場合は、フォーラムまたはスラック チャネルを利用してご連絡ください。