[限定提供]{class="badge informative"}
ジャーニーでの Adobe Experience Platform データの使用 datalookup
データセット検索 アクティビティを使用すると、実行時にAdobe Experience Platform個のレコードデータセットからデータを動的に取得できます。 この機能を活用することで、プロファイルやイベントペイロードに存在しない場合があるデータにアクセスできるので、顧客とのインタラクションが関連性が高く、タイムリーなものになります。
主な利点:
- リアルタイムパーソナライゼーション:強化されたデータを使用して、カスタマーエクスペリエンスをカスタマイズします。
- 動的な意思決定:外部データを使用して、ジャーニーのロジックとアクションを推進します。
- データアクセスの強化:特定のキーに関連付けられた製品メタデータ、価格テーブルまたはリレーショナルデータを取得します。
必読 must-read
データセット検索を設定する前に、これらの要件を確認してください。
データセットのイネーブルメント
Adobe Experience Platformで検索するには、データセットを有効にする必要があります。 詳細については、この節「使用 Adobe Experience Platform データ 」を参照してください。
制限および制約事項
- ジャーニーあたり最大 10 個のデータセット参照アクティビティ。
- 最大 20 個の選択フィールド。
- 参照キー配列内に最大 50 個のキー。
- 強化されたデータサイズは 10 KB に制限されています。
その他のパフォーマンスに関する考慮事項
以下のレコメンデーションは、配信品質の遅延を回避するガイダンスです。
データセット参照アクティビティの設定 configure
データセット参照アクティビティを設定するには、次の手順に従います。
-
オーケストレーションカテゴリを展開し、データセット参照アクティビティをキャンバスにドロップします。
ジャーニー
データセット検索アクティビティ
-
ラベルと説明を追加します。
-
「データセット」フィールドで、必要な属性を持つデータセットを選択します。
note note NOTE 探しているデータセットがリストに表示されない場合は、参照に対してデータセットが有効になっていることを確認します。詳しくは、必読の節を参照してください。 -
データセットから取得する特定のフィールドを選択します。
-
リーフノード(スキーマの最下位レベルのフィールド)のみを選択できます。フィールドは、プリミティブ値(文字列、数値、ブール値、日付など)にする必要があります。
-
リスト(配列)とマップ(キーと値のオブジェクト)は選択できません。
accordion 例
-
-
「参照キー」フィールドで、決定項目の属性とデータセットの両方に存在する結合キーを選択します。このキーは、システムで選択したデータセット内を検索するのに使用されます。
-
キーは、SKU、メール ID、その他の識別子など、ジャーニーコンテキストから派生した式にすることができます。例:
@profile.emailまたはlist(@event{purchase_event.products.sku})。 -
文字列または 文字列のリスト のみがサポートされます。
note important IMPORTANT 詳細モードを使用してルックアップキーを定義する必要があります。 シンプル モードを使用してキーを設定する場合、データセット参照アクティビティの出力は、ダウンストリームアクティビティのコンテキスト属性として使用できず、条件アクティビティで「データセット参照が見つかりません」エラーが発生して @datasetLookup{}構文が失敗します。accordion 例
-
ジャーニーでの強化されたデータの使用
データセット参照アクティビティで取得されたデータは、オブジェクトの配列としてジャーニーコンテキストに保存されます。これは、ジャーニー式エディターとパーソナライゼーションエディターで使用でき、強化されたデータに基づいて条件付きロジックとパーソナライズされたメッセージを有効にします。
-
ジャーニー式エディター:
詳細設定モードエディターにアクセスし、
@datasetLookup{MyDatasetLookUpActivity1.entities}構文を使用します。詳しくは、高度な式エディターの操作方法を参照してください。 -
パーソナライゼーションエディター:
{{context.journey.datasetLookup.1482319411.entities}}構文を使用します。
ユースケースの例
シナリオ:Send家庭用品に 40 ドル以上を費やすユーザーへのクーポン。
ジャーニーフロー:
-
購入イベント:ユーザーの買い物かごから SKU を取得します。
-
データセット参照アクティビティ:
- データセット:
products-dataset(プライマリキーとしての SKU)。 - 参照キー:
list(@event{purchase_event.products.sku})。 - 返されるフィールド:
["SKU", "category", "price"]。
- データセット:
-
条件アクティビティ:
-
カテゴリが「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
-
-
パーソナライゼーションエディター:
強化されたデータを使用して、メールのコンテンツをパーソナライズします。
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 に関連付けられており、ロイヤルティデータは標準のプロファイル参照ストアでは使用できません。
ジャーニーフロー:
-
プロファイルイベントトリガー:プロファイルまたはイベントコンテキストからメール ID を取得します。
-
データセット参照アクティビティ:
- データセット:
loyalty-member-dataset(プライマリキーとしてのメール)。 - 参照キー:
@profile.email。 - 返されるフィールド:
["email", "loyaltyTier"]。
- データセット:
-
条件アクティビティ:
ロイヤルティ層に基づいてジャーニーを分岐します。
code language-none @datasetLookup{MyDatasetLookUpActivity1.entity.loyaltyMember.loyaltyTier} == 'Platinum' -
パーソナライゼーションエディター:
強化されたロイヤルティ層のデータを使用して、アウトバウンド通信をパーソナライズします。
code language-none {{context.journey.datasetLookup.1482319411.entity.loyaltyMember.loyaltyTier}}
トラブルシューティング troubleshooting
条件アクティビティの「データセット参照が見つかりません」エラー troubleshooting-not-found
症状:条件アクティビティの高度な式エディターの@datasetLookup{}構文は、ジャーニーでデータセット検索アクティビティが正しく設定されていても、「データセット検索が見つかりません」エラーを返します。
原因: データセット ルックアップ アクティビティのルックアップ キーがシンプル モードを使用して設定されました。 キーが詳細モードで定義されていない場合、アクティビティ出力は、ダウンストリームアクティビティのコンテキスト属性として公開されません。
修正: データセット参照アクティビティを開き、参照キー フィールドを見つけ、詳細モードに切り替えてキー式を再定義します。 アクティビティを保存し、ジャーニーを再公開します。