Adobe Experience Platform データをパーソナライゼーションに使用 aep-data

メッセージなどのパーソナライズ機能を定義でき、すべてのコンテキストで使用できるパーソナライゼーションエディターを開きます。パーソナライゼーションエディターの操作方法を学ぶ

ヘルパー関数リストに移動して、datasetLookup ヘルパー関数をコードペインへ追加します。

この関数は、Adobe Experience Platform データセットからフィールドを呼び出すことができる、定義済みの構文を提供します。構文は以下の通りです。

{{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}

• datasetId は作業中のデータセットの ID です。

• id は、参照データセットのプライマリ ID と結合する必要があるソース列の ID です。

  note note
  NOTE
  このフィールドに入力する値は、フィールド ID（profile.packages.packageSKU）、ジャーニーイベントで渡されるフィールド（context.journey.events.event_ID.productSKU）、または静的な値（sku007653）です。いずれの場合も、システムは値を使用してデータセットを検索し、キーと一致するかどうかを確認します。
  キーにリテラル文字列値を使用する場合は、テキストを引用符で囲みます。例：{{datasetLookup datasetId="datasetId" id="SKU1234" result="store" required=false}}。属性値を動的キーとして使用する場合は、引用符を削除します。例：{{datasetLookup datasetId="datasetId" id=category.product.SKU result="SKU" required=false}}

• result はデータセットから取得するすべてのフィールド値を参照するために指定する必要がある、任意の名前です。この値はコード内で各フィールドを呼び出すために使用されます。

• required=false：required が TRUE に設定されている場合、一致するキーが見つかった場合にのみメッセージが配信されます。false に設定した場合は、一致するキーは必要なく、メッセージを配信できます。false に設定した場合、メッセージコンテンツのフォールバックまたはデフォルト値を考慮することをお勧めします。

ニーズに合わせて構文を調整します。この例では、乗客のフライトに関連するデータを取得します。構文は以下の通りです。

{{datasetLookup datasetId="1234567890abcdtId" id=profile.upcomingFlightId result="flight"}}

• ID が「1234567890abcdtId」のデータセットで作業しています。
• ルックアップデータセットとの結合に使用するフィールドは、profile.upcomingFlightId です。
• 「フライト」参照の下のすべてのフィールド値を含めるようにします。

Adobe Experience Platform データセットで呼び出す構文が設定されたら、取得するフィールドを指定できます。構文は以下の通りです。

{{result.fieldId}}

• result は MultiEntity ヘルパー関数で result パラメーターに割り当てた値です。この例では「フライト」です。

• fieldID は取得するフィールドの ID です。この ID は、データセットに関連するレコードスキーマを参照する際に、Adobe Experience Platform ユーザーインターフェイスに表示されます。

  accordion
  フィールド ID はどこで取得できますか？
  フィールド ID は、Adobe Experience Platform ユーザーインターフェイスでデータセットをプレビューするときに取得できます。データセットのプレビュー方法について詳しくは、Adobe Experience Platform ドキュメントを参照してください。

この例では、乗客の搭乗時間と搭乗口に関する情報を使用します。したがって、次の 2 行を追加します。

• {{flight._myorg.booking.boardingTime}}
• {{flight._myorg.booking.gate}}

コードの準備が整いました。通常通りにコンテンツを完成させ、「コンテンツをシミュレート」ボタンを使用してテストし、パーソナライズ機能を確認することができます。コンテンツのプレビューとテストの方法について学ぶ