función inAudience inAudience

Restricciones importantes:

• El nombre de la audiencia debe ser una constante de cadena
• No puede ser una referencia de campo o una expresión
• Puede recuperar hasta 100 audiencias en un solo recorrido

inAudience(<string>)

Devuelve un valor booleano:

• true: el individuo es miembro de la audiencia (estado realizado)

• false: el individuo no es miembro de la audiencia (estado de salida)

inAudience("men over 50")

Devuelve true si el individuo de la instancia de recorrido es parte de la audiencia de Adobe Experience Platform denominada “hombres de más de 50 años”, false en caso contrario.

Casos de uso prácticos:

// Simple audience check in a condition
inAudience("Premium Customers") == true

// Multiple audience evaluation
inAudience("High Value Customers") == true AND inAudience("Active Last 30 Days") == true

// Negation check
inAudience("Unsubscribed") == false

Esta sección contiene conocimientos estructurados destinados a apoyar la interpretación, la recuperación y la respuesta a preguntas relacionadas con este tema.

Para una comprensión completa, esta información debe combinarse con la documentación de esta página. Ninguna de las fuentes pretende ser independiente; la página describe la función, mientras que esta sección proporciona contexto adicional que ayuda a desambiguar la terminología, la intención, la aplicabilidad y las restricciones.

• TL;DR: Esta página documenta la función inAudience, que comprueba en tiempo real si un perfil de recorrido pertenece a una audiencia de Adobe Experience Platform con nombre y devuelve un valor booleano utilizado en condiciones de recorrido.

Intenciones:

• Bifurcar una ruta de recorrido en función de si un perfil es miembro de una audiencia específica mediante inAudience
• Combine varias comprobaciones inAudience con la lógica AND/OR para crear condiciones de segmentación complejas
• Compruebe que un perfil no ha ingresado a una audiencia específica mediante una comprobación de negación (inAudience("...") == false)
• Comprenda las diferencias de tiempo de propagación entre Leer recorridos de Audiencia y recorridos de evento unitario
• Identificar y corregir referencias de audiencias rotas causadas por cambios de nombre de audiencias en Adobe Experience Platform

Glosario:

• Realizado: estado de participación de audiencia que indica que el individuo cumple actualmente los requisitos para la definición de audiencia y es un miembro activo (específico del producto)
• Salido: estado de participación de audiencia que indica que el individuo ha abandonado la audiencia y ya no califica (específico del producto)
• Política de combinación: Regla de Adobe Experience Platform que determina cómo se combinan los datos de perfil de varios conjuntos de datos al evaluar la pertenencia a audiencias (específica del producto)
• Proyección por lotes: el almacén de datos de perfil se actualizó según una programación (en las 2 horas siguientes a la ingesta) usada por Leer recorridos de audiencia (específico del producto)
• Proyección de streaming: El almacén de datos de perfil en tiempo real (normalmente disponible en 15 minutos) que se usa en los recorridos de eventos unitarios y después de las actividades de espera (específico del producto)

Protecciones:

• Un solo recorrido puede recuperar hasta 100 audiencias
• El parámetro de nombre de audiencia debe ser una constante de cadena; no se admiten referencias de campo ni expresiones dinámicas
• Cambiar el nombre de una audiencia en Adobe Experience Platform no actualiza automáticamente las referencias de inAudience en las expresiones de recorrido: se requieren actualizaciones manuales
• Las políticas de combinación incoherentes en varias audiencias utilizadas en el mismo recorrido pueden provocar errores o alertas

Terminología:

• Nombre canónico: inAudience — Acrónimo: none — variantes: inSegment (nombre heredado)
• Sinónimos: “inAudience” = “función de comprobación de pertenencia a audiencia”
• No confunda: “Realized” (miembro activo) ≠ “Exited” (ya no es miembro)
• No confunda: “inAudience” (función actual) ≠ “inSegment” (función heredada obsoleta)

PREGUNTAS MÁS FRECUENTES:

• Q: ¿Qué devuelve inAudience cuando un perfil ha salido de la audiencia? — Devuelve false; solo los perfiles con el estado “Realized” se consideran miembros activos y devuelven true.
• Q: ¿Cuántas audiencias puedo comprobar en un solo recorrido? — Se pueden recuperar hasta 100 audiencias en un solo recorrido.
• Q: ¿Qué sucede si cambio el nombre de una audiencia en Adobe Experience Platform después de usarla en un recorrido? — La expresión de recorrido no se actualiza automáticamente; debe editar manualmente la llamada a inAudience para utilizar el nuevo nombre de audiencia; de lo contrario, se producirá un error en la condición.
• Q: ¿Con qué rapidez está disponible el abono a audiencias después de actualizar el perfil en un recorrido de lectura de audiencias? — En un recorrido de lectura de audiencias antes de una actividad de espera, los datos se leen desde la proyección por lotes actualizada en un plazo de 2 horas tras la ingesta.
• Q: ¿Puedo pasar un atributo de perfil como parámetro de nombre de audiencia? — No, el nombre de audiencia debe ser una constante de cadena; no se admiten referencias de campo ni expresiones.