[Disponibilidad limitada]{class="badge informative"}
Uso de datos de Adobe Experience Platform aep-data
En esta página: Habilite conjuntos de datos de Adobe Experience Platform basados en registros para la búsqueda a fin de enriquecer la personalización, la toma de decisiones y la orquestación de recorrido con datos de referencia y transaccionales recuperados durante la ejecución en Journey Optimizer.
Journey Optimizer le permite aprovechar los datos de Adobe Experience Platform con capacidades de personalización, toma de decisiones y orquestación de recorrido. Para ello, los conjuntos de datos basados en registros necesarios para la personalización de la búsqueda deben habilitarse primero para el servicio de búsqueda como se describe a continuación.
Obtenga más información sobre cómo acceder a los conjuntos de datos y trabajar con ellos en esta sección: Introducción a los conjuntos de datos
Lectura obligatoria
Protecciones y directrices guidelines
Antes de empezar, revise las siguientes restricciones y directrices:
-
No hay PII en los conjuntos de datos. Los conjuntos de datos habilitados para la búsqueda no deben contener información de identificación personal (PII).
-
Riesgo de eliminación: los conjuntos de datos utilizados en la personalización no están protegidos contra eliminación. Debe realizar un seguimiento de los conjuntos de datos que se utilizan para asegurarse de que no se eliminan.
-
Tipo de esquema: los conjuntos de datos deben estar asociados con un esquema que sea NO de tipo perfil o evento.
-
Mantener la opción de búsqueda activada: evite activar y desactivar conjuntos de datos repetidamente. Al hacerlo, se puede producir un comportamiento de indexación inesperado. La práctica recomendada es dejar el conjunto de datos habilitado durante el tiempo que desee utilizarlo para búsquedas.
-
Región de activación de Edge: los conjuntos de datos habilitados para la búsqueda solo están disponibles para la activación entrante basada en Edge en la región donde reside la zona protegida del conjunto de datos (por ejemplo, NLD2 o VA7). Puede ver la región de zona protegida en la interfaz de usuario junto al nombre de la zona protegida.
-
Lote de eliminación de datos: al eliminar un lote de datos del conjunto de datos, se eliminan por completo todas las claves coincidentes del servicio de búsqueda. Por ejemplo:
Lote 1: Sku1, Sku2, Sku3
Lote 2: Sku1, Sku2, Sku3, Sku4, Sku5, Sku6
Lote 3: Sku7, Sku8, Sku9, Sku10Si elimina Lote 1, Sku1, Sku2 y Sku3 se quitarán del almacén de búsqueda. Los datos de búsqueda resultantes contendrán: Sku4, Sku5, Sku6, Sku7, Sku8, Sku9, Sku10.
Derecho al servicio de búsqueda
Habilitar un conjunto de datos para la búsqueda de datos enable
Para aprovechar los datos del conjunto de datos para la personalización, debe habilitar el conjunto de datos para la búsqueda.
Requisitos previos prerequisites-enable
El esquema asociado con el conjunto de datos que desea habilitar para la búsqueda debe ser del tipo registro. El esquema NO debe ser de perfil ni de clase de evento.
El esquema debe tener una identidad principal definida.
Si aún no se ha definido un área de nombres personalizada, asegúrese de que la identidad sea un identificador que no sea una persona.
Habilitar el conjunto de datos para la búsqueda en la interfaz de administración de conjuntos de datos
En la interfaz de usuario de administración de conjuntos de datos, utilice la opción para habilitar el conjunto de datos para la búsqueda.
Método de API
Siga las instrucciones detalladas en esta documentación para configurar su entorno y enviar comandos de API.
Requisitos previos
-
El proyecto de desarrollador debe tener las API de Adobe Journey Optimizer y Adobe Experience Platform añadidas a su proyecto.
-
Debe tener permiso para administrar conjuntos de datos como parte de la función.
-
El esquema en el que se basa el conjunto de datos debe contener una identidad principal que pueda actuar como clave de búsqueda.
Estructura de llamadas 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}"
Donde:
- La URL es
https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION} - El ID del conjunto de datos es el conjunto de datos para el que desea habilitar.
- La acción está habilitada O deshabilitada.
- El token de acceso se puede recuperar de Developer Console.
- La clave de API se puede recuperar de Developer Console.
- El ID de organización de IMS es su organización de Adobe.
- Nombre de zona protegida es el nombre de la zona protegida en la que se encuentra el conjunto de datos (es decir, prod, dev, etc.).
"error_code": "403003","message": "Api Key is invalid"Monitorización de conjuntos de datos
Una vez que un conjunto de datos se haya habilitado para la búsqueda, puede revisar el estado de la ingesta en el servicio de búsqueda. Para ello, vaya al menú Supervisión y seleccione la pestaña Journey Optimizer.
Este indicador de proceso ayuda a comprender cuándo están disponibles nuevos lotes de datos en el servicio de búsqueda.
Próximos pasos
Una vez habilitado un conjunto de datos para la búsqueda mediante una llamada de API, puede utilizar los datos con las capacidades de personalización y toma de decisiones de Journey Optimizer. Para obtener más información, consulte estas secciones:
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.