Resolución de problemas de ejecución de recorrido activo troubleshooting-execution
En esta sección, aprenderá a solucionar problemas de eventos de recorrido, comprobar si los perfiles han introducido el recorrido, cómo navegan por él y si se envían mensajes.
También puede solucionar errores antes de probar o publicar un recorrido. Obtenga información sobre cómo en esta página.
Si usa acciones entrantes, aprenda a solucionarlas en esta página.
Compruebe que los eventos se envían correctamente checking-that-events-are-properly-sent
El punto de partida de un recorrido es siempre un evento. Puede hacer pruebas con herramientas como Postman.
Puede comprobar si la llamada API que envía a través de estas herramientas se envía correctamente o no. Si vuelve a recibir un error, significa que la llamada tiene un problema. Vuelva a comprobar la carga útil, el encabezado (y especialmente el ID de organización) y la dirección URL de destino. Puede preguntar a su administrador cuál es la dirección URL correcta para visitar.
Los eventos no se insertan directamente del origen a los recorridos. De hecho, los recorridos dependen de las API de ingesta de transmisión de Adobe Experience Platform. Como resultado, en caso de problemas relacionados con el evento, puede consultar Documentación de Adobe Experience Platform para la solución de problemas de las API de ingesta de transmisión.
Si el recorrido no puede habilitar el modo de prueba con el error ERR_MODEL_RULES_16, asegúrese de que el evento usado incluya un área de nombres de identidad al usar una acción de canal.
El área de nombres de identidad se utiliza para identificar los perfiles de prueba de forma exclusiva. Por ejemplo, si se usa el correo electrónico para identificar los perfiles de prueba, se debe seleccionar el área de nombres de identidad Correo electrónico. Si el identificador único es el número de teléfono, se debe seleccionar el área de nombres de identidad Teléfono.
Comprobar si las personas entran en el recorrido checking-if-people-enter-the-journey
El informe de recorridos mide las entradas de la gente en un recorrido en tiempo real.
Si se consigue enviar el evento pero no se ve ninguna entrada en el recorrido, hay un problema entre el envío del evento y la recepción del evento en el recorrido.
Puede comenzar la resolución de problemas con las preguntas siguientes:
-
¿Seguro que el recorrido en el que espera el evento entrante está en modo de prueba o activo?
-
¿Ha guardado el evento antes de copiar la carga útil de la previsualización de carga útil?
-
¿Su carga útil de evento contiene un ID de evento?
-
¿Ha marcado la dirección URL correcta?
-
¿Ha seguido la estructura de carga útil de las API de ingesta de streaming, utilizando la previsualización de estructura de carga útil del panel de configuración de evento? Consulte esta página.
-
¿Utilizó los pares clave-valor correctos en el encabezado del evento?
code language-none X-gw-ims-org-id - your organization's ID Content-type - application/json
Comprobar cómo navegan las personas por el recorrido checking-how-people-navigate-through-the-journey
La creación de informes de recorrido mide el progreso de las personas dentro de un recorrido. Es fácil identificar dónde y por qué detuvieron a una persona.
A continuación se presentan algunas cosas para comprobar:
- ¿Se debe a una condición que excluye a la persona? Por ejemplo, la condición es "género = hombre" y la persona es mujer. Esta comprobación puede realizarla un usuario empresarial si la condición no es demasiado compleja.
- ¿Se debe a que una llamada a una fuente de datos no responde? Cuando el recorrido está en prueba, esta información se puede ver en los registros del modo de prueba. Cuando el recorrido está activo, un administrador puede probar las llamadas directas a la fuente de datos y comprobar la respuesta recibida. Un administrador también puede realizar el duplicado del recorrido y probarlo.
Comprobar que los mensajes se envíen correctamente checking-that-messages-are-sent-successfully
Si las personas recorren el recorrido correctamente pero no reciben mensajes que deberían recibir, puede comprobar lo siguiente:
- Journey Optimizer ha tenido en cuenta correctamente la solicitud para enviar el mensaje. Los usuarios empresariales pueden acceder al mensaje que se supone que se debe enviar y comprobar si la hora de la última ejecución corresponde al tiempo de ejecución de su recorrido. También pueden consultar las últimas llamadas o eventos de API recibidas.
- Journey Optimizer ha enviado correctamente el mensaje. Compruebe los informes de recorrido para asegurarse de que no hay errores.
En el caso de un mensaje enviado mediante una acción personalizada, lo único que se puede comprobar durante la prueba de recorrido es el hecho de que la llamada del sistema de la acción personalizada produce un error o no. Si la llamada al sistema externo asociada con la acción personalizada no genera un error pero no conduce al envío de un mensaje, algunas investigaciones deben realizarse en el sistema externo.
Explicación de las entradas duplicadas en eventos de paso de Recorrido duplicate-step-events
¿Por qué veo varias entradas con la misma instancia de recorrido, perfil, nodo e ID de solicitud?
Al consultar los datos de Eventos de paso de Recorrido, puede observar ocasionalmente lo que parecen ser entradas de registro duplicadas para la misma ejecución de recorrido. Estas entradas comparten valores idénticos para:
profileID- La identidad del perfilinstanceID: el identificador de instancia de recorridonodeID: el nodo de recorrido específicorequestID- El identificador de la solicitud
Sin embargo, estas entradas tienen diferentes valores de _id, que es el indicador clave que distingue este escenario de la duplicación de datos real.
¿Qué causa este comportamiento?
Esto se debe a las operaciones de escalado automático del servidor (también denominadas "reequilibrio") en la arquitectura de microservicios de Adobe Journey Optimizer. Durante períodos de alta carga u optimización del sistema:
- Un evento de paso de recorrido comienza a procesarse y se registra en el conjunto de datos de eventos de paso de Recorrido
- Una operación de escalado automático redistribuye la carga de trabajo entre instancias de servicio
- Otra instancia de servicio puede volver a procesar el mismo evento y crear una segunda entrada de registro con un
_iddiferente
Se trata de un comportamiento esperado del sistema y funciona según lo diseñado.
¿Afecta a la ejecución del recorrido o a la entrega de mensajes?
No.: el impacto se limita solamente al registro. Adobe Journey Optimizer tiene mecanismos de deduplicación integrados en la capa de ejecución de mensajes que garantizan lo siguiente:
- Solo se envía un mensaje (correo electrónico, SMS, notificación push, etc.) a cada perfil
- Las acciones se ejecutan solo una vez
- La ejecución del recorrido se realiza correctamente
Puede comprobarlo consultando los ajo_message_feedback_event_dataset o comprobando los registros de ejecución de acciones. Verá que solo se envió un mensaje, a pesar de las entradas de evento de paso de recorrido duplicadas.
¿Cómo puedo identificar estos casos en mis consultas?
Al analizar los datos de Eventos de paso de Recorrido:
-
Compruebe el campo
_id: Los duplicados verdaderos en el nivel de sistema tendrían el mismo_id. Valores diferentes de_idindican entradas de registro independientes del escenario de reequilibrio descrito anteriormente. -
Verificar entrega de mensajes: haga referencia cruzada con datos de comentarios de mensajes para confirmar que solo se envió un mensaje:
code language-sql SELECT timestamp, _experience.customerJourneyManagement.messageExecution.messageExecutionID, _experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus FROM ajo_message_feedback_event_dataset WHERE _experience.customerJourneyManagement.messageExecution.journeyVersionID = '<journeyVersionID>' AND TO_JSON(identityMap) like '%<profileID>%' ORDER BY timestamp DESC; -
Agrupar por identificadores únicos: Al contar las ejecuciones, use
_idpara obtener recuentos precisos:code language-sql SELECT COUNT(DISTINCT _id) as unique_executions FROM journey_step_events WHERE _experience.journeyOrchestration.stepEvents.journeyVersionID = '<journeyVersionID>' AND _experience.journeyOrchestration.stepEvents.profileID = '<profileID>'
¿Qué debo hacer si observo esto?
Este es un comportamiento normal del sistema y no se requiere ninguna acción. El registro duplicado no indica un problema con la configuración del recorrido o la entrega de mensajes.
Si está creando informes o análisis basados en Eventos de pasos de Recorrido:
- Usar
_idcomo clave principal para contar eventos únicos - Referencia cruzada con conjuntos de datos de comentarios de mensajes al analizar el envío de mensajes
- Tenga en cuenta que el análisis de tiempo puede mostrar entradas agrupadas con unos segundos de diferencia
Para obtener más información sobre la consulta de eventos de paso de Recorrido, vea Ejemplos de consultas.
Solucionar discrepancias de métricas del panel dashboard-metrics
Si las métricas mostradas en el panel Información general no coinciden con el número real de recorridos en la pestaña Examinar, compruebe lo siguiente:
- Asegúrese de que los recorridos en cuestión hayan tenido tráfico en las últimas 24 horas, ya que los recorridos sin actividad reciente se excluyen del panel.
- Compruebe que dispone de los permisos de acceso adecuados para ver todos los recorridos de su organización.
- Conceda un máximo de 30 minutos para que las métricas se actualicen después de realizar cambios en los recorridos.
Si persisten las discrepancias, póngase en contacto con el Soporte técnico de Adobe con capturas de pantalla de las pestañas Información general y Examinar para investigar.