Solución de problemas de acciones de entrada en recorridos troubleshooting-inbound-actions

En esta página: Aprenda a depurar y resolver problemas comunes con acciones entrantes, como experiencias en la aplicación, web y basadas en código, en un recorrido antes de ponerse en contacto con el servicio de asistencia.

Las acciones entrantes, como las experiencias en la aplicación, web y basadas en código, son componentes esenciales de Journey Optimizer, ya que permiten la participación personalizada con los usuarios durante su recorrido. Sin embargo, se pueden producir comportamientos inesperados, como la falta de contenido entrante o la continuación de la entrega después de que un perfil salga del recorrido.

Esta guía proporciona un proceso paso a paso para depurar los problemas relacionados con las acciones entrantes de un recorrido para ayudarle a identificarlos y resolverlos de forma independiente antes de ponerse en contacto con el servicio de asistencia.

Requisitos previos prerequisites

Antes de iniciar la localización de averías, asegúrese de lo siguiente:

  1. Configurar una sesión de Assurance. Obtenga más información en la Adobe Experience Platform documentación de Assurance.

  2. Vaya al recorrido que contiene la acción entrante para recuperar el nombre del recorrido y el ID de versión.

    note
    NOTE
    El identificador de la versión del recorrido se encuentra en la dirección URL después de "recorrido/" (por ejemplo: 86232fb1-2932-4036-8198-55dfec606fd7).

    Ubicación de ID de Recorrido en la URL de recorrido o en el panel de propiedades

  3. Haga clic en la acción entrante para ver sus detalles. Recupere la etiqueta de acción entrante y el ID.

    ID de acción en la vista de código del panel de configuración de actividad

  4. Obtenga el área de nombres y el ID del perfil para identificar los problemas que encuentra el perfil. En función de su configuración, el área de nombres puede ser ECID, correo electrónico o ID de cliente, por ejemplo. Obtenga información sobre cómo buscar un perfil en la documentación de Experience Platform.

Escenario 1: el usuario no ha recibido el contenido entrante scenario-1

En esta situación, un perfil ha introducido la acción entrante en el recorrido, pero incluso después de 30 minutos, el contenido entrante correspondiente no se muestra en el dispositivo o cliente en el paso del déclencheur de configuración.

Comprobaciones previas pre-checks

  1. El conjunto de datos de entrada de Recorrido está habilitado para la ingesta de perfiles

    La acción de entrada utiliza el conjunto de datos Recorrido de entrada para las actualizaciones de perfil durante la ejecución. Asegúrese de que el conjunto de datos esté habilitado para Perfiles en la zona protegida actual. Más información sobre conjuntos de datos

  2. Identidad ‘joai’ definida en identidades de plataforma

    La acción de entrada usa el espacio de nombres joai en el perfil segmentMembership para activar el perfil para el paso de entrada. Asegúrese de que se haya definido en Identidades de la plataforma para la zona protegida. Más información sobre Servicio de identidad de Experience Platform

Pasos de depuración debugging-steps

El gráfico siguiente muestra la secuencia de pasos de depuración que puede seguir:

No se muestra el flujo de trabajo de solución de problemas del mensaje entrante: comprobar el recorrido, la entrega perimetral y el perfil {align="center" width="70%"}

Paso 1: compruebe si el dispositivo o cliente recibe el contenido de la red perimetral step-1

Comience por comprobar si el dispositivo o cliente obtiene el contenido esperado.

Canal en la aplicación
  1. Vaya a la sesión Assurance y seleccione la sección Mensajería en la aplicación del panel izquierdo.

  2. En la ficha Mensajes del dispositivo, haga clic en la lista desplegable Mensajes.

    Vista de Adobe Assurance que muestra eventos y datos de entrega de mensajes en la aplicación {width="80%"}

  3. Busque un mensaje con el nombre del recorrido seguido de “- Mensaje en la aplicación”. Si está presente, significa que el mensaje en la aplicación está presente en el dispositivo o cliente y el problema podría estar relacionado con el déclencheur en la aplicación.

  4. Si no se encuentra el mensaje, el dispositivo o cliente no recibió el mensaje en la aplicación.

Canal web
Visite la página e inspeccione la pestaña de red o compruebe la carga de respuesta de Edge en la sección Edge Delivery de la sesión Assurance.
Canal de experiencia basado en código
Realice una solicitud de flexión utilizando la API de Adobe y compruebe la carga de respuesta de Edge en la sección Edge Delivery de la sesión Assurance.

Paso 2: compruebe si la red perimetral devuelve el contenido step-2

Este paso es para asegurarse de que Edge Network devuelve el contenido entrante esperado que se procesará en el dispositivo o cliente.

Cuando un perfil introduce una acción entrante en un recorrido, se califica automáticamente en un segmento de audiencia especial (en el área de nombres joai) correspondiente a la acción de recorrido entrante.

Cuando un cliente realiza una solicitud a Edge Network para un perfil y una superficie determinados, el perfil cumple los requisitos para recibir contenido para las acciones de recorrido de entrada dirigidas a esa superficie, solo si el perfil es actualmente miembro del segmento joai correspondiente.

Para depurar el comportamiento de Edge Network, siga los pasos a continuación.

  1. Abra la vista Edge Delivery en la sesión de Assurance. Esta vista proporciona información sobre la ejecución de la acción entrante en el servidor de Edge Network. Obtenga más información en la documentación de Experience Platform.

  2. Compruebe si la actividad de Edge correspondiente a la acción entrante está incluida en las secciones Actividades calificadas o Actividades no calificadas.

    Registros de envío de Edge que muestran propuestas de mensajes enviadas al perfil

    • Si se encuentra en la sección Actividades calificadas, el perfil cumple los requisitos para la acción de recorrido entrante y el contenido debería devolverse.
    • Si en la sección Actividades no calificadas, el perfil no calificó para la acción de recorrido entrante. Consulte los motivos de exclusión para obtener más información.
    • Si en ninguna de las secciones hubo un problema al publicar la acción de recorrido entrante en Edge Network o el URI de superficie solicitado no coincide con los valores de configuración de canal para la acción entrante.
    note
    NOTE
    Para encontrar tu actividad de Edge en la sesión Assurance, busca la actividad donde audienceNamespace es joai y audienceSegmentId es <JourneyVersionID>_<JourneyActionID> (por ejemplo: 86232fb1-2932-4036-8198-55dfec606fd7_708f718d-8503-4427-ad8d-8e28979b554c).

    Error de envío de Edge que muestra que el perfil no cumple los requisitos para el mensaje {width="70%"}

  3. Si su actividad se encuentra en la sección Actividades no calificadas y el motivo de exclusión es ‘El segmento no está activo’, significa que el servidor de entrega de Edge Network no cree que el perfil forme parte del segmento de audiencia joai relevante.

    Puede comprobar si el segmento joai está presente en la vista del perfil del servidor de entrega de Edge Network abriendo el elemento segmentsMap de la sección Perfil y buscando la presencia del ID de segmento joai.

  4. Si el servidor de entrega de Edge Network no ve el perfil como si estuviera en el segmento joai relevante, vaya al paso siguiente.

Paso 3: compruebe si la pertenencia a la audiencia “joai” se ha propagado a la red Edge step-3

Este paso sirve para comprobar que el perfil de Edge se actualizó correctamente cuando el perfil entró en la acción de recorrido entrante y que el perfil se calificó para el segmento joai correspondiente.

Cuando un perfil se clasifica en un segmento joai, el perfil se actualiza primero en el concentrador y, a continuación, la pertenencia al segmento se proyecta al perfil de Edge para que lo utilice el servidor de entrega de Edge Network.

NOTE
La propagación desde Hub a Edge puede tardar entre 15 y 30 minutos desde el momento en que el perfil se actualiza en Hub.

Para comprobar la presencia del segmento joai en el atributo segmentMembership del perfil de Edge, siga los pasos a continuación.

  1. Vaya al menú Cliente > Perfiles en el panel de navegación izquierdo de Journey Optimizer y busque el perfil usando el área de nombres y el ID. Más información sobre Perfiles de clientes en tiempo real

  2. Seleccione la ficha Atributos y elija la vista Edge.

  3. Haga clic en Ver JSON para abrir la vista JSON del perfil.

    Vista de atributos de perfil en formato JSON que muestra el estado de pertenencia a audiencia {width="80%"}

  4. Vaya al atributo segmentMembership y compruebe si el ID de segmento <JourneyVersionID>_<JourneyActionID> está presente en el área de nombres joai y si está en estado realizado .

    JSON de perfil que muestra pertenencia a audiencia realizada con marca de tiempo {width="90%"}

    • Si está presente, el segmento joai correspondiente a la acción de recorrido entrante se propagó correctamente al perfil de Edge.

    • Si no se muestra en la vista del perfil del servidor de entrega de Edge Network, puede haber un problema con la forma en que el servidor de entrega carga el perfil de Edge.

  5. Si el ID de segmento joai no está presente o está en estado exit, significa que (aún) no se ha propagado a Edge.

    Espere de 15 a 30 minutos para que los valores de segmentMembership se propaguen desde el concentrador a Edge. Si sigue sin estar presente, vaya al paso siguiente.

Paso 4: compruebe si la pertenencia a la audiencia “joai” está presente en el perfil en el concentrador step-4

Este paso sirve para comprobar que el perfil Hub se actualizó correctamente cuando el perfil entró en la acción de recorrido entrante y que el perfil se calificó para el segmento joai correspondiente.

NOTE
La ingesta de la pertenencia al segmento joai en el perfil del concentrador puede tardar entre 15 y 30 minutos desde el momento en que el perfil entró en la acción de recorrido entrante.

Para comprobar la presencia del segmento joai en el atributo segmentMembership del perfil del concentrador, siga los pasos a continuación.

  1. Vaya al menú Cliente > Perfiles en el panel de navegación izquierdo de Journey Optimizer y busque el perfil usando el área de nombres y el ID. Más información sobre Perfiles de clientes en tiempo real

  2. Seleccione la ficha Atributos y elija la vista Hub.

  3. Haga clic en Ver JSON para abrir la vista JSON del perfil.

  4. Vaya al atributo segmentMembership y compruebe si el ID de segmento <JourneyVersionID>_<JourneyActionID> está presente en el área de nombres joai y si está en estado realizado .

    • Si está presente, el segmento joai correspondiente a la acción de recorrido entrante se ingirió correctamente en el perfil del concentrador.

    • Si no se encuentra en el perfil de Edge después de al menos 30 minutos, es posible que haya un problema con el sistema de proyección de Edge.

  5. Si el ID del segmento joai no está presente o está en el estado saliente, significa que el perfil (aún) no se calificó correctamente en el segmento de audiencia especial joai al entrar en la acción de recorrido entrante correspondiente.

    Espere de 15 a 30 minutos para que los valores de segmentMembership se ingieran en el perfil en el concentrador. Si sigue sin estar presente, vaya al paso siguiente.

Paso 5: Si el cliente/dispositivo sigue sin obtener el contenido esperado step-5

Si ha seguido todos los pasos anteriores y no ve el comportamiento esperado después de esperar de 30 a 60 minutos para que la pertenencia al segmento se propague a Edge Network, póngase en contacto con el Servicio de atención al cliente de Adobe o con su representante de Adobe.

Incluya todos los detalles que pueda de los pasos de depuración, como:

  • el paso en el que se ve el comportamiento inesperado;
  • el ID de la versión del recorrido;
  • el ID de acción de recorrido;
  • el seguimiento completo de Assurance;
  • la vista JSON del perfil de Edge;
  • la vista JSON del perfil del concentrador;
  • etc.

Escenario 2: el usuario sigue recibiendo el contenido entrante scenario-2

Este escenario es el inverso de Escenario 1: el perfil ha salido del recorrido, pero el usuario sigue recibiendo el contenido entrante.

Sin embargo, cuando un perfil sale de un recorrido, ya no debería cumplir los requisitos para los segmentos de audiencia joai correspondientes a las acciones entrantes del recorrido.

Siga los mismos pasos de depuración que para Scenario 1 para comprobar si el perfil Hub, el perfil Edge y el servidor de entrega Edge Network reflejan correctamente el estado de pertenencia al segmento del segmento joai relevante, y si el cliente ya no recibe el contenido entrante.

Referencia de conocimientos de AI

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 proporciona una guía de depuración de autoservicio paso a paso para dos escenarios de acción entrantes en Adobe Journey Optimizer recorrido: un perfil que introduce un paso entrante pero no recibe el contenido y un perfil que continúa recibiendo contenido después de salir del recorrido.

Intenciones:

  • Configure una sesión de Assurance como requisito previo antes de depurar los problemas de acción entrante
  • Compruebe si el dispositivo o el cliente recibe contenido entrante de Edge Network mediante Assurance
  • Compruebe las actividades cualificadas y no cualificadas de Edge Network para determinar si un perfil es apto para una acción de recorrido entrante
  • Confirme que la pertenencia al segmento de audiencia de joai se ha propagado del perfil Hub al perfil de Edge.
  • Diagnosticar retrasos en la ingesta de segmentos de unión en el perfil Hub después de que un perfil introduzca una acción entrante
  • Póngase en contacto con el Servicio de atención al cliente de Adobe con la información de diagnóstico correcta cuando los pasos de autoservicio no resuelvan el problema

Glosario:

  • Acciones entrantes: actividades de Recorrido que envían contenido personalizado al dispositivo o explorador de un usuario, incluidos los canales de experiencia en la aplicación, web y basados en código (específicos del producto)
  • área de nombres joai: un área de nombres de identidad especial usado en el perfil segmentMembership para activar un perfil para un paso de acción de recorrido entrante (específico del producto)
  • segmento joai: segmento de audiencia creado automáticamente en el área de nombres joai correspondiente a una acción de recorrido entrante específica; el perfil debe estar en un estado realizado en este segmento para recibir el contenido (específico del producto)
  • Conjunto de datos de entrada de Recorrido: el conjunto de datos de AEP utilizado para almacenar las actualizaciones de perfil realizadas cuando un perfil introduce una acción de recorrido de entrada (específica del producto)
  • Perfil de concentrador: El almacén de perfiles central en Adobe Experience Platform se usa como fuente fiable para los atributos de perfil y la pertenencia a segmentos
  • Perfil de Edge: La copia proyectada del perfil Hub utilizado por el servidor de entrega de Edge Network para evaluar la idoneidad del contenido en tiempo real
  • Assurance: una herramienta Adobe Experience Platform para depurar en tiempo real el comportamiento de SDK del lado del cliente y las respuestas de Edge Network

Protecciones:

  • El conjunto de datos de entrada de Recorrido debe estar habilitado para la ingesta de perfiles en la zona protegida actual antes de que las acciones entrantes funcionen correctamente
  • El área de nombres joai debe definirse en Identidades de plataforma para la zona protegida
  • La propagación del abono a segmentos de Joai de Hub a Edge puede tardar entre 15 y 30 minutos
  • La ingesta de miembros del segmento joai en el perfil Hub puede tardar entre 15 y 30 minutos después de que el perfil entre en la acción entrante
  • Si el contenido sigue faltando pasados 30-60 minutos, diríjase al Servicio de atención al cliente de Adobe con el ID de versión del recorrido, el ID de acción, el seguimiento de Assurance y las vistas JSON del perfil de Edge y Hub

Terminología:

  • Nombre canónico: joai namespace — Acrónimo: joai — variantes: joai identity, joai segment namespace
  • Nombre canónico: Acciones entrantes — Acrónimo: none — variantes: canales entrantes, contenido entrante
  • Sinónimos: “Perfil de concentrador” = “perfil central” (AEP); “perfil de Edge” = “perfil proyectado” (utilizado por Edge Network)
  • No confunda: “Actividades cualificadas” ≠ “Actividades no cualificadas” en la vista de Edge Delivery: cualificado significa que el perfil recibió contenido; no cualificado significa que no lo recibió, con un motivo de exclusión mostrado

PREGUNTAS MÁS FRECUENTES:

  • Q: ¿Cuáles son los dos escenarios principales de error de acción entrante que cubre esta guía? — Escenario 1: un perfil ha entrado en el paso entrante, pero el usuario nunca ve el contenido. Escenario 2: un perfil ha salido de la recorrido, pero el usuario sigue recibiendo el contenido entrante.
  • Q: ¿Qué herramienta se usa para depurar la entrega de acciones entrantes? — Adobe Experience Platform Assurance. Configure primero una sesión de Assurance y, a continuación, utilice las vistas Mensajería en la aplicación y Edge Delivery para inspeccionar la entrega de contenido y las respuestas de Edge Network.
  • Q: ¿Qué es el segmento joai y por qué importa? — Cuando un perfil introduce una acción entrante, se califica automáticamente en un segmento de audiencia de unión vinculado a esa acción específica. Edge Network solo envía el contenido entrante si el perfil está en estado realizado en ese segmento de unión.
  • Q: ¿Cuánto tiempo tarda la pertenencia al segmento de joai en aparecer en el perfil de Edge? — Hasta 15-30 minutos para la propagación de Hub a Edge después de actualizar el perfil de Hub.
  • Q: ¿Qué debo hacer si el ID del segmento joai está en estado saliente en el perfil de Edge? — El perfil ha abandonado el segmento joai, lo que significa que ha salido de la acción de recorrido entrante. Si no se esperaba, realice un seguimiento de la ingesta de perfiles de Hub y compruebe si el perfil ha introducido correctamente el paso de acción entrante.
  • Q: ¿Qué información debo proporcionar al escalar al Servicio de atención al cliente de Adobe? — El ID de versión del recorrido, el ID de acción del recorrido, el paso en el que se produce un comportamiento inesperado, el seguimiento completo de Assurance y las vistas JSON de los perfiles de Edge y Hub.
recommendation-more-help
journey-optimizer-help