**サポート終了通知:** 2026 年 10 月 30 日、 AWS は Amazon Pinpoint のサポートを終了します。2026 年 10 月 30 日を過ぎると、Amazon Pinpoint コンソールまたは Amazon Pinpoint のリソース (エンドポイント、セグメント、キャンペーン、ジャーニー、分析) にアクセスできなくなります。詳細については、「[Amazon Pinpoint のサポート終了](https://docs.aws.amazon.com/console/pinpoint/migration-guide)」を参照してください。**注:** SMS、音声、モバイルプッシュ、OTP、電話番号の検証に関連する APIs は、この変更の影響を受けず、 AWS エンドユーザーメッセージングでサポートされています。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# パーソナライズされたコンテンツをメッセージテンプレートに追加する
テンプレートを使用するメッセージで動的なパーソナライズされたコンテンツを配信するには、メッセージテンプレートに*メッセージ変数*を追加します。*メッセージ変数*は、お客様または Amazon Pinpoint がユーザーに関する情報の保存用に作成した特定の属性を参照する、プレースホルダーです。各属性は通常、ユーザーの名前や住んでいる都市など、ユーザーの特性に対応します。メッセージ変数をテンプレートに追加することで、これらの属性を使用して、テンプレートを使用するメッセージの各受信者にカスタムコンテンツを配信できます。
テンプレートにメッセージ変数が含まれている場合、Amazon Pinpoint は各変数を各受信者の現在の対応する属性値に置き換えます。テンプレートを使用するメッセージを送信するたびに、この処理を行います。つまり、メッセージまたはメッセージテンプレートのカスタマイズされたバージョンを複数作成することなく、各受信者にパーソナライズされたコンテンツを送信できます。また確実に、メッセージに受信者に関する最新情報を含めることができます。
例えば、プロジェクトがランナー向けのフィットネスアプリケーションであり、各ユーザーの名、優先アクティビティ、個人記録の属性が含まれている場合、テンプレートで以下のテキスト変数とメッセージ変数を使用できます。
`Hi {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!`
テンプレートを使用するメッセージを送信すると、Amazon Pinpoint は、各受信者の各属性の現在の値で変数を置き換えます。これを以下の例に示します。
**例 1**
`Hi Sofia, congratulations on your new half marathon record of 1:42:17!`
**例 2**
`Hi Alejandro, congratulations on your new 5K record of 20:52!`
受信者の属性値が存在しない場合、Amazon Pinpoint は、変数に指定されたデフォルト値で変数を置き換えることができます。例えば、フィットネスアプリケーションのユーザーが優先アクティビティを選択しなかった場合、`running` 変数のデフォルト値として `{{User.UserAttributes.Activity}}` を使用できます。この場合、Amazon Pinpoint は以下の例に示すように変数を置き換えます。
**例 1**
`Hi Jane, congratulations on your new running record of 1:42:17!`
**例 2**
`Hi John, congratulations on your new running record of 20:52!`
デフォルト値を指定せず、受信者の値が存在しない場合、メッセージをその受信者に送信する際に Amazon Pinpoint は変数のすべてのテキストを省略します。例:
`Hi Mary, congratulations on your new record of 20:52!`
ベストプラクティスとして、テンプレートに含める各変数のデフォルト値を指定することをお勧めします。
## メッセージ変数の追加
メッセージ属性は、テンプレートの作成時に新しいテンプレートに追加することも、既存のテンプレートに追加することもできます。既存のテンプレートに変数を追加した場合、Amazon Pinpoint は、テンプレートを使用する未送信のメッセージ（後で送信されるようにスケジュールされているキャンペーンメッセージなど）に必ずしも変更を適用しません。これは、変数を追加するテンプレートのバージョンと、テンプレートを使用するメッセージの設定方法によって異なります。詳細については、「[メッセージテンプレートのバージョンの管理](message-templates-versioning.md)」を参照してください。
**注記**
アプリ内メッセージングテンプレートは、メッセージ変数の使用をサポートしていません。
**メッセージ変数をメッセージテンプレートに追加するには**
1. Amazon Pinpoint コンソール ([https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)) を開きます。
1. ナビゲーションペインで、[**Message templates**] を選択します。
1. [**Message templates**] ページで、以下のいずれかを実行します。
+ 新しいテンプレートを作成してメッセージ変数を追加するには、[**Create template**] を選択します。次に、テンプレートページで、テンプレートの名前と、オプションでテンプレートの説明を入力します。
+ メッセージ変数を既存のテンプレートに追加するには、変数を追加するテンプレートを選択します。次に、テンプレートページで [**Edit**] を選択します。[**Template details**] で、バージョンセレクタを使用して、開始点として使用するテンプレートのバージョンを選択します。最新バージョンを選択した場合は、そのバージョンのテンプレートに変更を直接保存できます。それ以外の場合は、変更を新しいバージョンのテンプレートとして保存できます。
1. メッセージの詳細セクションで、メッセージ変数を追加する場所を決定します。任意のタイプのテンプレートの本文に変数を追加できます。E メールおよびプッシュ通知テンプレートの場合、メッセージの件名またはタイトルにも変数を追加できます。
1. [**Attribute finder**] で、メッセージ変数を追加する属性のタイプのセクションを展開します。次のタイプの属性から選択できます。
**標準属性**
これは、Amazon Pinpoint がすべてのプロジェクトに自動的に作成する属性です。つまり、どのプロジェクトに送信するメッセージでも使用できます。これらの各属性の詳細については、[サポートされている 属性](#message-templates-variables) を参照してください。
標準属性の変数を追加するには、リストから属性を選択します。
**カスタム属性**
これは、必要に応じて個々のプロジェクト用に作成できる属性です。一部のプロジェクトではこれらの属性を使用できない可能性があるため、Amazon Pinpoint では、テンプレートを使用するメッセージのすべての受信者に対して変数を値に置き換えられない場合があります。この問題を回避するために、Amazon Pinpoint には、特定のプロジェクトまたはすべてのプロジェクトのために存在する属性を選択するためのオプションが用意されています。
カスタム属性を追加するには
1. [**Custom attributes**] を選択し、［**Load custom attributes**］を選択します。表示されたウィンドウには、Amazon Pinpoint が作成したすべてのプロジェクトを一覧表示します。各プロジェクトを選択すると、選択したプロジェクトに共通する属性が右側のナビゲーションペインに表示されます。属性が表示されない場合は、それらのプロジェクト間に共通の属性はありません。
1. 次のいずれかを行います。
+ 選択したプロジェクトに共通するすべての属性を使用するには、[**Load custom attributes**] を選択します。
+ リストから特定の属性を使用する場合は、属性名の一部分を検索フィールドに入力します。入力した文字列と一致する属性が表示されます。使用したい属性が表示されたら、[**Load custom attributes**] を選択します。[**Attribute finder**] は、新しく追加されたカスタム属性を表示します。
**注記**
異なるプロジェクトのセットから共通の属性を追加したり、**[属性ファインダー]** の **[カスタム属性]** セクションを変更したりすることはできません。カスタム属性を変更する場合は、**[X]** を選択して **[属性ファインダー]** をクリアしてから、もう一度やり直してください。
1. [**Attribute finder**] で、変数を追加する属性を選択します。
**Recommended attributes**
これは、推奨モデルからパーソナライズされた推奨事項を取得するように Amazon Pinpoint を設定するときに、オプションでアカウント用に作成する属性です。推奨モデルの使用方法については、「[機械学習モデル](ml-models.md)」を参照してください。このタイプの属性の変数は、メールテンプレート、プッシュ通知テンプレート、および SMS テンプレートに追加できます。音声テンプレートには追加できません。
推奨属性の変数を追加するには、リストから属性を選択します。**[属性ファインダー]** に推奨属性が表示されない場合は、まずテンプレートを推奨モデルに接続する必要があります。
推奨属性を追加するには、次の手順で行います。
1. 次に、[**Connect model**] を選択します。
1. 次に、テンプレートを使用するメッセージを送信するときに推奨事項を取得するモデルを選択します。
1. 次に、[**Connect model**] を選択します。
1. [**Attribute finder**] から属性を選択すると、Amazon Pinpoint によって属性のメッセージ変数が作成され、クリップボードにコピーされます。目的の場所に変数を貼り付けます。属性のリストが長い場合は、検索テキストを入力してリストを絞り込みます。[**X**] を選択して、検索フィールドをクリアします。
変数を貼り付けた後、Amazon Pinpointは、関連付けられた属性の名前として、2 組の中括弧で囲んで表示します。例えば、`{{User.UserAttributes.FirstName}}`。
1. 追加するメッセージ変数ごとに、ステップ 4～6 を繰り返します。
1. メッセージ変数のデフォルト値を指定するには、[**Default attribute values**] セクションを展開します。次に、変数のリストで、変数に使用するデフォルト値を入力します。
**注記**
テンプレート内の各変数に対し実行することを推奨します。そうしないと、Amazon Pinpoint がテンプレートを使用するメッセージを送信できない場合や、メッセージが予期しない方法や望ましくない方法で表示される場合があります。
1. 完了したら、次のいずれかの操作を行います。
+ 新しいテンプレートにメッセージ変数を追加した場合は、[**作成**] を選択します。
+ メッセージ変数を既存のテンプレートに追加し、変更を新しいバージョンのテンプレートとして保存する場合は、[**新しいバージョンとして保存**] を選択します。
+ メッセージ変数を既存のテンプレートに追加し、変更を最新のバージョンのテンプレートの更新として保存する場合は、[**Update version**] を選択します。このオプションは、ステップ 3 で最新バージョンのテンプレートを開いた場合にのみ選択できます。
## サポートされている 属性
各プロジェクトに、標準属性とカスタム属性を設定できます。標準属性は、Amazon Pinpoint がすべてのプロジェクトに自動的に作成する属性です。カスタム属性は、プロジェクトに対してオプションで作成する属性です。カスタム属性には 3 つのタイプがあります。
+ [**ユーザー属性**] – これらの属性は、ユーザーの名、姓、生年月日など、ユーザーを定義します。*ユーザー*は、プロジェクトの一意のユーザー ID を持つ個人です。
+ [**エンドポイント属性**] - これらの属性は、ユーザーの特定のエンドポイントを定義します。*エンドポイント*は、E メールアドレス、電話番号、携帯端末など、メッセージの送信先を表します。各ユーザーは、1 つ以上のエンドポイントに関連付けることができます。例えば、あるユーザーと E メール、SMS、電話で連絡を取る場合、ユーザーの E メールアドレス、携帯電話番号、自宅(固定電話) の電話番号の 3 つのエンドポイントに関連付けることができます。
+ [**メトリクス属性**] – これらの属性は、モバイルアプリケーションのセッション数やカートに残っているアイテムの数など、アプリケーションが個々のエンドポイントについて Amazon Pinpoint にレポートする数値メトリクスです。
+ **Pinpoint 属性** – これらの属性は、アプリケーション、キャンペーン、またはジャーニーの一意の識別子です。
Amazon Pinpoint では、ユーザーまたは Amazon Pinpoint がプロジェクト用に作成するカスタム属性と標準属性に加えて、*推奨属性*がサポートされます。*推奨属性*とは、ユーザーやエンドポイントに対してパーソナライズされた推奨事項を一時的に保存するための属性です。Amazon Pinpoint は、お客様が設定した推奨モデルから、これらのレコメンダーを取得します。推奨属性は、特定のプロジェクトに関連付けられません。代わりに、Amazon Pinpoint アカウントに関連付けられます。推奨モデルの使用方法については、「[機械学習モデル](ml-models.md)」を参照してください。
メッセージ変数には、標準属性、カスタム属性、または推奨属性を使用できます。以下の表では、サポートされている属性ごとにメッセージ変数に表示されるテキストを示し、各属性について説明しています。この表の {{custom\_attribute}} は、カスタム属性の変数に表示されるテキストを示します。このような場合は、{{custom\_attribute}} をカスタム属性の名前に置き換えます。例えば、プロジェクトで `FirstName` という名前のカスタムユーザー属性にユーザーの名を保存し、その属性の変数を追加すると、変数のテキストは `{{User.UserAttributes.FirstName}}` になります。
| 属性 | 説明 |
| --- | --- |
| Address | エンドポイントに送信するメッセージやプッシュ通知の宛先アドレス (E メールアドレス、電話番号、デバイストークンなど)。 |
| Pinpoint.ApplicationId | アプリケーションの一意の識別子。 |
| Attributes.{{custom\_attribute}} | エンドポイントを説明するカスタムエンドポイント属性。 |
| Pinpoint.CampaignId | キャンペーンの一意の識別子。 |
| ChannelType | メッセージまたはプッシュ通知をエンドポイントに送信するときに使用するチャンネル。例:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/userguide/message-templates-personalizing.html) |
| CreationDate | エンドポイントがプロジェクトに追加された日付と時刻 ([ISO 8601 形式](https://en.wikipedia.org/wiki/ISO_8601))。例えば、2019 年 6 月 30 日午前 11 時 45 分（UTC）の場合は、2019-06-30T11:45:25.220Z と指定します。 |
| Demographic.AppVersion | エンドポイントに関連付けられているアプリケーションのバージョン番号。 |
| Demographic.Locale | 次の形式のエンドポイントのロケール。[ISO 639-1 alpha-2](https://en.wikipedia.org/wiki/ISO_639-1) コード、その後に下線 (\_)、その後に [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) 値。例えば、en\_US は米国の英語ロケールです。 |
| Demographic.Make | エンドポイントデバイスの製造元 (apple、samsung など)。 |
| Demographic.Model | iPhone や SM-G900F など、エンドポイントのデバイスのモデル名または番号。 |
| Demographic.ModelVersion | エンドポイントデバイスのモデルバージョン。 |
| Demographic.Platform | エンドポイントのデバイス上のオペレーティングシステム (ios、android など)。 |
| Demographic.PlatformVersion | エンドポイントのデバイス上のオペレーティングシステムのバージョン。 |
| Demographic.Timezone | [tz データベース値](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)としてのエンドポイントのタイムゾーン。例えば、太平洋標準時 (北米) の America/Los\_Angeles。 |
| EffectiveDate | エンドポイントが最後に更新された日付と時刻 ([ISO 8601 形式](https://en.wikipedia.org/wiki/ISO_8601))。例えば、2019 年 8 月 23 日午前 10 時 54 分（UTC）の場合は、2019-08-23T10:54:35.220Z と指定します。 |
| EndpointId | エンドポイントの一意の識別子。 |
| EndpointStatus | エンドポイントにメッセージを送信するか、通知をプッシュするか: ACTIVE では、エンドポイントにメッセージを送信します。INACTIVE では、エンドポイントにメッセージを送信しません。 |
| Id | エンドポイントの一意の識別子。 |
| Pinpoint.JourneyId | ジャーニーの一意の識別子。 |
| Location.City | エンドポイントが配置されている市。 |
| Location.Country | エンドポイントが配置されている国またはリージョンの 2 文字のコード ([ISO 3166-1 alpha-2 形式](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2))。例えば、米国の場合は US です。 |
| Location.Latitude | 小数点以下 1 桁に丸められた、エンドポイントの場所の緯度座標。 |
| Location.Longitude | 小数点以下 1 桁に丸められた、エンドポイントの場所の経度座標。 |
| Location.PostalCode | エンドポイントが配置されているエリアの郵便番号。 |
| Location.Region | エンドポイントが配置されている都道府県などのリージョンの名前。 |
| Metrics.{{custom\_attribute}} | アプリケーションがエンドポイントの Amazon Pinpoint にレポートするカスタムの数値メトリクス。 |
| OptOut | ユーザーがお客様からのメッセージとプッシュ通知の受信をオプトアウトしたかどうか: ALL では、ユーザーはオプトアウトし、メッセージまたはプッシュ通知の受信を希望しません。または、NONE では、ユーザーはオプトアウトせず、すべてのメッセージとプッシュ通知の受信を希望します。 |
| RecommendationItems | エンドポイントまたはユーザーの 1 つの推奨事項を保存する標準の推奨属性。この属性には、推奨モデルによって直接提供されるテキストが含まれます。 |
| RecommendationItems.[\#] | エンドポイントまたはユーザーに対する 2～5 の推奨事項の順序付きリストを保存する標準の推奨属性です。この属性には、推奨モデルによって直接提供されるテキストが含まれます。
数値のプレースホルダ (.[\#]) は、属性に複数の値が含まれていることを示します。この属性のメッセージ変数は、リスト内の特定の値を参照できます。 |
| Recommendations.{{custom\_attribute}} | エンドポイントまたはユーザーの 1 つの推奨事項を保存するカスタム推奨属性。この属性には、レコメンダーモデルによって提供され、 AWS Lambda 関数によって拡張されたコンテンツが含まれています。 |
| Recommendations.{{custom\_attribute}}.[\#] | エンドポイントまたはユーザーの複数の推奨事項を保存するカスタム推奨属性。この属性には、推奨モデルによって提供され、 AWS Lambda 関数によって強化されるコンテンツが含まれます。
数値のプレースホルダ (.[\#]) は、属性に複数の値が含まれていることを示します。この属性のメッセージ変数は、これらの値のいずれかを具体的に参照できます。 |
| RequestId | エンドポイントを更新するための最新のリクエストの一意の識別子。 |
| User.UserAttributes.{{custom\_attribute}} | ユーザーを説明するカスタムユーザー属性。 |
| User.UserId | ユーザー用の一意の識別子 |