> ## 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 では、単一のテンプレート ID に対して複数の言語を保存できるようにすることで、ローカライズされたプッシュ通知を簡素化します。文字列を提供していただければ、*適切な* ローカライズされたバージョンをプレイヤーに送信するための工夫は当方で提供します。

<Note>
  プッシュ通知テンプレートのサポートを追加する前は、開発者はプッシュ通知をトリガーするルールやスケジュールされたタスク内で明示的にプッシュ通知を定義することができました。これらは以前と同様に動作を続けますが、追加の言語を追加するには、テンプレートを使用する必要があります。
</Note>

このチュートリアルでは、基本的なローカライズされたプッシュ通知テンプレートを作成するために必要な手順を説明し、次にプレイヤーが指定した基準を満たしたときに自動的に送信するように PlayFab を構成する方法について説明します。

## 要件

これは上級チュートリアルです。ローカライズされた文字列を持つプッシュ通知テンプレートを作成し、次にそのテンプレートをプレイヤーに送信するようにトリガーするロジックを構成する方法に焦点を当てます。

すべての要件が満たされていることを確認してください。満たされていない場合、このチュートリアルを完了できません。このチュートリアルは、タイトルが *既にプッシュ通知を送信するように構成されている* ことを前提としています。

<Note>
  プッシュ通知の紹介と、タイトルでプッシュ通知を有効にする方法については、[プッシュ通知クイックスタート](/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/quickstart) を参照してください。[iOS](/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/push-notifications-for-ios) と [Android](/services/playfab/live-service-management/game-configuration/title-communications/push-notifications/push-notifications-for-android) の両方のポインター (高度なペイロードの構成を含む)、および Postman を使用して動作を検証する方法が含まれています。
</Note>

タイトルの既定の言語とプレイヤーの優先言語サポートを活用する方法について、[既定の言語の設定](/services/playfab/live-service-management/game-configuration/title-communications/news/setting-default-languages) チュートリアルで理解しておいてください。プッシュ通知テンプレートを続行するには、タイトルの既定の言語を設定する必要があります。

## プッシュ通知テンプレートの作成

このチュートリアルでは、離脱したプレイヤーがタイトルに戻ってきてくれることを期待して、送信する基本的なプッシュ通知を作成します。

PlayFab Game Manager で:

1. Content セクションを選択します。
2. **Push Notifications Templates** タブを選択します。
3. **New Push Notification Template** を選択します。
4. **Language (Title default)** フィールドのドロップダウン メニューを使用して、新しい言語を追加します。
5. テンプレートに追加したい言語を選択し、以下のようにローカライズされた文字列を入力します。

件名:

```html theme={null}
어서 돌아오세요
```

メッセージ:

```html theme={null}
<Profile.DisplayName>, 보고싶습니다. 다시돌아오시면 서프라이즈 선물을 받으실수있도록 준비했습니다. 다시한번 오셔서 들러보시겠습니까!
```

次の例が表示される内容です。

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/tutorials/new-push-notification-template-add-language.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=9025cb0ef1d41205047c98894ce84da7" alt="Game Manager - Content - 新しいプッシュ通知テンプレート - 言語の追加" width="1366" height="1076" data-path="images/playfab/live-service-management/game-configuration/title-communications/tutorials/new-push-notification-template-add-language.png" />

**SAVE PUSH NOTIFICATION TEMPLATE** ボタンを選択して、準備完了です!

韓国語を好むプレイヤーにこのテンプレートを送信すると通知のローカライズ版を受け取り、他のすべてのプレイヤーは既定の言語である英語のメッセージを受け取ります。

## ルール、タスク、プレイヤー セグメントを介したプッシュ通知のトリガー

シナリオの次のステップは、プレイヤーが指定された基準を満たしたときにプッシュ通知を送信するために、PlayFab のトリガー アクションを活用することです。30 日以上ゲームを訪れていないプレイヤーに戻ってきてもらいたいと考えます。

この種の基準は、離脱したプレイヤーのシナリオにはプレイヤー セグメンテーション ロジックの使用が自然に適していますが、同種のアクションはルールやスケジュールされたタスクでもトリガーできることに注意してください。どちらも Game Manager の **Automation** メニューの下にあります。プッシュ通知の送信には、CloudScript や API を使用することもできます。

プレイヤー セグメンテーションの例を続けましょう。まず、離脱したプレイヤー用のプレイヤー セグメントを設定します:

1. **Players** エリアを選択します。
2. **Segments** タブを選択し、**New Segment** を選択します。

<Note>
  「離脱」を、30 日 (43,200 分) 以上ゲームにログインしていないと定義します。
</Note>

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/tutorials/players-segments-new-segment.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=ecae3abe9fb711cd54007120c7bd77ba" alt="Game Manager - Players - Segments - 新しいセグメント" width="1800" height="969" data-path="images/playfab/live-service-management/game-configuration/title-communications/tutorials/players-segments-new-segment.png" />

この時点で **SAVE SEGMENT** ボタンを選択すると、このセグメントを使用してしばらくタイトルを訪れていないプレイヤーを識別・分析できます。プレイヤーが 29 日ログインしていない状態から 30 日になると、PlayFab はそのプレイヤーを自動的にこの **Lapsed Players** セグメントに追加します。

その後、離脱したプレイヤーが再びログインすると、PlayFab は自動的にこのセグメントから彼らを削除します。プレイヤーがこのセグメントに入ったときにプッシュ通知を送信するように PlayFab に設定しましょう:

* **Segment** タブを選択した状態で、**Save Segment** ボタンのすぐ上に表示される **ADD ACTION** を選択します。
* 次に **Type** フィールドに移動し、ドロップダウン メニューを使用して **Send push notification** を選択します。
* その横の **Push notification template** フィールドに移動し、2 番目のドロップダウン メニューから **Lapsed Players** テンプレートを選択します。

画面がどのように表示されるかの例を以下に示します。

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/tutorials/players-segments-lapsed-players.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=912eb2c3bc43cec4dc416250d4cbab79" alt="Game Manager - Players - Segments - Lapsed Players" width="1464" height="969" data-path="images/playfab/live-service-management/game-configuration/title-communications/tutorials/players-segments-lapsed-players.png" />

これで、プレイヤーが **Lapsed Players** セグメントに入ると、PlayFab はローカライズされたプッシュ通知を送信します。それだけで、プレイヤーへのプッシュ通知の送信を構成できます。

ここで、通知自体で言及した「Welcome Back」のグッズの約束を果たす方法について簡単に説明しましょう。プレイヤーがセグメントを離れたときに発火するアクションを構成することは、プレイヤーが約束したギフトを受け取ることを確実にする簡単な方法です (唯一の方法ではありません)。

このゲームでは、プレイヤーの復帰を歓迎するゲーム内体験をトリガーする CloudScript 関数を持っているので、プレイヤーに対してそれを実行し、カタログから特別なアイテムを付与したいと思います。

<img src="https://mintcdn.com/microsoft-4404708b/3hg2JQs0m7qmDqay/images/playfab/live-service-management/game-configuration/title-communications/tutorials/segment-configure-action.png?fit=max&auto=format&n=3hg2JQs0m7qmDqay&q=85&s=adc45f78988f5532237635ed7b63d23b" alt="Game Manager - Players - Segment - アクションの構成" width="1800" height="969" data-path="images/playfab/live-service-management/game-configuration/title-communications/tutorials/segment-configure-action.png" />


## Related topics

- [Content & Configuration Writes メーター API の説明](/ja-jp/services/playfab/pricing/meters/file-writes.md)
- [push_notification_sent](/ja-jp/services/playfab/api-references/events/TitleCommunications/push-notification-sent.md)
- [PlayFab リリースノート 2019](/ja-jp/services/playfab/release-notes/2019.md)
- [sent_push_notification](/ja-jp/services/playfab/api-references/events/TitleCommunications/sent-push-notification.md)
- [PFPushNotificationsSendPushNotificationFromTemplateRequest](/ja-jp/services/playfab/api-references/c/pfpushnotificationstypes/structs/pfpushnotificationssendpushnotificationfromtemplaterequest.md)
