**サポート終了通知:** 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 は、Amazon Personalize キャンペーンとしてデプロイされ、Amazon Pinpoint が使用するように設定された推奨モデルからこれらの推奨事項を取得します。
テンプレートにメッセージ変数が含まれている場合、Amazon Pinpoint は各変数を各受信者の現在の対応する属性値に置き換えます。推奨事項については、Amazon Personalize のキャンペーンから各受信者の最新の推奨事項を取得する処理も含まれます。Amazon Pinpointは、テンプレートを使用するメッセージを送信するたびに、この処理を行います。これは、メッセージに受信者に対する最新の推奨情報が確実に含まれていることを意味します。
例えば、プロジェクトがユーザーに映画やテレビ番組を推奨するアプリケーションである場合、ユーザーごとに次の属性を設定できます。
+ ユーザーの名前。
+ ユーザーが最後に送信した評価。
+ ユーザーが最後に評価した映画または番組のタイトル。
+ モデルがユーザーに推奨するトップ 3 の映画および番組のタイトル。
このプロジェクトでは、テンプレートで次のテキスト変数とメッセージ変数を使用できます。
`Hi {{User.UserAttributes.FirstName}}, based on your recent {{User.UserAttributes.LatestRating}}-star rating for {{User.UserAttributes.LatestRatedTitle}}, we think you might also enjoy: {{RecommendationItems.[0]}}, {{RecommendationItems.[1]}}, and {{RecommendationItems.[2]}}.`
テンプレートを使用するメッセージを送信すると、Amazon Pinpoint は、各受信者の各属性の現在の値で変数を置き換えます。これを以下の例に示します。
**例 1**
`Hi Sofia, based on your recent 5-star rating for The Marvelous Mrs. Maisel – Season 3, we think you might also enjoy: Fleabag, Late Night, and Catastrophe.`
**例 2**
`Hi Alejandro, based on your recent 4-star rating for Tom Clancy's Jack Ryan – Season 2, we think you might also enjoy: Hanna, Hunters, and Agatha Christie's The ABC Murders.`
AWS Lambda 関数を使用して推奨を強化するように推奨モデルを設定した場合、テンプレートと結果のメッセージで追加の変数と推奨属性が使用されることがあります。例えば、推奨される映画や番組のイメージと URL を提供する属性の変数を使用する場合もあります。
テンプレートでのメッセージ変数の使用の詳細については、「[パーソナライズされたコンテンツをメッセージテンプレートに追加する](message-templates-personalizing.md)」を参照してください。
## メッセージへの推奨事項の追加
メッセージにパーソナライズされた推奨事項を追加するには、使用する推奨事項のメッセージ変数を含むメッセージテンプレートを作成して使用します。これらの変数は、以下のタイプのメッセージテンプレートに追加できます。
+ メールテンプレート。キャンペーンまたはジャーニーから送信する E メールメッセージ用。
+ プッシュ通知テンプレート。キャンペーンから送信するプッシュ通知用。
+ SMS テンプレート。キャンペーンから送信する SMS テキストメッセージ用。
各テンプレートでは、一度に 1 つの推奨モデルの変数と推奨属性を使用できます。
変数は、テンプレートの作成時に新しいテンプレートに追加することも、既存のテンプレートに追加することもできます。既存のテンプレートに変数を追加した場合、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. [**Attribute finder**] で、[**推奨属性**] セクションを展開します。
テンプレートに推奨モデルを選択していない場合は、[**Connect model**] を選択します。次に、テンプレートを使用するメッセージを送信するときに推奨事項を取得するモデルを選択します。次に、[**Connect model**] を選択します。
1. **[Recommended attributes]**で、メッセージ変数を追加する属性を選択します。Amazon Pinpoint は、属性のメッセージ変数を作成し、それをクリップボードにコピーします。次に、メッセージエディタで、推奨事項を表示するメッセージの場所に変数を貼り付けます。
変数を貼り付けた後、Amazon Pinpoint では、関連付けられた属性の名前として、2 組の中括弧で囲んで表示されます。たとえば、`{{RecommendationItems}}`。
1. 推奨モデルが複数の推奨属性を提供している場合は、変数を追加する追加属性ごとに上記の手順を繰り返します。
他のタイプの属性に変数を追加することもできます。これを行うには、[**Attribute finder**] で他のセクションを展開し、目的の各属性を選択し、必要な場所に変数を貼り付けます。他のタイプの属性に変数を使用する方法については、[パーソナライズされたコンテンツをメッセージテンプレートに追加する](message-templates-personalizing.md) を参照してください 。
1. メッセージ変数のデフォルト値を指定するには、[**Default attribute values**] セクションを展開します。次に、変数のリストで、変数に使用するデフォルト値を入力します。テンプレート内の各変数に対し実行することを推奨します。
1. 完了したら、次のいずれかの操作を行います。
+ 新しいテンプレートにメッセージ変数を追加した場合は、[**作成**] を選択します。
+ メッセージ変数を既存のテンプレートに追加し、変更を新しいバージョンのテンプレートとして保存する場合は、[**新しいバージョンとして保存**] を選択します。
+ メッセージ変数を既存のテンプレートに追加し、変更を最新のバージョンのテンプレートの更新として保存する場合は、[**Update version**] を選択します。このオプションは、ステップ 3 で最新バージョンのテンプレートを開いた場合にのみ選択できます。
テンプレートを使用して、キャンペーンやジャーニーから送信するメッセージにパーソナライズされた推奨事項を含めることができるようになりました。
限定された対象者にダイレクトメッセージやテストメッセージとして送信するメッセージには、推奨事項を含めることはできません。これらのメッセージではより一般的にテンプレートを使用できますが、Amazon Pinpoint では、モデルからの推奨事項をダイレクトメッセージまたはテストメッセージの受信者に関連付けることはできません。推奨事項を使用するテンプレートの外観やフォーマットをテストするには、推奨属性を参照するメッセージ変数ごとにデフォルト値を指定し、そのテンプレートを使用するテストメッセージを送信します。
## メッセージからの推奨事項の削除
メッセージからパーソナライズされた推奨事項を削除するには、メッセージが使用するメッセージテンプレートを更新します。テンプレートを更新するときに、推奨事項のすべてまたは一部のメッセージ変数を削除します。
推奨事項を削除した場合、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. [**メッセージテンプレート**] ページで、推奨事項を削除するテンプレートを選択します。次に、テンプレートページで [**Edit**] を選択します。
1. [**Template details**] で、バージョンセレクタを使用して、開始点として使用するテンプレートのバージョンを選択します。最新バージョンを選択した場合は、そのバージョンのテンプレートに変更を直接保存できます。それ以外の場合は、変更を新しいバージョンのテンプレートとして保存できます。
1. メッセージエディタで、削除する各推奨属性のメッセージ変数のテキストをすべて削除します。各メッセージ変数は、2 つの中括弧と関連する属性名 (例えば、`{{RecommendationItems}}`) で構成されています。
推奨モデルをテンプレートから完全に削除するには、モデルが提供する推奨属性のすべての変数を削除します。次に、[**Attribute finder**] で、[**Recommended attributes**] セクションを展開し、モデル名の横にある [**X**] を選択します。
1. 完了したら、次のいずれかの操作を行います。
+ 変更をテンプレートの新しいバージョンとして保存するには、[**Save as new version]**を選択します。
+ テンプレートの最新バージョンへの更新として変更を保存するには、[**Update version**] を選択します。このオプションは、ステップ 4 で最新バージョンのテンプレートを選択した場合にのみ使用できます。