[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.

NOTE
La capacidad de búsqueda de datos solo está disponible para un conjunto de organizaciones (disponibilidad limitada). Para obtener acceso, póngase en contacto con su representante de Adobe. Para obtener información detallada acerca del ciclo de lanzamiento y las fases de disponibilidad, consulte Ciclo de lanzamiento de Journey Optimizer.

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, Sku10

    Si 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

Componente de función
Límites
Notas
Conjuntos de datos de búsqueda habilitados
Máx. 10 por organización
Número máximo de conjuntos de datos que se pueden configurar para la búsqueda en un momento determinado. Este límite se aplica al número total combinado de conjuntos de datos de búsqueda en los entornos limitados de producción y desarrollo de la instancia del cliente.
Recuento de registros de conjuntos de datos
Hasta 2 millones de registros por conjunto de datos
Número máximo de registros permitidos en un único conjunto de datos, calculado como el recuento total en todos los lotes dentro de ese conjunto de datos.
Tamaño de registro
Hasta 2 KB por registro
Se admite el tamaño máximo de registro predeterminado.
Tamaño del conjunto de datos
Hasta 4 GB
El tamaño máximo de un conjunto de datos individual, no el tamaño combinado en todos los conjuntos de datos de una zona protegida. Los límites de recuento de registros y tamaño del conjunto de datos son protecciones independientes; ambas deben cumplirse.
Actualizaciones de frecuencia de conjuntos de datos
Hasta 5 actualizaciones al día por conjunto de datos
Frecuencia máxima de operaciones de actualización permitidas para un único conjunto de datos por día.
NOTE
Si se necesitan volúmenes adicionales más allá de las protecciones enumeradas anteriormente, póngase en contacto con su representante de Adobe.

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.

Ejemplo

El esquema debe tener una identidad principal definida.

Ejemplo

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.

Ejemplo

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.).
NOTE
If you encounter the error below when attempting an API call to enable datasets, try removing the Adobe Journey Optimizer APIs from your developer console project and then re-adding them:
"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:

recommendation-more-help
journey-optimizer-help