パーソナライズされたコンテンツをメッセージテンプレートに追加する - Amazon Pinpoint

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

パーソナライズされたコンテンツをメッセージテンプレートに追加する

テンプレートを使用するメッセージで動的なパーソナライズされたコンテンツを配信するには、メッセージテンプレートにメッセージ変数を追加します。Aメッセージ変数は、お客様または 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 は、変数に指定したデフォルト値で変数を置き換えることができます。たとえば、フィットネスアプリケーションのユーザーが優先アクティビティを選択しなかった場合、{{User.UserAttributes.Activity}} 変数のデフォルト値として running を使用できます。この場合、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 は、テンプレートを使用する既存の未送信のメッセージ(後で送信されるようにスケジュールされているキャンペーンメッセージなど)に必ずしも変更を適用しません。これは、変数を追加するテンプレートのバージョンと、テンプレートを使用するメッセージの設定方法によって異なります。詳細については、「メッセージテンプレートのバージョンの管理」を参照してください。

メッセージ変数をメッセージテンプレートに追加するには

  1. Amazon Pinpoint コンソールを開きます。https://console.aws.amazon.com/pinpoint/

  2. ナビゲーションペインで、[Message templates (メッセージテンプレート)] を選択します。

  3. [Message templates (メッセージテンプレート)] ページで、以下のいずれかを実行します。

    • 新しいテンプレートを作成してメッセージ変数を追加するには、[Create template (テンプレートの作成)] を選択します。次に、テンプレートページで、テンプレートの名前と、オプションでテンプレートの説明を入力します。

    • メッセージ変数を既存のテンプレートに追加するには、変数を追加するテンプレートを選択します。次に、テンプレートページで [Edit (編集)] を選択します。[Template details (テンプレートの詳細)] で、バージョンセレクタを使用して、開始点として使用するテンプレートのバージョンを選択します。最新バージョンを選択した場合は、そのバージョンのテンプレートに変更を直接保存できます。それ以外の場合は、変更を新しいバージョンのテンプレートとして保存できます。

  4. メッセージの詳細セクションで、メッセージ変数を追加する場所を決定します。任意のタイプのテンプレートの本文に変数を追加できます。E メールおよびプッシュ通知テンプレートの場合、メッセージの件名またはタイトルにも変数を追加できます。

  5. [Attribute finder (属性ファインダー)] で、メッセージ変数を追加する属性のタイプのセクションを展開します。次のタイプの属性から選択できます。

    標準属性

    これは、Amazon Pinpoint がすべてのプロジェクトに自動的に作成する属性です。つまり、どのプロジェクトに送信するメッセージでも使用できます。これらの各属性の詳細については、サポートされている属性 を参照してください。

    標準属性の変数を追加するには、リストから属性を選択します。

    カスタム属性

    これは、必要に応じて個々のプロジェクト用に作成する属性です。一部のプロジェクトではこれらの属性を使用できない可能性があるため、Amazon Pinpoint では、テンプレートを使用するメッセージの各受信者に対して変数を値に置き換えられない場合があります。この問題を回避するために、Amazon Pinpoint には、特定のプロジェクトまたはすべてのプロジェクトに存在する属性を選択するためのオプションが用意されています。

    カスタム属性を追加するには:

    1. 選択カスタム属性] を選択してから、[カスタム属性をロードする。表示されるウィンドウに、Amazon Pinpoint に作成したすべてのプロジェクトが一覧表示されます。各プロジェクトを選択すると、選択したプロジェクトに共通の属性が右側のナビゲーションウィンドウに表示されます。属性が表示されない場合、それらのプロジェクト間に共通の属性はありません。

    2. 次のいずれかを行ってください。

      • 選択したプロジェクトに共通するすべての属性を使用するには、カスタム属性をロードする

      • リストから特定の属性を使用する場合は、属性名の任意の部分を検索フィールドに入力します。入力したテキストに一致する属性が表示されます。選択カスタム属性をロードするを使用すると、使用する属性が表示されます。属性ファインダーに、新しく追加されたカスタムアトリビュートが表示されます。

        注記

        異なるプロジェクトセットから共通の属性を追加したり、カスタム属性の セクション属性ファインダー。カスタム属性を変更する必要がある場合は、X[] をクリックして、属性ファインダーし、もう一度開始します。

    3. [Attribute finder (属性ファインダー)] で、変数を追加する属性を選択します。

    [Recommended attributes (推奨属性)]

    これは、推奨モデルからパーソナライズされた推奨事項を取得するように Amazon Pinpoint を設定するときに、オプションでアカウント用に作成する属性です。推奨モデルの使用方法については、「機械学習モデル」を参照してください。このタイプの属性の変数は、メールテンプレート、プッシュ通知テンプレート、および SMS テンプレートに追加できます。音声テンプレートには追加できません。

    推奨属性の変数を追加するには、リストから属性を選択します。[Attribute finder (属性ファインダー)] に推奨属性が表示されない場合は、まずテンプレートを推奨モデルに接続する必要があります。

    推奨属性を追加するには、次の手順に従います。

    1. 選択モデルのConnect

    2. テンプレートを使用するメッセージを送信するときに、推奨事項を取得するモデルを選択します。

    3. 選択モデルのConnect

  6. 属性を属性ファインダー場合、Amazon Pinpoint は、属性のメッセージ変数を作成し、クリップボードにコピーします。目的の場所に変数を貼り付けます。属性のリストが長い場合は、検索テキストを入力してリストを絞り込みます。選択X検索フィールドを消去します。

    変数を貼り付けると、Amazon Pinpoint では、関連付けられた属性の名前として 2 つの中括弧で囲んで表示されます。たとえば、{{User.UserAttributes.FirstName}}

  7. 追加するメッセージ変数ごとに、手順 4~6 を繰り返します。

  8. メッセージ変数のデフォルト値を指定するには、[Default attribute values (既定の属性値)] セクションを展開します。次に、変数のリストで、変数に使用するデフォルト値を入力します。

    注記

    テンプレート内の各変数に対し実行することを推奨します。そうしないと、Amazon Pinpoint がテンプレートを使用するメッセージを送信できない場合や、メッセージが予期しない方法や望ましくない方法で表示される場合があります。

  9. 完了したら、次のいずれかの操作を行います。

    • 新しいテンプレートにメッセージ変数を追加した場合は、[作成] を選択します。

    • メッセージ変数を既存のテンプレートに追加し、変更を新しいバージョンのテンプレートとして保存する場合は、[新しいバージョンとして保存] を選択します。

    • メッセージ変数を既存のテンプレートに追加し、変更を最新のバージョンのテンプレートの更新として保存する場合は、[Update version (バージョンを更新)] を選択します。このオプションは、ステップ 3 で最新バージョンのテンプレートを開いた場合にのみ選択できます。

サポートされている属性

各プロジェクトに、標準属性とカスタム属性を設定できます。標準属性は、Amazon Pinpoint がすべてのプロジェクトに自動的に作成する属性です。カスタム属性は、プロジェクトに対してオプションで作成する属性です。カスタム属性には 3 つのタイプがあります。

  • ユーザー属性— これらの属性は、ユーザーの名、姓、生年月日など、ユーザーを表します。ユーザーは、プロジェクトの一意のユーザー ID を持つ個人です。

  • エンドポイント属性— これらの属性は、ユーザーの特定のエンドポイントを表します。あんエンドポイントは、メッセージを送信できる宛先 (E メールアドレス、電話番号、モバイルデバイスなど)。各ユーザーは、1 つ以上のエンドポイントに関連付けることができます。たとえば、電子メール、SMS、および電話でユーザと通信する場合、ユーザは 3 つのエンドポイントに関連付けることができます。1 つはユーザの電子メールアドレス、もう 1 つはユーザの携帯電話番号、もう 1 つはユーザの自宅(固定電話)電話番号です。

  • メトリクス属性— これらの属性は、アプリケーションが個々のエンドポイントについて Amazon Pinpoint にレポートする数値メトリクスです。モバイルアプリのセッション数やカートに残っている商品数など。

Amazon Pinpoint は、お客様または Amazon Pinpoint がお客様のプロジェクトに作成するカスタム属性と標準属性に加えて、推奨属性。A推奨属性は、ユーザーまたはエンドポイントに対するパーソナライズされた推奨事項を一時的に保存する属性です。Amazon Pinpoint は、使用するように設定した推奨モデルからこれらの推奨事項を取得します。推奨属性は、特定のプロジェクトに関連付けられません。代わりに、Amazon Pinpoint アカウントに関連付けられます。推奨モデルの使用方法については、「機械学習モデル」を参照してください。

メッセージ変数には、標準属性、カスタム属性、または推奨属性を使用できます。以下の表では、サポートされている属性ごとにメッセージ変数に表示されるテキストを示し、各属性について説明しています。この表の custom_attribute は、カスタム属性の変数に表示されるテキストを示します。このような場合は、custom_attribute をカスタム属性の名前に置き換えます。たとえば、プロジェクトで FirstName という名前のカスタムユーザー属性にユーザーの名を保存し、その属性の変数を追加すると、変数のテキストは {{User.UserAttributes.FirstName}} になります。

属性 説明
Address エンドポイントに送信するメッセージまたはプッシュ通知の宛先アドレス(電子メールアドレス、電話番号、デバイストークンなど)。
Attributes.custom_attribute エンドポイントを説明するカスタムエンドポイント属性。
ChannelType メッセージまたはプッシュ通知をエンドポイントに送信するときに使用するチャネル。次に例を示します。
  • APNS— iOS デバイスで実行されているアプリに Apple Push Notification Service (APN) チャネルを介して送信するプッシュ通知を、エンドポイントが受信できる場合。

  • EMAIL— E メールメッセージを受信できるエンドポイントの場合。

  • GCM— Firebase Cloud Messaging (FCM) チャネルを介して Android デバイスで実行されているアプリに送信するプッシュ通知を、エンドポイントが受信できる場合。

  • SMS— SMS テキストメッセージを受信できるエンドポイントの場合。

  • VOICE— 音声メッセージを受信できるエンドポイントの場合。

CreationDate エンドポイントがプロジェクトに追加された日付と時刻 (ISO 8601 形式)。たとえば、2019 年 6 月 30 日午前 11 時 45 分(UTC)の場合は、2019-06-30T11:45:25.220Z と指定します。
Demographic.AppVersion エンドポイントに関連付けられているアプリケーションのバージョン番号。
Demographic.Locale 次の形式のエンドポイントのロケール。ISO 639-1 alpha-2 コード、その後に下線 (_)、その後に ISO 3166-1 alpha-2 値。たとえば、en_US は米国の英語ロケールです。
Demographic.Make エンドポイントデバイスの製造元 (applesamsung など)。
Demographic.Model iPhoneSM-G900F など、エンドポイントのデバイスのモデル名または番号。
Demographic.ModelVersion エンドポイントデバイスのモデルバージョン。
Demographic.Platform エンドポイントのデバイス上のオペレーティングシステム (iosandroid など)。
Demographic.PlatformVersion エンドポイントのデバイス上のオペレーティングシステムのバージョン。
Demographic.Timezone tz データベース値としてのエンドポイントのタイムゾーン。たとえば、太平洋標準時 (北米) の America/Los_Angeles
EffectiveDate エンドポイントが最後に更新された日付と時刻 (ISO 8601 形式)。たとえば、2019 年 8 月 23 日午前 10 時 54 分(UTC)の場合は、2019-08-23T10:54:35.220Z と指定します。
EndpointStatus エンドポイントにメッセージを送信するか、通知をプッシュするか: ACTIVE では、エンドポイントにメッセージを送信します。INACTIVE では、エンドポイントにメッセージを送信しません。
Id エンドポイントの一意の識別子。
Location.City エンドポイントが配置されている市。
Location.Country エンドポイントが配置されている国またはリージョンの 2 文字のコード (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 ユーザー用の一意の識別子