動的フラグメントの使用 dynamic-fragments

このページ：​送信時に渡されるプロファイル属性、データセット参照、コンテキストデータに基づいて、Adobe Journey Optimizer で動的フラグメント解決を使用して、実行時にメッセージに挿入される公開済みフラグメントを選択する方法について説明します。

Adobe Journey Optimizer は、実行時の​ 動的フラグメント解決 ​をサポートしています。これにより、送信時に渡されるプロファイル属性、データセット参照、コンテキストデータに基づいて、メッセージに挿入する公開済みフラグメントを選択できます。 その結果、キャンペーンやジャーニーのロジックを複製することなく、高度にパーソナライズされたコンテンツを提供できます。

概要 overview

静的フラグメント​は、デザイン時にメッセージに埋め込まれ、すべての受信者に対して同じフラグメントが使用されます。 動的フラグメント​は、受信者ごとに実行時にフラグメント ID を解決します。つまり、同じキャンペーンやジャーニー内であっても、プロファイルによってまったく異なるコンテンツブロックを受信できます。

動的フラグメント ID は、次の 3 つのソースから取得できます。

前提条件 prerequisites

動的フラグメントを使用する前に、次の前提条件が満たされていることを確認してください。

手順 1：フラグメントを作成して公開 create-fragment

フラグメントを動的に参照する前に、Journey Optimizer で公開する必要があります。

手順 2：動的フラグメント参照を使用してメッセージを作成 author-message

パーソナライゼーションエディターで、次の構文を使用して動的フラグメントのプレースホルダーを挿入します。

{{fragment id=dynamic_fragment_id}}

識別子 dynamic_fragment_id は変数名です。 フラグメント検索を実行する前に、その値を解決する必要があります。 データセット参照式、プロファイル属性、コンテキストデータを使用して解決します。

データセット参照から解決 resolve-from-dataset

フラグメント ID が AEP データセット（例：スタイルからフラグメントへのマッピングテーブル）に格納されている場合は、datasetLookup ヘルパー関数を使用して解決します。

{{
  {datasetLookup datasetId="<your-dataset-id>" key=profile.style attribute="fragmentId"}
}}

{{fragment id=dynamic_fragment_id}}

この例では、データセットに、スタイル値（style1 など）をキーとする行が含まれています。 特定のプロファイルの場合、その参照は対応する fragmentId 列の値を取得して dynamic_fragment_id に割り当て、その値を用いてフラグメントを解決します。

コンテキストデータから解決 resolve-from-context

フラグメント ID が送信時に API リクエストコンテキストの一部として指定される場合は、context 名前空間を使用して参照します。

{{fragment id=context.audiencePayload.fragmentId}}

パス context.audiencePayload は、CSV オーディエンスファイルから取得されたすべての属性や、API リクエストコンテキスト経由で渡されるすべての属性に対して必須となる接頭辞です。 CSV の列名（例：fragmentId）が接頭辞に続きます。

プロファイル属性から解決 resolve-from-profile

フラグメント ID が Adobe Experience Platform のプロファイル属性として格納されている場合は、直接参照してください。

{{fragment id=profile.mi.fragmentId}}

手順 3：参照アプローチ用にデータセットを設定 configure-dataset

データセット参照アプローチを使用している場合は、フラグメント ID を含めるようにデータセットスキーマとデータを更新します。

データセット構造の例：

手順 4：送信時にコンテキストデータを渡す pass-context-data

コンテキストデータ（例：CSV オーディエンスレコメンデーションファイル）からフラグメント ID を解決する場合は、必要なコンテキスト接頭辞を付与した状態で API リクエストにフラグメント ID を渡します。

キャンペーンの本配信前確認 API を使用する際は、context オブジェクトにフラグメント ID を含めます。

{
  "recipients": [
    {
      "userId": "<profile-email>",
      "namespace": "email"
    }
  ],
  "inChannelData": {
    "channel": "email",
    "emailAddresses": ["<delivery-address>"]
  },
  "context": {
    "audiencePayload": {
      "fragmentId": "<published-fragment-id>",
      "systemSource": "<optional-system-value>"
    }
  }
}

接頭辞 context.audiencePayload は必須です。 このキーの下にネストされた属性は、ライブキャンペーンの実行時に、CSV オーディエンスファイルの列に直接マッピングされます。

手順 5：本配信前確認と検証 proof-validate

キャンペーンをアクティブ化する前に、キャンペーンの本配信前確認 API を使用して、動的フラグメントが正しく解決され、レンダリングされたメールの出力が期待どおりであることを確認します。

キャンペーン API について詳しくは、Journey Optimizer API ドキュメントを参照してください。

ガードレールと制限 guardrails

動的フラグメントを使用する際は、次の制限が適用されます。

フラグメントに適用されるその他のガードレールについて詳しくは、この節を参照してください。

エラー処理 error-handling

実行時に動的フラグメントの解決に失敗した場合、影響を受けるプロファイルに対して除外イベントが生成されます。 現在、すべてのフラグメントレンダリングのエラーは、単一のブランケットエラータイプとして分類されています。

フラグメント解決エラーをデバッグするには：