[Disponibilidad limitada]{class="badge informative"}
Uso de datos de Adobe Experience Platform aep-data
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.
Enable the dataset for lookup in the dataset management interface
In the dataset management user interface, use the toggle to enable the dataset for lookup.
API Method
Follow the directions detailed in this documentation to configure your environment to send API commands.
Requisitos previos
-
The developer project must have the Adobe Journey Optimizer and Adobe Experience Platform APIs added to their project.
-
You must have manage datasets permission as part of your role.
-
The schema for which the dataset is based on must contain a primary identity that can act as the lookup key.
API call structure
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:
- URL is
https://platform.adobe.io/data/core/entity/lookup/dataSets/${DATASET_ID}/${ACTION} - Dataset ID is the dataset for which you wish to enable.
- Action is enable OR disable.
- Access token can be retrieved from the developer console.
- API key can be retrieved from the developer console.
- IMS Org ID is your Adobe organization.
- Sandbox Name is the sandbox name the dataset is in (i.e. prod, dev etc.).
"error_code": "403003","message": "Api Key is invalid"Dataset monitoring
Once a dataset has been enabled for lookup, you can review the status of ingestion into the lookup service by going to the Monitoring menu and selecting the Journey Optimizer tab.
This process indicator helps in understanding when new batches of data are available in the lookup service.
Próximos pasos
After a dataset has been enabled for lookup using an API call, you can use the data with Journey Optimizer personalization and Decisioning capabilities. Para obtener más información, consulte estas secciones: