動的フラグメントを使用 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を使用して、ダイナミックフラグメントが正しく解決され、レンダリングされたメール出力が期待どおりであることを確認します。

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

ガードレールと制限 guardrails

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

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

エラー処理 error-handling

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

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