En esta página: Aprenda a utilizar identificadores suplementarios (identificadores secundarios como un identificador de pedido o de reserva) para ejecutar una instancia de recorrido independiente por identificador y personalizar mensajes con sus atributos.
➡️ Descubra esta funcionalidad en vídeo
Protecciones y limitaciones guardrails
-
recorridos admitidos: se admiten identificadores adicionales para los recorridos activados por eventos y Leer audiencia. No son compatibles con los recorridos de calificación de audiencia (es decir, recorridos que comiencen con una actividad de calificación de audiencia).
-
Acciones entrantes: actualmente no se admiten identificadores adicionales para las acciones entrantes, como las acciones en la aplicación y web.
-
Límites de instancias simultáneas: los perfiles no pueden tener más de 10 instancias de recorrido simultáneas.
-
Tipo de datos y estructura de esquema: el identificador suplementario debe ser del tipo
string. Puede ser un atributo de cadena independiente o puede ser un atributo de cadena dentro de una matriz de objetos. El atributo de cadena independiente generará una única instancia de recorrido, mientras que el atributo de cadena dentro de una matriz de objetos generará una instancia de recorrido única por iteración de la matriz de objetos. No se admiten matrices de cadenas ni mapas. -
reentrada al Recorrido
El recorrido del comportamiento de reentrada con identificadores suplementarios sigue la política de reentrada existente:
- Si el recorrido no es de reentrada, la misma combinación de ID de perfil + ID suplementario no puede volver a entrar en el recorrido.
- Si el recorrido es de reentrada con una ventana de tiempo, la misma combinación de ID de perfil + ID suplementario puede volver a introducirse después de la ventana de tiempo definida.
-
Etiquetado y aplicación del uso de datos (Data Use Labeling and Enforcement, DULE): no se realizan comprobaciones de validación DULE en el ID suplementario. Esto significa que este atributo no se tendrá en cuenta cuando el recorrido busque infracciones de directivas de gobernanza de datos.
-
Configuración de eventos descendentes
Si está utilizando otro evento descendente en la recorrido, debe utilizar el mismo ID suplementario y tener el mismo área de nombres de ID.
-
Leer recorridos de audiencia
- Eventos empresariales: el Id. suplementario se deshabilita si usa un evento empresarial.
- Campos de contexto y evento: El identificador suplementario no debe proceder de un campo de contexto de evento o recorrido.
- Selección de atributos: cualquier atributo que no sea de identidad (o identidad que no sea de persona) puede usarse como ID suplementario para todos los tipos de audiencia (servicio de perfil unificado, importación de CSV y composición de audiencias federadas). No se permiten los atributos de identidad basados en personas. Para audiencias externas, vea Identificadores adicionales con audiencias externas para patrones de datos compatibles y requisitos de configuración.
- Tasa de lectura: Para los recorridos de audiencia de lectura que usan un campo de ID suplementario de tipo matriz, la tasa de lectura de la actividad Leer audiencia está limitada a un máximo de 500 perfiles por segundo.
Comportamiento de criterios de salida con ID suplementarios exit-criteria
Condición previa: Recorrido habilitado para ID suplementario (a través de actividades de evento unitario o lectura de audiencia)
En la tabla siguiente se explica el comportamiento de los perfiles en un recorrido suplementario habilitado para ID cuando se configuran los criterios de salida:
Nota: el área de nombres de ID suplementario debe coincidir con el del nodo inicial.
Añadir un identificador suplementario y aprovecharlo en un recorrido add
Para utilizar un identificador suplementario en un recorrido activado por evento, siga estos pasos:
-
Agregar el identificador suplementario al evento
-
Cree o edite el evento deseado. Aprenda a configurar un evento unitario
-
En la pantalla de configuración del evento, marque la opción Usar identificador suplementario.
-
Utilice el editor de expresiones para seleccionar el campo que desea utilizar como ID suplementario (por ejemplo, ID de reserva, ID de suscripción).
note NOTE Asegúrese de utilizar el editor de expresiones en Modo avanzado para seleccionar el atributo.
-
-
Agregar el evento al recorrido
Arrastre el evento configurado al lienzo de recorrido. Almacenará en déclencheur la entrada de recorrido en función tanto del ID de perfil como del ID suplementario.
Para utilizar un identificador suplementario en un recorrido Leer audiencia, siga estos pasos:
-
Agregar y configurar una actividad Leer audiencia en el recorrido
-
Arrastre una actividad Leer audiencia a su recorrido.
-
En el panel de propiedades de la actividad, active la opción Usar identificador suplementario.
-
En el campo Identificador suplementario, use el editor de expresiones para seleccionar el atributo de identificador suplementario.
Para las audiencias importadas desde un archivo CSV, si la audiencia CSV contiene varias filas por ID de perfil, asegúrese de que la activación rápida esté habilitada primero; consulte Identificadores adicionales con audiencias externas.
note Asegúrese de usar el editor de expresiones en Modo avanzado para seleccionar el atributo. -
Aprovechamiento de atributos de ID suplementarios
Utilice el editor de expresiones y el editor de personalización para hacer referencia a los atributos del identificador suplementario para la personalización o la lógica condicional. Se puede acceder a los atributos desde el menú Atributos contextuales.
Para los recorridos activados por eventos si trabaja con matrices (por ejemplo, varias prescripciones o directivas), utilice una fórmula para extraer elementos específicos.
En una matriz de objetos con el Id. suplementario como bookingNum y un atributo en el mismo nivel denominado bookingCountry, el recorrido se iterará a través del objeto de matriz basado en bookingNum y creará una instancia de recorrido para cada objeto.
-
La siguiente expresión en la actividad de condición iterará a través de la matriz de objetos y comprobará si el valor de
bookingCountryes igual a “FR”:code language-none @event{<event_name>.<object_path>.<object_array_name>.all(currentEventField.<attribute_path>.bookingNum==${supplementalId}).at(0).<attribute_path>.bookingCountry}=="FR" -
La siguiente expresión en el editor de personalización de correo electrónico se iterará a través de la matriz de objetos, extraerá el
bookingCountryaplicable a la instancia de recorrido actual y lo mostrará en el contenido:code language-none {{#each context.journey.events.<event_ID>.<object_path>.<object_array_name> as |l|}} {%#if l.<attribute_path>.bookingNum = context.journey.technicalProperties.supplementalId%} {{l.<attribute_path>.bookingCountry}} {%/if%} {{/each}} -
Ejemplo del evento utilizado para almacenar en déclencheur el recorrido:
code language-none "bookingList": [ { "bookingInfo": { "bookingNum": "x1", "bookingCountry": "US" } }, { "bookingInfo": { "bookingNum": "x2", "bookingCountry": "FR" } } ]
Arbitraje de recorrido e ID suplementario arbitration
La mediación de recorridos (incluidos los límites de concurrencia y el recuento de entradas dentro de los conjuntos de reglas) funciona en el nivel de ID de perfil, no en el nivel de par (ID de perfil, ID suplementario). Esto significa que un límite de concurrencia de 1 puede bloquear una segunda instancia de recorrido para el mismo perfil incluso cuando lleva un valor de ID suplementario diferente.
Póngase en contacto con su representante de Adobe para obtener instrucciones sobre el comportamiento de mediación antes de depender de la configuración de mediación específica en producción.
Documentación relacionada:
Identificadores adicionales con audiencias externas external-audiences
Se admite un ID suplementario para audiencias externas, incluidas las audiencias importadas de un archivo CSV y las creadas con Composición de audiencias federada. Al configurar un recorrido que lee desde una audiencia CSV o de Composición de audiencia federada, puede designar cualquier atributo que no sea de identidad en esa audiencia como ID suplementario. A continuación, Journey Optimizer crea una instancia de recorrido independiente por cada combinación de perfil único + ID suplementario.
-
Caso de uso 1: Una fila por perfil único + par de ID suplementario
Este es el caso de uso principal para las audiencias de Composición de audiencias federadas y CSV. La audiencia contiene varias filas en las que cada fila representa una combinación única de un perfil (por ejemplo, un cliente) y un ID suplementario (por ejemplo, una cuenta o un ID de pedido). Cada fila se trata como un registro de activación independiente.
table 0-row-3 1-row-3 2-row-3 3-row-3 profile_id account_id (Id. suplementario) other_attributes customer_001 ACC-1001 … customer_001 ACC-1002 … customer_002 ACC-2001 … En este ejemplo,
customer_001tiene dos cuentas. Journey Optimizer crea una instancia de recorrido independiente para cada par de perfil único +account_id. -
Caso de uso 2: Una fila por perfil con una matriz de ID suplementarios
Este caso de uso está disponible para tipos de audiencia que admiten matrices. Una sola fila de la audiencia contiene un perfil con un atributo de matriz que contiene varios valores de ID suplementarios. Journey Optimizer crea una instancia de recorrido por valor en la matriz.
table 0-row-3 1-row-3 2-row-3 profile_id account_ids (matriz, ID suplementario) other_attributes customer_001 [ACC-1001, ACC-1002] … customer_002 [ACC-2001] … En este ejemplo, Journey Optimizer genera dos instancias de recorrido para
customer_001(una por identificador de cuenta) y otra paracustomer_002. Esto se comporta de forma coherente con el funcionamiento del ID suplementario para las audiencias del servicio de perfil unificado.
Cómo se configura external-configuration
Para audiencias CSV con el Caso de uso 1 (donde la audiencia contiene intencionadamente varias filas para el mismo ID de perfil), debe habilitar la activación rápida antes de configurar la recorrido. Consulte el requisito previo a continuación. Para el resto de los casos, configure el recorrido directamente.
| note important |
|---|
| IMPORTANT |
Este requisito previo se aplica solo a las audiencias CSV donde la audiencia contiene intencionadamente varias filas para el mismo ID de perfil (Caso de uso 1). Las audiencias de Composición de audiencia federada tienen habilitada la activación rápida de forma predeterminada y no requieren este paso. La interfaz de usuario de Audience Portal no admite la configuración expressActivation; debe utilizar la API de Audiencia externa. |
Debe habilitar expressActivation en la audiencia en el momento de la creación. Esto indica a Journey Optimizer que active cada registro de forma independiente, sin anulación de duplicación por ID de perfil. Este indicador no se puede cambiar una vez creada la audiencia.
Utilice la siguiente llamada de API al crear la audiencia:
Punto final:
| code language-http |
|---|
|
Encabezados obligatorios:
| code language-http |
|---|
|
Cuerpo de la solicitud (conjunto expressActivation: true):
| code language-json |
|---|
|
| note |
|---|
| NOTE |
expressActivation toma como valor predeterminado false. Debe configurarse en el momento de la creación de la audiencia y no se puede cambiar después de la creación. Todas las audiencias de Composición de audiencia federada tienen la activación rápida habilitada de forma predeterminada y no requieren este indicador. |
Consulte la documentación de la API de creación de audiencias externas para obtener toda la información.
Para configurar el recorrido:
- Abra o cree un recorrido con un nodo Leer audiencia.
- En la configuración del nodo Leer audiencia, seleccione su audiencia CSV o de Composición de audiencia federada.
- Active la opción Usar identificador suplementario y, a continuación, en el campo Identificador suplementario, use el editor de expresiones en Modo avanzado para elegir el atributo que desee usar como identificador secundario (por ejemplo,
account_id,order_number). - El atributo seleccionado se trata como el ID suplementario para el recorrido; no se requiere registro de identidad.
Comportamiento de deduplicación external-dedup
Cuando una audiencia tiene habilitada la activación rápida (siempre es true para la composición de audiencias federada; debe establecerse explícitamente para CSV), Journey Optimizer administra la anulación de duplicación en función de cómo se configure el recorrido:
Casos de uso de ejemplo
Estos ejemplos muestran cómo los identificadores suplementarios admiten varios registros relacionados.
Notificaciones de renovación de directivas
-
Escenario: un proveedor de seguros envía recordatorios de renovación por cada póliza activa que posea un cliente.
-
Ejecución:
- Perfil: “John”.
- Identificadores suplementarios:
"AutoPolicy123", "HomePolicy456". - El recorrido se ejecuta por separado para cada póliza, con fechas de renovación personalizadas, detalles de cobertura e información sobre primas.
Administración de suscripciones
-
Escenario: un servicio de suscripción envía mensajes personalizados para cada suscripción cuando se activa un evento para esa suscripción.
-
Ejecución:
- Perfil: “Jane”.
- Identificadores suplementarios:
"Luma Yoga Program ", "Luma Fitness Program". - Cada evento incluye un ID de suscripción y detalles sobre dicha suscripción. El recorrido se ejecuta por separado para cada evento/suscripción, lo que permite ofertas de renovación personalizadas por suscripción.
Recomendaciones de productos
-
Escenario: una plataforma de comercio electrónico envía recomendaciones basadas en productos específicos comprados por un cliente.
-
Ejecución:
- Perfil: “Alex”.
- Identificadores suplementarios:
"productID1234", "productID5678". - El recorrido se ejecuta por separado para cada producto, con oportunidades de ampliación de venta personalizadas.
Vídeo práctico video
Obtenga información sobre cómo habilitar y aplicar un identificador suplementario en Adobe Journey Optimizer.