[Disponibilidad limitada]{class="badge informative"}
Uso de datos de Adobe Experience Platform para la personalización aep-data
En esta página: Aprenda a utilizar la función de ayuda datasetLookup en el editor de personalización para recuperar campos de conjuntos de datos de registros de Adobe Experience Platform y personalizar su contenido.
Journey Optimizer permite aprovechar los datos de los conjuntos de datos de registros de Adobe Experience Platform en el editor de personalización para personalizar el contenido. Antes de empezar, los conjuntos de datos necesarios para la personalización de la búsqueda deben habilitarse primero para la búsqueda. Encontrará información detallada en esta sección: Usar datos de Adobe Experience Platform.
Una vez que un conjunto de datos se haya habilitado para la personalización de la búsqueda, puede utilizar sus datos para personalizar el contenido en Journey Optimizer.
-
Abra el editor de personalización, que está disponible en todos los contextos en los que puede definir la personalización, como los mensajes. Aprenda a trabajar con el editor de personalización
-
Vaya a la lista de funciones de ayuda y agregue la función de ayuda datasetLookup al panel de código.
-
Esta función proporciona una sintaxis predefinida que le permite llamar a campos de sus conjuntos de datos de Adobe Experience Platform. La sintaxis es la siguiente:
code language-none {{datasetLookup datasetId="datasetId" id="key" result="store" required=false}}-
datasetId es el ID del conjunto de datos con el que está trabajando.
-
id es el ID de la columna de origen que debe unirse con la identidad principal del conjunto de datos de búsqueda.
note NOTE El valor especificado para este campo puede ser un identificador de campo ( profile.packages.packageSKU), un campo pasado en un evento de recorrido (context.journey.events.event_ID.productSKU) o un valor estático (sku007653). En cualquier caso, el sistema utilizará el valor y buscará en el conjunto de datos para comprobar si coincide con una clave.Si utiliza un valor de cadena literal para la clave, mantenga el texto entre comillas. P. Ej.: {{datasetLookup datasetId="datasetId" id="SKU1234" result="store" required=false}}. Si utiliza un valor de atributo como clave dinámica, elimine las comillas. P. ej.:{{datasetLookup datasetId="datasetId" id=category.product.SKU result="SKU" required=false}} -
result es un nombre arbitrario que debe proporcionar para hacer referencia a todos los valores de campo que va a recuperar del conjunto de datos. Este valor se utiliza en el código para llamar a cada campo.
-
required=false: si se requiere se establece en TRUE, el mensaje solo se enviará si se encuentra una clave coincidente. Si se establece en false, no se requiere una clave coincidente y el mensaje se puede enviar de todos modos. Tenga en cuenta que, si se establece en false, se recomienda tener en cuenta los valores de reserva o predeterminados en el contenido del mensaje.
accordion ¿Dónde se recupera un ID de conjunto de datos? Los ID de conjuntos de datos se pueden recuperar en la interfaz de usuario de Adobe Experience Platform. Aprenda a trabajar con conjuntos de datos en la documentación de Adobe Experience Platform.
-
-
Adapte la sintaxis para adaptarla a sus necesidades. En este ejemplo, queremos recuperar datos relacionados con los vuelos de los pasajeros. La sintaxis es la siguiente:
code language-none {{datasetLookup datasetId="1234567890abcdtId" id=profile.upcomingFlightId result="flight"}}- Estamos trabajando en el conjunto de datos cuyo ID es “1234567890abcdtId”,
- El campo que queremos usar para unir con el conjunto de datos de búsqueda es profile.nextFlightId,
- Queremos incluir todos los valores de campo en la referencia “vuelo”.
-
Una vez configurada la sintaxis a la que se va a llamar en el conjunto de datos de Adobe Experience Platform, puede especificar qué campos desea recuperar. La sintaxis es la siguiente:
code language-none {{result.fieldId}}note NOTE Al hacer referencia a un campo del conjunto de datos, asegúrese de hacer coincidir la ruta del campo completo tal como se define dentro del esquema. No existen límites estrictos en el número de campos que se pueden extraer mediante la función de ayuda. Sin embargo, para obtener el mejor rendimiento, se recomienda mantener el número de campos por debajo de 50 para evitar afectar al rendimiento. -
result es el valor que ha asignado al parámetro result en la función de ayuda datasetLookup. En este ejemplo, “vuelo”.
-
fieldID es el identificador del campo que desea recuperar. Este identificador es visible en la interfaz de usuario Adobe Experience Platform al examinar el esquema de registros relacionado con el conjunto de datos:
accordion ¿Dónde se recupera un ID de campo? Los ID de campos se pueden recuperar al previsualizar un conjunto de datos en la interfaz de usuario de Adobe Experience Platform. Obtenga información sobre cómo obtener una vista previa de los conjuntos de datos en Adobe Experience Platform documentation.
En este ejemplo, queremos utilizar información relacionada con la hora de embarque y la puerta de embarque de los pasajeros. Por lo tanto, añadimos estas dos líneas:
{{flight._myorg.booking.boardingTime}}{{flight._myorg.booking.gate}}
-
-
Ahora que el código está listo, puede completar el contenido como de costumbre y probarlo con cualquiera de los métodos de simulación: haga clic en Simular contenido para probar las variaciones de contenido con datos de entrada de muestra o generación automática de IA, o haga clic en Simular contenido y luego seleccione Simular contenido (perfiles de AEP) del menú desplegable para previsualizarlo con perfiles de prueba. Obtenga información sobre cómo obtener una vista previa y probar contenido
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 teaches how to use the
datasetLookuphelper function in the Journey Optimizer personalization editor to retrieve fields from Adobe Experience Platform record datasets and incorporate them into message personalization.
Intents:
- Enable an AEP record dataset for lookup personalization
- Add the
datasetLookuphelper function to a personalization expression - Configure the function with a dataset ID, join key, result alias, and required flag
- Reference retrieved dataset fields in personalization expressions using the result alias
- Test personalized content using the Simulate content flow
Glossary:
- datasetLookup: A helper function in the personalization editor that retrieves field values from an AEP record dataset by joining on a specified key. (product-specific)
- Record dataset: An Adobe Experience Platform dataset type containing record-level data that can be enabled for lookup personalization. (product-specific)
- Lookup personalization: The process of fetching fields from an AEP record dataset at send time to personalize message content. (product-specific)
- result parameter: An arbitrary alias assigned in the
datasetLookupcall; used to reference all retrieved field values in subsequent expressions (e.g.{{result.fieldId}}). - required parameter: A boolean flag in
datasetLookupthat controls whether message delivery requires a matching key to be found in the dataset.
Guardrails:
- Feature is in Limited Availability — not yet generally available to all customers.
- The
datasetLookuphelper function within expression fragments is available to a limited set of customers only; contact your Adobe representative to gain access. - Datasets must be explicitly enabled for lookup personalization before they can be used with
datasetLookup. - Keep the number of fields retrieved per
datasetLookupcall under 50 to avoid impacting throughput (recommended limit — no hard limit is stated on the page).
Terminology:
- Canonical name: datasetLookup — variants: dataset lookup, dataset lookup helper, dataset lookup helper function
- Synonyms: “datasetLookup” = “dataset lookup helper function”
- Do not confuse: “datasetId” (identifier of the AEP dataset) ≠ “id” (the source column used to join with the dataset’s primary identity) ≠ “result” (the alias for referencing retrieved field values)
FAQ:
- Q: What is the
datasetLookuphelper function? — It is a helper function in the personalization editor that retrieves field values from Adobe Experience Platform record datasets, allowing you to incorporate that data into message personalization. - Q: What happens if
required=falseand no matching key is found in the dataset? — The message can still be delivered. It is recommended to account for fallback or default values in your message content when usingrequired=false. - Q: What happens if
required=trueand no matching key is found? — The message will only be delivered if a matching key is found in the dataset. - Q: Where do I find the dataset ID and field IDs needed for the syntax? — Dataset IDs can be retrieved in the Adobe Experience Platform UI under Datasets. Field IDs are visible when previewing a dataset and browsing the record schema in the AEP UI.
- Q: How do I test content that uses
datasetLookup? — Use the Simulate content button to test with sample input data or AI auto-generation, or select Simulate content (AEP profiles) from the dropdown to preview with test profiles.