Uso de una audiencia en un recorrido segment-trigger-activity
Utilice la actividad Leer audiencia para iniciar recorridos con audiencias definidas. Elija la audiencia y cuándo se ejecuta; a continuación, utilice condiciones, temporizadores y acciones para personalizar la ruta de cada perfil.
Acerca de la actividad Leer público about-segment-trigger-activity
La actividad Leer audiencia es la actividad de punto de entrada de recorrido que agrega todos los perfiles de una audiencia Adobe Experience Platform seleccionada a un recorrido. Puede ejecutar la entrada una vez o en una programación recurrente. En las API y referencias técnicas, esta actividad también se denomina entrada de recorrido basada en segmentos o déclencheur de audiencias.
Cuándo usar Audiencia de lectura frente a Calificación de audiencias
Límites clave: Una audiencia de lectura por recorrido (debe ser la primera actividad); una audiencia por actividad; hasta cinco ejecuciones simultáneas de Audiencia de lectura por organización; 20 000 perfiles por segundo por zona protegida; tiempo de espera de trabajo de 12 horas. Detalles completos en Protecciones y recomendaciones.
Requisitos previos: Una audiencia de Adobe Experience Platform que se ha creado y evaluado (estado Realized), un área de nombres de identidad basada en personas seleccionada para el recorrido y, para ejecuciones recurrentes, una comprensión de los límites de programación y rendimiento.
Por ejemplo, la audiencia Luma app opening and checkout creada en el caso de uso Generar audiencias se puede usar como punto de entrada. Todos los perfiles cualificados entran en el recorrido y progresan a través de rutas individualizadas mediante condiciones, temporizadores, eventos y acciones.
➡️ Descubra esta funcionalidad en vídeo
- Antes de usar la actividad Leer audiencia, lea las protecciones y limitaciones.
Configuración de la actividad configuring-segment-trigger-activity
Establecerá: Audiencia (obligatoria), Espacio de nombres (obligatorio), Velocidad de lectura (obligatoria, predeterminada 5.000/s) y Programación (cuando se ejecute el recorrido). Opcionalmente, agregue Label y Supplemental identifier. Los pasos a continuación le guían por cada configuración.
Añadir actividad y seleccionar audiencia add-activity-and-select-audience
-
Despliegue la categoría Orchestration y suelte una actividad Leer audiencia en el lienzo.
La actividad debe colocarse como el primer paso de un recorrido.
-
Agregue una Etiqueta a la actividad (opcional). Una etiqueta opcional le ayuda a identificar la actividad en los registros del modo de prueba y creación de informes.
-
En el campo Audiencia, elija la audiencia Adobe Experience Platform que entrará al recorrido y luego haga clic en Guardar. Puede seleccionar cualquier audiencia de Adobe Experience Platform generada mediante definiciones de segmento.
note note NOTE Además, puede segmentar Adobe Experience Platform audiencias creadas con composiciones de audiencias.
También puede segmentar audiencias cargadas desde un archivo CSV.
Más información acerca de cómo generar y segmentar audiencias en Journey Optimizer.Tenga en cuenta que puede personalizar las columnas mostradas en la lista y ordenarlas.
Una vez agregada la audiencia, el botón Copiar le permite copiar su nombre e ID:
{"name":"Luma app opening and checkout","id":"8597c5dc-70e3-4b05-8fb9-7e938f5c07a3"}
note note NOTE Solo las personas con el estado de participación en la audiencia Realized entrarán al recorrido. Para obtener más información sobre cómo evaluar una audiencia, consulte la documentación del servicio de segmentación. -
En el campo Espacio de nombres, elija el espacio de nombres que desea utilizar para identificar a los individuos. De forma predeterminada, el campo está rellenado previamente con el último área de nombres utilizado. Más información sobre áreas de nombres.
note note NOTE Las personas que pertenecen a una audiencia que no tiene la identidad seleccionada (área de nombres) entre sus diferentes identidades no pueden entrar en el recorrido. Solo puede seleccionar un área de nombres de identidad basada en personas. Si ha definido un área de nombres para una tabla de búsqueda (por ejemplo: área de nombres ProductID para una búsqueda de productos), no estará disponible en la lista desplegable Área de nombres.
Identificador suplementario read-audience-supplemental-id
Si lo desea, puede habilitar Usar un identificador suplementario para ejecutar el recorrido en el contexto de un identificador secundario (por ejemplo, un identificador de pedido o un identificador de reserva) además del identificador de perfil. Esto permite varias entradas del mismo perfil cuando el identificador suplementario es diferente.
Aprenda a utilizar identificadores suplementarios en recorrido. Para los recorridos de audiencia de lectura, el identificador suplementario debe ser un atributo de perfil; la tasa de lectura está limitada a 500 perfiles por segundo cuando se utiliza un ID suplementario.
Mecanismos de protección y recomendaciones must-read
-
Solo se puede usar una actividad Leer audiencia en un recorrido, y debe ser la primera actividad en el lienzo.
-
La actividad Leer audiencia solo puede dirigirse a una audiencia. Si se requieren varias audiencias, considere la posibilidad de combinarlas en una sola antes de utilizarlas. Aprenda a combinar audiencias mediante flujos de trabajo de composición
-
Para los recorridos que utilizan una actividad Leer público, existe un número máximo de recorridos que pueden comenzar al mismo tiempo. El sistema realizará los reintentos. Sin embargo, evite tener más de cinco recorridos (con Leer audiencia, programados o que se inicien "lo antes posible") que empiecen al mismo tiempo. La práctica recomendada es difundirlas a lo largo del tiempo, por ejemplo, con una diferencia de 5 a 10 minutos.
-
Los grupos de campos de evento de experiencia no se pueden usar en recorridos que comiencen por una actividad de Leer audiencia, una actividad de calificación de audiencia o una actividad de evento empresarial.
-
Como práctica recomendada, recomendamos que solo use audiencias por lotes en una actividad Leer audiencia. Esto proporciona un recuento fiable y coherente de las audiencias utilizadas en un recorrido. La audiencia de lectura está diseñada para casos de uso por lotes. Si su caso de uso necesita datos en tiempo real, utilice la actividad Calificación de audiencias.
-
Las audiencias importadas desde un archivo CSV o resultantes de flujos de trabajo de composición se pueden seleccionar en la actividad Leer audiencia. Estas audiencias no están disponibles en la actividad Calificación de audiencias.
-
Límite de audiencia de lectura simultánea por organización: cada organización puede ejecutar hasta cinco instancias de audiencia de lectura simultáneamente. Esto incluye tanto las ejecuciones programadas como las activadas por eventos empresariales. El límite se aplica a todos los entornos limitados y recorridos. Este límite se impone para garantizar una asignación justa y equilibrada de los recursos en todas las organizaciones.
-
Administración del rendimiento de la zona protegida: el sistema administra dinámicamente el rendimiento de procesamiento por zona protegida con un límite máximo de 20 000 perfiles por segundo compartidos en todas las actividades de Lectura de audiencias. Las actividades de Audiencia de lectura individuales se pueden configurar con una velocidad mínima de 500 perfiles por segundo. Si se alcanzan los límites de rendimiento de nivel de zona protegida, los trabajos pueden colocarse en cola para garantizar una asignación de recursos justa.
-
Tiempo de espera de procesamiento de trabajo: los trabajos de lectura de audiencia que no se puedan procesar en un plazo de 12 horas debido a los límites de protección se limpiarán automáticamente y nunca se ejecutarán. Esto evita la acumulación de trabajos y garantiza la estabilidad del sistema.
-
Cuando utilice segmentos por lotes, asegúrese de que la ingesta y las actualizaciones diarias de instantáneas se hayan completado mucho antes de que comience el recorrido. Considere un período de espera adicional si los segmentos deben reflejar los datos introducidos el mismo día. Si la actualización inmediata del perfil es crítica, utilice un método basado en eventos o de flujo continuo en lugar de un método diario por lotes. Como alternativa, inserte un mecanismo de espera para permitir que los datos actualizados se propaguen antes de la evaluación del recorrido.
Las protecciones relacionadas con la actividad Leer audiencia se enumeran en esta página.
Siguiente: Establezca la tasa de lectura y la programación, luego prueba y publicación.
Entrada de perfil y tasa de lectura profile-entry-and-reading-rate
Establezca la tasa de lectura (obligatoria). Es el número máximo de perfiles que pueden entrar en el recorrido por segundo. Esta tasa se aplica solamente a esta actividad y a ninguna otra en el recorrido. Si desea definir una tasa de regulación en acciones personalizadas, por ejemplo, debe utilizar la API de regulación. Consulte esta página.
Este valor se almacena en la carga útil de la versión de recorrido. El valor predeterminado es de 5000 perfiles por segundo. Puede modificar este valor de 500 a 20 000 perfiles por segundo.
Programación del recorrido schedule
De forma predeterminada, los recorridos están configurados para ejecutarse una vez. Para definir una fecha/hora y una frecuencia específicas en las que debe ejecutarse el recorrido, siga los pasos a continuación.
-
En las propiedades de la actividad Leer audiencia, seleccione Editar programación de recorrido.
-
Se muestran las propiedades del recorrido. En la lista desplegable Tipo de programador, seleccione la frecuencia con la que desea que se ejecute el recorrido.
En el caso de los recorridos recurrentes, hay opciones específicas disponibles para ayudarle a administrar la entrada de perfiles en el recorrido. Expanda las secciones siguientes para obtener más información sobre cada opción.
Cuando se ejecuta por primera vez un recorrido con una audiencia de lectura recurrente, todos los perfiles de la audiencia entran en el recorrido. Esta opción le permite dirigirse, después de la primera incidencia, solo a las personas que ingresaron a la audiencia desde la última ejecución del recorrido.
Al utilizar esta opción, el sistema retrocede 24 horas desde el último trabajo de evaluación de audiencia realizado por el servicio de segmentación de Adobe Experience Platform.
Una vez finalizada la segmentación, se inicia un trabajo de exportación de instantáneas de perfil que permite a Journey Optimizer detectar y procesar nuevos perfiles. Si el recorrido está programado entre estos dos trabajos, la lectura incremental no recogerá perfiles que se hayan convertido en miembros de la audiencia desde la última ejecución del recorrido.
Para minimizar el riesgo de que falten perfiles:
- Habilite la opción Déclencheur después de la evaluación de audiencia por lotes para extender el período retrospectivo al momento de la última ejecución correcta del recorrido, independientemente de cuánto tiempo haya transcurrido
- Programe recorridos para que se ejecuten bien después de que se completen los trabajos diarios de segmentación por lotes (normalmente, de 2 a 3 horas de búfer)
- En los casos de uso en los que el tiempo es un factor crítico y que requieren la inclusión inmediata de perfiles, considere la posibilidad de usar actividades de Calificación de audiencias con audiencias de streaming en su lugar
| note caution |
|---|
| CAUTION |
| Si va a segmentar una audiencia de carga personalizada en su recorrido, los perfiles solo se recuperan en la primera periodicidad cuando esta opción está habilitada en un recorrido recurrente. Estas audiencias son fijas. |
Esta opción le permite hacer que todos los perfiles que aún están presentes en la recorrido se cierren automáticamente en la siguiente ejecución.
Por ejemplo, si tiene una espera de 2 días en un recorrido recurrente diario, al activar esta opción los perfiles se mueven a la siguiente ejecución del recorrido. Esto sucede al día siguiente, tanto si se encuentran en la audiencia de próxima ejecución como si no.
Si la duración de los perfiles en este recorrido puede ser mayor que la periodicidad, no active esta opción para asegurarse de que los perfiles puedan finalizar su recorrido.
Para los recorridos programados a diario y dirigidos a audiencias por lotes, puede definir un período de tiempo de hasta 6 horas para que el recorrido espere datos de audiencia nuevos de los trabajos de segmentación por lotes. Si el trabajo de segmentación se completa dentro del intervalo temporal, el recorrido se compensa con un déclencheur. De lo contrario, omite el recorrido hasta su siguiente aparición. Esta opción garantiza que los recorridos se ejecuten con datos de audiencia precisos y actualizados.
Por ejemplo, si un recorrido está programado para las 18:00 diariamente, puede especificar un número de minutos u horas de espera antes de que se ejecute el recorrido. Cuando el recorrido se despierta a las 18:00, comprueba si hay una audiencia nueva, es decir, una audiencia más reciente que la utilizada en la ejecución de recorrido anterior. Durante el período de tiempo especificado, el recorrido se ejecutará inmediatamente al detectar la audiencia nueva. Si no se detecta ninguna audiencia nueva, la ejecución del recorrido se omitirá ese día.
Prueba y publicación del recorrido testing-publishing
La actividad Leer audiencia le permite probar el recorrido en un perfil unitario.
Para ello, active el modo de prueba.
Configure y ejecute el modo de prueba como de costumbre. Aprenda a probar un recorrido.
Una vez que se esté ejecutando la prueba, el botón Mostrar registros le permite ver los resultados de la prueba. Para obtener más información, consulte esta sección
Una vez que las pruebas se hayan realizado correctamente, puede publicar el recorrido (consulte Publicación del recorrido). Las personas que pertenezcan a la audiencia ingresarán al recorrido en la fecha y hora especificadas en la sección de propiedades del recorrido Programador.
Segmentación de audiencia en recorrido
Los recorridos basados en audiencias siempre comienzan con una actividad Leer audiencia para recuperar personas que pertenecen a una audiencia Adobe Experience Platform. Estos perfiles se leen una vez o en una programación recurrente.
Una vez que entran en el recorrido, se organizan mediante actividades Condition: segmentar por atributos o comportamiento, excluir parte de la población o volver a combinar ramas (union). Las secciones a continuación describen cada patrón.
Segmentación
Puede usar condiciones para realizar la segmentación con la actividad Condition. Por ejemplo, puede hacer que las personas de VIP sigan una ruta determinada y que los que no son de VIP sigan otra ruta.
La segmentación se puede basar en:
- datos de fuente de datos
- el contexto de los eventos forma parte de los datos de recorrido, por ejemplo: ¿hizo una persona clic en el mensaje recibido hace una hora?
- una fecha, por ejemplo: ¿estamos en junio cuando una persona pasa por el recorrido?
- una hora, por ejemplo: ¿es por la mañana en la zona horaria de la persona?
- algoritmo que divide la audiencia que fluye en el recorrido en función de un porcentaje. Por ejemplo: 90 % - 10 % para excluir un grupo de control
Exclusión
La misma actividad Condition utilizada para la segmentación (ver arriba) también le permite excluir parte de la población. Por ejemplo, puede excluir a personas de VIP convirtiéndolas en una rama con un paso final justo después.
Esta exclusión puede producirse justo después de la recuperación de la audiencia, con fines de recuento de población o a lo largo de un recorrido de varios pasos.
Unión
Los recorridos le permiten crear N ramas y unirlas después de una segmentación. Como resultado, puede hacer que dos audiencias vuelvan a una experiencia común.
Por ejemplo, después de seguir una experiencia diferente durante diez días en un recorrido, los clientes de VIP y no de VIP pueden volver a la misma ruta. Después de una unión, puede volver a dividir la audiencia realizando una segmentación o una exclusión.
Solución de problemas audience-count-mismatch
Esta sección le ayuda a resolver discrepancias de recuento de público (menos perfiles o más que los esperados), cero perfiles procesados (leer alerta de audiencia o ninguna entrada) y entradas retrasadas o faltantes (temporización y propagación de datos).
segmentExportJob eventos) para realizar un seguimiento del ciclo de vida de la operación de exportación de audiencia. Estos eventos se registran en el nivel de actividad, no por perfil individual, y se pueden consultar para fines de monitorización y resolución de problemas. Más información sobre consultar eventos de audiencia de lectura.Encuentre su problema:
Cero perfiles procesados zero-profiles-processed
Si la actividad Leer audiencia no ha procesado ningún perfil (por ejemplo, ve la alerta Leer audiencia):
- Comprobar si la audiencia está vacía - En Adobe Experience Platform, comprobar el tamaño de la audiencia y que los perfiles están en estado Realizado. Una audiencia vacía o aún no evaluada generará cero entradas.
- Comprobar área de nombres: el área de nombres seleccionado en la actividad Leer audiencia debe estar presente en los perfiles de su audiencia. Los perfiles sin esa identidad no pueden entrar en el recorrido. Más información sobre áreas de nombres.
- Alertas de revisión y reintentos - Se notifican errores en Alertas. El sistema reintenta la creación de trabajos de exportación cada 10 minutos durante un máximo de 1 hora. Más información sobre reintentos y alertas.
Si el problema persiste después de estas comprobaciones, consulte Validación y supervisión de datos y Validación y supervisión de datos para causas de configuración y lotes.
Tiempo y propagación de datos timing-and-data-propagation
-
Finalización del trabajo de segmentación por lotes: Para las audiencias por lotes, asegúrese de que el trabajo de segmentación por lotes diario se haya completado y de que las instantáneas se actualicen antes de que se ejecute el recorrido. Las audiencias por lotes están listas para usarse aproximadamente 2 horas después de que se complete el trabajo de segmentación. Más información sobre métodos de evaluación de audiencia.
-
Tiempo de ingesta de datos: compruebe que la ingesta de datos de perfil se haya completado completamente antes de la ejecución del recorrido. Si los perfiles se incorporaron poco antes de que comenzara el recorrido, es posible que aún no se reflejen en la audiencia. Más información sobre la ingesta de datos en Adobe Experience Platform.
-
Use la opción "Déclencheur después de la evaluación de audiencia por lotes": para los recorridos programados diarios que usan audiencias por lotes, considere la posibilidad de habilitar la opción Déclencheur después de la evaluación de audiencia por lotes. Esto garantiza que el recorrido espere a que se produzcan nuevos datos de audiencia (hasta 6 horas) antes de ejecutarse. Más información sobre la programación
-
Agregar una actividad de espera: Para las audiencias de streaming con datos ingeridos recientemente, considere la posibilidad de agregar una actividad Wait al principio del recorrido para permitir tiempo para la propagación de datos y la calificación de perfiles. Más información sobre la actividad de espera
Validación de datos data-validation-and-monitoring
-
Comprobar el estado del trabajo de segmentación: supervise las horas de finalización del trabajo de segmentación por lotes en el Adobe Experience Platform panel de monitorización. Utilícelo para verificar cuándo están listos los datos de audiencia.
-
Verificar políticas de combinación: Asegúrese de que la política de combinación configurada para su audiencia coincida con el comportamiento esperado para combinar datos de perfil de diferentes fuentes. Más información sobre políticas de combinación en Adobe Experience Platform.
-
Revisar definiciones de segmentos: Confirme que las definiciones de segmentos están configuradas correctamente e incluyan todos los criterios de calificación esperados. Más información sobre cómo generar audiencias. Preste especial atención a:
- Condiciones basadas en el tiempo que pueden excluir perfiles basados en marcas de tiempo de eventos
- Cualificaciones de atributo que dependen de datos actualizados recientemente
- Métodos de evaluación de flujo frente a lotes
-
Validar configuración del área de nombres: Asegúrese de que el área de nombres seleccionado en la actividad Leer audiencia coincida con la identidad principal utilizada por los perfiles de su audiencia. Los perfiles sin el área de nombres seleccionada no entrarán en el recorrido. Más información sobre áreas de nombres de identidad.
Prácticas recomendadas
-
Programar recorridos después de la segmentación: Para audiencias por lotes, programe la ejecución de recorridos al menos de 2 a 3 horas después del tiempo de finalización del trabajo de segmentación por lotes habitual. Más información sobre la programación de recorridos
-
Use audiencias de streaming para casos de uso en tiempo real: Si necesita calificación inmediata del perfil y entrada de recorrido, use las actividades de Calificación de audiencias con audiencias de streaming en lugar de Leer audiencia con audiencias por lotes.
-
Primero realice pruebas con audiencias más pequeñas: antes de iniciar recorridos a gran escala, realice pruebas con un subconjunto más pequeño para comprobar que los recuentos coinciden con las expectativas. Aprenda a probar un recorrido
-
Monitorizar con regularidad: configure una monitorización regular de los tamaños de audiencia y las métricas de entrada de recorrido para detectar discrepancias de forma temprana. Obtenga más información acerca de tasas de procesamiento de recorridos y administración de entradas.
Cuándo ponerse en contacto con el soporte
Si el recuento no coincide o las ejecuciones de perfil cero persisten después de seguir los pasos anteriores, póngase en contacto con el soporte de Adobe. Tenga listo: nombre/ID de audiencia, nombre/ID de recorrido, tiempo(s) de ejecución programado, zona protegida y una breve descripción de la discrepancia (por ejemplo, "La audiencia muestra 10 000 realizados, solo 2 000 ingresaron al recorrido el [date]").
Reintentos read-audience-retry
Los reintentos ahora se aplican de forma predeterminada en recorridos activados por públicos destinatarios (empezando con una actividad Leer público o Evento empresarial) cuando se recupera el trabajo de exportación. Si se produce un error durante la creación del trabajo de exportación, se realizarán reintentos cada 10 minutos, hasta un máximo de 1 hora. Después de esto, se considerará como un error. Por lo tanto, estos tipos de recorridos se pueden ejecutar hasta una hora después de la hora programada.
Los déclencheur de Lectura de audiencia que no se han realizado correctamente se capturan y se muestran en Alertas. La alerta Leer audiencia le advierte si una actividad de Leer audiencia no ha procesado ningún perfil 10 minutos después de la hora de ejecución programada. Este error puede deberse a problemas técnicos o a una audiencia vacía. Si el error se debe a problemas técnicos, aún pueden producirse reintentos según el tipo de problema. Por ejemplo, si la creación del trabajo de exportación falla, lo reintentamos cada 10 minutos durante un máximo de 1 hora. Más información
Temas relacionados
Vídeo práctico video
Comprenda los casos de uso pertinentes para un recorrido que se desencadena por la actividad de lectura del público. Obtenga información sobre cómo crear recorridos basados en lotes y qué prácticas recomendadas aplicar.