ジャーニーでの Adobe Experience Platform データの使用 datalookup

製品カテゴリベースのフィルタリング

シナリオ:Send​家庭用品に 40 ドル以上を費やすユーザーへのクーポン。

ジャーニーフロー：

1. 購入イベント：ユーザーの買い物かごから SKU を取得します。

2. データセット参照アクティビティ：

   • データセット：products-dataset（プライマリキーとしての SKU）。
   • 参照キー：list(@event{purchase_event.products.sku})。
   • 返されるフィールド：["SKU", "category", "price"]。

3. 条件アクティビティ：

   • カテゴリが「household」の SKU をフィルタリングします。

     code language-none
     @event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookupActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}

   または

   • 家庭用品に対する総支出を集計し、40 ドルのしきい値と比較します。

     code language-none
     sum(@event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookUpActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}.price}, ',', true ) > 40

4. パーソナライゼーションエディター：

   強化されたデータを使用して、メールのコンテンツをパーソナライズします。

   code language-none
   {% let householdTotal = 0 %} {{#each journey.datasetlookup.3709000.entities as |product|}} {%#if get(product, "category") = "household"%} {% let householdTotal = householdTotal + product.price %}{%/if%} {{/each}} "Hi, thanks for spending " + {%= householdTotal %} + " on household products. Here is your reward!"

外部ロイヤルティデータを使用したパーソナライゼーション

シナリオ：プラチナロイヤルティステータスを持っているプロファイルのメールアカウントを特定します。 このシナリオでは、ロイヤルティアカウントはメール ID に関連付けられており、ロイヤルティデータは標準のプロファイル参照ストアでは使用できません。

ジャーニーフロー：

1. プロファイルイベントトリガー：プロファイルまたはイベントコンテキストからメール ID を取得します。

2. データセット参照アクティビティ：

   • データセット：loyalty-member-dataset（プライマリキーとしてのメール）。
   • 参照キー：@profile.email。
   • 返されるフィールド：["email", "loyaltyTier"]。

3. 条件アクティビティ：

   ロイヤルティ層に基づいてジャーニーを分岐します。

   code language-none
   @datasetLookup{MyDatasetLookUpActivity1.entity.loyaltyMember.loyaltyTier} == 'Platinum'

4. パーソナライゼーションエディター：

   強化されたロイヤルティ層のデータを使用して、アウトバウンド通信をパーソナライズします。

   code language-none
   {{context.journey.datasetLookup.1482319411.entity.loyaltyMember.loyaltyTier}}

AI ナレッジリファレンス

このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。

理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。

• TL;DR:​このページでは、リアルタイムのパーソナライゼーションと条件付きロジックのために、ジャーニーランタイムでAEP レコードデータセットデータを動的に取得するようにデータセット検索アクティビティを設定する方法について説明します。

インテント：

• 実行時に外部AEP レコードデータを取得するデータセットルックアップアクティビティをジャーニーに追加します
• 検索時に取得する特定のデータセットフィールド（リーフノード/プリミティブ値）を選択します
• 高度なモードでルックアップキーを定義して、ジャーニーコンテキストをデータセットレコードと結合します
• ジャーニー式エディターまたはパーソナライゼーションエディターでの強化されたデータセットのデータの使用
• ルックアップキーにシンプルモードを使用することで発生する「データセットのルックアップが見つかりません」エラーのトラブルシューティング

用語集：

• データセット検索アクティビティ：結合キー​ （製品固有） ​を使用して、実行時にAEP レコード データセットからデータを取得するジャーニーオーケストレーション アクティビティ
• リーフノード：プリミティブ値（文字列、数値、ブール値、日付）を保持するスキーマ階層の最下位レベルのフィールド （製品固有）
• 参照キー：選択したデータセット （製品固有）​のレコードに対してジャーニーコンテキストデータを照合するために使用される結合式（文字列または文字列のリスト）
• 強化されたデータ: データセット検索アクティビティによって取得され、ジャーニーコンテキストに一時的に保存され、ダウンストリームアクティビティ （製品固有）​で使用されます

ガードレール：

• ジャーニーごとに最大10個のデータセット検索アクティビティ。
• 検索アクティビティごとに選択された最大20個のフィールド。
• 参照キー配列内に最大 50 個のキー。
• 強化されたデータサイズは 10 KB に制限されています。
• データセットがアクティビティ設定に表示される前に、Adobe Experience Platformで検索できるようにデータセットを有効にする必要があります。
• 選択できるのはリーフノード（プリミティブ値）のみです。配列とマップは選択できません。
• 文字列または文字列のリストのみがルックアップキーとしてサポートされます。
• ルックアップキーは詳細モードで定義する必要があります。シンプルなモードを使用すると、アクティビティ出力はコンテキスト属性としてダウンストリームで使用できなくなります。
• 強化されたデータは一時的なもので、ジャーニーランタイムおよびアウトバウンドアクティビティのパーソナライゼーションでのみ使用できます。
• 最高のパフォーマンスを得るには、ジャーニーごとに5つのルックアップアクティビティに制限してください（推奨）。システムによって適用されるハード制限は、ジャーニーごとに10のアクティビティです。 ルックアップごとに最大20個の属性を使用することも推奨されます。

用語：

• 正式名称：データセット検索アクティビティ — Acronym: n/a — バリアント：AEP data lookup, data enrichment activity
• 同義語：「ルックアップキー」 = 「結合キー」
• 混乱しないでください：「データセット検索アクティビティ」 ≠ 「エクスペリエンスイベント検索」 – データセット検索は、時系列のエクスペリエンスイベントではなく、レコードデータセットのデータを取得します

FAQ:

• Q：自分のデータセットがデータセットフィールドのドロップダウンに表示されないのはなぜですか？ — Adobe Experience Platformで検索するには、データセットを有効にする必要があります。 これを有効にするには、「必読」セクションの手順に従います。
• Q: @datasetLookup{}が条件で「データセット参照が見つかりません」エラーを返すのはなぜですか？ — ルックアップキーは、アドバンスモードではなくシンプルモードを使用して定義されました。 詳細設定モードで定義し直して、ジャーニーを再公開します。
• Q: データセットから配列またはマップフィールドを取得できますか？ – いいえ、プリミティブなリーフノードフィールド（文字列、数値、ブール値、日付）のみを選択できます。
• Q: メール内のエンリッチメントデータにアクセスするにはどうすればよいですか？ – 構文{{context.journey.datasetLookup.<activityId>.entities}}を含むパーソナライゼーションエディターを使用します。
• Q: エンリッチメントされたデータは、ジャーニーの終了後も保持されますか？ – いいえ、強化されたデータは一時的なもので、ジャーニーランタイムセッション中にのみ使用できます。