このページ：レコードベースの Adobe Experience Platform データセットを参照のために有効にすると、Journey Optimizer での実行時に取得される参照データやトランザクションデータを使用して、パーソナライゼーション、決定、ジャーニーオーケストレーションを強化できます。
Journey Optimizer を使用すると、パーソナライゼーション、決定、ジャーニーオーケストレーション機能を使用して、Adobe Experience Platform のデータを活用できます。 これを行うには、まず、以下で説明するように、参照パーソナライゼーションに必要なレコードベースのデータセットを参照サービスに対して有効にする必要があります。
データセットにアクセスして操作する方法について詳しくは、データセットの基本を学ぶの節を参照してください。
必読
ガードレールとガイドライン guidelines
開始する前に、次の制限事項とガイドラインを確認してください。
-
データセットに PII を含めない - 参照が有効になっているデータセットに、個人を特定できる情報（PII）を含めることはできません。
-
削除のリスク - パーソナライゼーションで使用されるデータセットは、削除から保護されません。 どのデータセットが使用されているかを追跡して、削除されないようにする必要があります。
-
スキーマタイプ - データセットは、プロファイルタイプまたはイベントタイプでは ない スキーマに関連付ける必要があります。
-
参照の切り替えをオンのままにする - データセットを繰り返しオン/オフに切り替えないようにします。 繰り返し切り替えると、予期しないインデックス作成動作につながる可能性があります。 ベストプラクティスは、参照に使用する予定がある限り、データセットを有効のままにしておくことです。
-
エッジアクティベーション地域 - 参照のために有効にしたデータセットは、データセットのサンドボックスが存在する地域（例：NLD2 や VA7）でのみ、インバウンドエッジベースのアクティベーションに使用できます。 サンドボックス名の横にある UI でサンドボックス地域を確認できます。
-
データのバッチ削除 - データセットからデータのバッチを削除すると、一致するすべてのキーが参照サービスから完全に削除されます。 次に例を示します。
バッチ 1：Sku1、Sku2、Sku3
バッチ 2：Sku1、Sku2、Sku3、Sku4、Sku5、Sku6
バッチ 3：Sku7、Sku8、Sku9、Sku10バッチ 1 を削除すると、Sku1、Sku2、Sku3 が検索ストアから削除されます。 結果として生成される参照データには、Sku4、Sku5、Sku6、Sku7、Sku8、Sku9、Sku10 が含まれます。
参照サービスの使用権限
データ参照用データセットの有効化 enable
データセットのデータをパーソナライゼーションに活用するには、参照用データセットを有効にする必要があります。
前提条件 prerequisites-enable
参照を有効にするデータセットに関連付けられたスキーマは、レコードタイプにする必要があります。 スキーマをプロファイルまたはイベントクラスにすることはできません。
スキーマにはプライマリ ID が定義されている必要があります。
カスタム名前空間がまだ定義されていない場合は、ID がユーザー以外の識別子であることを確認します。
データセット管理インターフェイスで参照用データセットを有効にする
データセット管理ユーザーインターフェイスで、切替スイッチを使用して、参照用データセットを有効にします。
API メソッド
このドキュメントで説明されている手順に従って、API コマンドを送信するように環境を設定します。
前提条件
-
開発者プロジェクトには、Adobe Journey Optimizer と Adobe Experience Platform API がプロジェクトに追加されている必要があります。
-
役割の一部としてデータセットの管理権限が必要です。
-
データセットの基となるスキーマには、参照キーとして機能するプライマリ ID が含まれている必要があります。
API 呼び出し構造
curl -s -XPATCH "https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}" \ -H "Authorization: Bearer ${ACCESS_TOKEN}" \ -H "x-api-key: ${API_KEY}" \ -H "x-gw-ims-org-id: ${IMS_ORG}" \ -H "x-sandbox-name: ${SANDBOX_NAME}"
ここで：
- URL は
https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION}です。 - データセット ID は、有効にするデータセットです。
- アクションは、有効または無効です。
- アクセストークンは、Developer Console から取得できます。
- API キーは、Developer Console から取得できます。
- IMS 組織 ID は Adobe 組織です。
- サンドボックス名は、データセットが含まれるサンドボックス名です（実稼動、開発など）。
"error_code": "403003","message": "Api Key is invalid"データセットのモニタリング
参照用データセットが有効になったら、モニタリングメニューに移動して「Journey Optimizer」タブを選択し、参照サービスへの取り込みステータスを確認できます。
このプロセスインジケーターは、参照サービスで新しいデータのバッチが使用可能なタイミングを理解するのに役立ちます。
次の手順
API 呼び出しを使用して参照用データセットを有効にすると、そのデータを Journey Optimizer のパーソナライゼーションと決定機能で使用できます。 詳しくは、次の節を参照してください。
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: This page explains how to enable record-based Adobe Experience Platform datasets for the lookup service so their data can enrich personalization, Decisioning, and journey orchestration at runtime, including the entitlement guardrails.
Intents:
- Enable a record-based dataset for lookup using the dataset management toggle or the API.
- Meet the prerequisites (record-type schema, primary identity, non-person namespace).
- Review the lookup entitlement limits before designing a lookup strategy.
- Monitor lookup ingestion status.
- Use enabled data with personalization, Decisioning, and journey orchestration.
Glossary:
- Lookup service: the service that retrieves record-based dataset data at runtime for personalization, Decisioning, and journey orchestration (product-specific)
- Lookup dataset: a record-based dataset enabled for lookup (product-specific)
- Primary identity (lookup key): the identity, required on the schema, that acts as the lookup key (product-specific)
- Record-type schema: the required schema type for lookup — a schema that is NOT of Profile or Event class
- Edge activation region: the region (for example, NLD2 or VA7) where the dataset’s sandbox resides, for inbound edge-based activation (product-specific)
Guardrails:
- Enabled Lookup Datasets: maximum 10 per organization, combined across production and development sandboxes (default; if additional volumes are needed, contact your Adobe representative).
- Dataset Record Count: up to 2 million records per dataset, counted as the total across all batches (default; raisable by contacting your Adobe representative).
- Record Size: up to 2 KB per record (default maximum record size supported).
- Dataset Size: up to 4 GB per individual dataset; the record count and dataset size limits are independent guardrails and both must be satisfied (default; raisable by contacting your Adobe representative).
- Dataset Frequency Updates: up to 5 updates per day per dataset (default; raisable by contacting your Adobe representative).
- Datasets enabled for lookup should not contain any Personally Identifiable Information (PII).
- Datasets used in personalization are not protected from deletion; keep track of which datasets are in use.
- The schema must be record-type (NOT of Profile or Event class) and must have a primary identity defined; if a custom namespace is not defined, the identity must be a non-person identifier.
- Keep the lookup toggle on; repeatedly turning datasets on and off can lead to unexpected indexing behavior.
- Datasets enabled for lookup are available for inbound edge-based activation only in the region where the dataset’s sandbox resides.
- Removing a batch of data completely removes all matching keys from the lookup service.
- The data lookup capability is in Limited Availability.
Terminology:
- Canonical name: lookup service — variants: data lookup, enable for lookup
- API ACTION values:
enableORdisable - Do not confuse: a “lookup dataset” (record-type, NOT Profile or Event, not stored on the profile) ≠ a profile or event dataset (Profile or Event class)
- Do not confuse: enabling a dataset for “lookup” ≠ enabling a dataset for “Profile”
FAQ:
- Q: What schema type is required for a lookup dataset? — A record-type schema that is NOT of Profile or Event class, with a primary identity defined that can act as the lookup key.
- Q: How many datasets can I enable for lookup? — Up to 10 per organization, combined across production and development sandboxes; contact your Adobe representative for more.
- Q: What are the record and size limits? — Up to 2 million records and 4 GB per dataset, up to 2 KB per record, and up to 5 updates per day per dataset; the record count and dataset size are independent guardrails that must both be satisfied.
- Q: Can lookup datasets contain PII? — No; datasets enabled for lookup should not contain any Personally Identifiable Information.
- Q: What happens if I delete a batch of data? — All matching keys in that batch are completely removed from the lookup service.
- Q: Should I toggle lookup on and off frequently? — No; repeatedly turning datasets on and off can lead to unexpected indexing behavior, so keep the toggle on while the dataset is in use.