Resolución de problemas de actividades en directo troubleshoot-mobile-live

La vista Actividades activas de Adobe Experience Platform Assurance valida la configuración de la aplicación, inspecciona los eventos de actividad y permite iniciar, actualizar o finalizar actividades de forma remota desde una sesión de prueba.

Requisitos

Tres pestañas

Iniciar, actualizar y finalizar desde Assurance

Iniciar Actividad En Directo. abre un cuadro de diálogo para elegir el tipo de actividad registrada, elegir Unitario o Emisión, introducir un ID de canal de difusión (solo emisión) y editar una carga útil JSON de APS precargada. El botón está desactivado o devuelve un error si no se cumplen los requisitos de token de inserción a inicio, versión de iOS o configuración de canal.

Enviar actualización. en la pestaña Información general de una actividad existente, envía un evento Actualizar (insertar contenido nuevo) o Finalizar. Para la actualización unitaria, el complemento utiliza automáticamente el token de actualización de la actividad. Para la difusión, se dirige a todos los dispositivos suscritos al mismo ID de canal de difusión. Las cargas útiles deben ser un JSON válido y coincidir con el esquema de atributos de la actividad; en caso contrario, la solicitud se rechaza.

Consulte la documentación de Adobe Experience Platform Assurance para ver los pasos de configuración y conexión de sesión.

Vaya a la API de la campaña activada en Journey Optimizer y recupere lo siguiente:

• Nombre e ID de la campaña
• Versión de la campaña (si corresponde)
• Tipo de campaña: Transaccional (unitario) o Marketing (difusión)
• Configuración de superficie: la superficie de la aplicación de iOS utilizada para la actividad en directo
• Tipo de actividad: el nombre de estructura AttributeType configurado en la campaña

Al realizar la llamada de API para almacenar en déclencheur la actividad en directo, guarde lo siguiente:

• Carga útil de solicitud de API, incluidos los identificadores de perfil y los datos de actividad en directo
• Respuesta de API que incluye código de estado, ID de mensaje e ID de solicitud
• Marca de tiempo del momento en el que se llamó a la API
• Punto de conexión utilizado, p. ej. /campaign/{CAMPAIGN_ID}/execute

En la solicitud de API, recupere:

• Área de nombres del perfil, por ejemplo, ECID, correo electrónico, ID de cliente
• ID de perfil utilizado en la llamada de API

Asegúrese de que puede buscar este perfil en Adobe Experience Platform. Aprenda a buscar un perfil en la documentación de Experience Platform.

Recopile lo siguiente del dispositivo de prueba:

• Modelo de dispositivo, por ejemplo, iPhone 14 Pro
• Versión de iOS
• Identificador del paquete de aplicaciones
• Token push de APNS
• Estado de conectividad de red en el momento de la prueba

1. En Journey Optimizer, vaya a Cliente > Perfiles.
2. Busque utilizando el área de nombres y el valor de identidad de la solicitud de API.
3. Si no se encuentra el perfil, este no existe o la ingesta no se ha completado. Cree el perfil o espere a que se produzca la ingesta antes de activar la actividad Live.
4. Si se encuentra un perfil, continúe con el paso 2 a continuación para comprobar si el token push está sincronizado.

Puede utilizar Assurance para verificar el registro de tokens:

1. En Assurance, en la lista Eventos, filtre o busque los eventos eventType = "liveActivity.pushToStart".
2. Seleccione Event e inspeccione la carga útil.
3. Compruebe que los valores de token, appId y attributeType estén presentes.
4. Confirme si el evento se envió correctamente.

También puede registrar el perfil de Adobe Experience Platform.

1. En Adobe Experience Platform, desde tu perfil, accede a la pestaña Eventos.
2. Busque liveActivity.pushToStart eventos.
3. Compruebe la marca de tiempo par y la carga útil.

Si no se encuentran eventos, la aplicación móvil no está llamando a Messaging.registerLiveActivity correctamente. Debe corregir la integración de SDK.

1. Desde tu perfil, accede a la pestaña Atributos.

2. Busque liveActivityPushNotificationDetails.

3. Compruebe la configuración del token:

   code language-json
   { "liveActivityPushNotificationDetails": [ { "appId": "com.example.myapp", "token": "abc123def456...", "platform": "apns", "denylisted": false, "attributeType": "OrderTrackingAttributes", "identity": {} } ] }

Validar cada campo:

Si algún campo es incorrecto: actualice la aplicación móvil, vuelva a registrarse con Messaging.registerLiveActivities, espere de 5 a 10 minutos y vuelva a realizar la comprobación.

Si falta liveActivityPushNotificationDetails: el token aún no se ha sincronizado. Espere de 5 a 10 minutos después de ver el evento liveActivity.pushToStart en Assurance.

1. En Journey Optimizer, abra su Campaña y vaya al menú Acciones.
2. Comprueba tu configuración de actividad en vivo. La superficie debe configurarse para la aplicación de iOS con un identificador de paquete que coincida con el appId en liveActivityPushNotificationDetails de su perfil. Por ejemplo, si su perfil tiene "appId": "com.example.myapp", la superficie debe segmentar esa misma aplicación.
3. Compruebe que el tipo de actividad de la configuración de su campaña coincida exactamente con el attributeType del liveActivityPushNotificationDetails de su perfil. Por ejemplo, si su perfil tiene "attributeType": "FoodDeliveryLiveActivityAttributes", la campaña debe especificar este mismo tipo de actividad.

Al ejecutar la campaña a través de la API, asegúrese de que la carga útil sigue la estructura correcta.

Carga útil unitaria:

{
   "campaignId": "your-campaign-id",
   "recipients": [{
      "type": "aep",
      "userId": "user@example.com",
      "namespace": "email",
      "context": {
      "requestPayload": {
         "aps": {
            "content-available": 1,
            "timestamp": 1756984054,
            "event": "start",
            "attributes-type": "FoodDeliveryLiveActivityAttributes",
            "content-state": { ... },
            "attributes": { ... }
         }
      }
      }
   }]
}

Problemas comunes de carga útil:

Crítico: usar siempre la última marca de tiempo

• El campo timestamp debe siempre ser el tiempo actual de Unix epoch (en segundos) en el momento en que se realiza cada llamada de API.
• Esto se aplica a todos los tipos de eventos: start, update y especialmente aend.
• Impacto en las actualizaciones/solicitudes de finalización: el uso de una marca de tiempo antigua o obsoleta provocará que las solicitudes de actualización y finalización no se realicen correctamente o que el dispositivo las ignore.
• NOT reutiliza marcas de tiempo de solicitudes anteriores o usa valores almacenados en caché.
• Genere una nueva marca de tiempo para cada llamada de API.

Campos opcionales (todos los tipos de eventos):

• requestId: Identificador único para seguimiento (recomendado).
• alert: objeto con title y body para notificación (útil para llamar la atención sobre las actualizaciones).

Acerca de dismissal-date:

• Campo opcional que contiene Unix epoch time (seconds).
• Solo es relevante cuandoevent: "end".
• Especifica cuándo se debe eliminar automáticamente la actividad en directo del dispositivo.
• Si no se proporciona en el evento Fin, la actividad Live permanece visible hasta que el usuario la descarta.
• Debe ser una marca de tiempo futura (posterior a timestamp).

Asegúrese de que la carga útil de la API coincida con la implementación de la aplicación de iOS ActivityAttributes. El protocolo LiveActivityAttributes de Adobe SDK amplía iOS ActivityAttributes y requiere una propiedad liveActivityData.

Validar la asignación:

1. Su ActivityAttributes debe implementar el protocolo LiveActivityAttributes de Adobe. Ejemplo:

   code language-swift
   struct FoodDeliveryLiveActivityAttributes: LiveActivityAttributes { public struct ContentState: Codable, Hashable { var orderStatus: String var estimatedDeliveryTime: String } // Adobe SDK requirement var liveActivityData: LiveActivityData // Your custom attributes var restaurantName: String }

   Tenga en cuenta que Adobe SDK requiere el campo liveActivityData y que debe incluirse en todas las implementaciones.

2. La carga útil de la API debe reflejar la estructura de iOS:

   code language-json
   { "aps": { "event": "start", "timestamp": 1756984054, "attributes-type": "FoodDeliveryLiveActivityAttributes", "content-state": { "orderStatus": "Preparing", "estimatedDeliveryTime": "20 mins" }, "attributes": { "liveActivityData": { "liveActivityID": "order-12345" }, "restaurantName": "Pizza Palace" } } }

Lista de comprobación de validación:

• Incluir todos los ContentState campos en content-state (requerido para todos los tipos de eventos).

• Incluir todos los campos de LiveActivityAttributes en attributes (solo eventos de inicio), incluidos:

  • liveActivityData (obligatorio; normalmente contiene liveActivityID o un identificador similar)
  • Todos los campos personalizados de la estructura

• Haga coincidir los nombres de los campos exactamente (con distinción de mayúsculas y minúsculas).

• Hacer coincidir tipos de datos (String, Int, Bool, objetos anidados).

• Conservar la estructura de objetos anidados.

Errores comunes:

Para obtener más ejemplos, consulte Crear página de actividad en vivo.

Compruebe la ejecución de la API y la entrega de carga útil mediante Assurance:

1. Abra la sesión de Assurance.

2. Ejecute la llamada de la API para almacenar en déclencheur la actividad en directo.

3. En Lista de eventos, compruebe lo siguiente:

   • Eventos de ejecución de Campaign.
   • Eventos de entrega de actividad en directo.
   • Eventos de error de validación de carga útil.

4. Revise las cargas útiles de evento para verificar:

   • La carga útil se ha procesado correctamente.
   • No se han producido errores de validación.
   • La actividad en directo se ha enviado a APNS.

1. Vaya a su Actividad en directo en Campaign.

2. Haga clic en el botón Informes.

3. Seleccione Ver informe de todo el tiempo.

4. Revise las secciones siguientes:

   1. Compruebe las métricas Estadísticas de envío para comprender el éxito de la entrega:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
      Métrica	Lo que significa	Qué se debe buscar
      Objetivos	Número de perfiles cualificados para la audiencia	Debe incluir el perfil de prueba
      Envíos	Total de notificaciones push intentadas	Debe coincidir con sus llamadas a la API
      Entregados	Entregado correctamente a los dispositivos	Comparar con Envíos para ver la tasa de éxito
      Enviar errores	Notificaciones push que no se han enviado	Números altos
      Envío de exclusiones	Perfiles excluidos por Adobe Journey Optimizer	Compruebe si su perfil se ha excluido

   2. Si Enviar errores > 0, consulte la tabla Motivos del error para ver los códigos de error y los mensajes específicos:

      table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
      Error común	Significado	Resolución
      Token no válido	El token de inserción no es válido o ha caducado	Volver a registrar tokens de actividad activos desde el dispositivo
      Token no encontrado	No hay ningún token válido asociado al perfil	Comprobar que liveActivityPushNotificationDetails existe
      APNS rechazadas	El servicio de notificaciones push de Apple rechazó la notificación push	Comprobación del certificado de APNS, ID de paquete, entorno
      Tiempo de espera de red	No se puede acceder a APNS	Problema transitorio; vuelva a intentar la llamada de API

   3. Si Enviar exclusiones > 0, compruebe la tabla Motivos de exclusión:

      table 0-row-3 1-row-3 2-row-3 3-row-3
      Exclusión común	Significado	Resolución
      Perfil excluido	El usuario ha excluido las notificaciones	Comprobar estado de consentimiento del perfil
      Token	Token marcado como no válido	Volver a registrar el token o comprobar el estado de la lista de bloqueados de la
      Perfil no apto	El perfil no cumple los criterios de la campaña	Revisar reglas de audiencia de campaña

Obtenga más información en la página de informe de campaña de actividades en vivo.

1. Vaya a Cliente > Perfiles en Journey Optimizer.

2. Busque y abra el perfil.

3. Seleccione la ficha Eventos.

4. Filtre o busque eventos con eventType = "message.feedback".

5. Busque eventos de comentarios que coincidan con el tipo liveActivityID y event de su actividad en directo.

6. Revise los siguientes campos clave:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3
   Campo	Valores posibles	Lo que significa
   feedbackStatus	sent, error, denylist	Resultado del envío del proveedor de servicios
   serviceProvider	apns/apnsSandbox	Debe ser APNS para actividades de iOS Live
   errorCode	Código numérico para null	Código de error específico de APNS si falla
   errorMessage	Descripción del error para null	Mensaje de error legible por un ser humano

7. Si feedbackStatus: "error":

   • Compruebe si hay errores APN específicos en errorCode y errorMessage
   • Los errores comunes de APNS incluyen token caducado, certificado no válido e ID de paquete incorrecto

8. Si no se encuentra ningún evento de comentarios:

   • Es posible que no se haya intentado la notificación push
   • Compruebe si el perfil se ha excluido en los informes de campaña tal como se detalla en el paso 1 anterior.

1. Abra la sesión de Assurance, debe estar activa durante la llamada de API.

2. Ejecute la llamada de API (inicio, actualización o finalización).

3. En Lista de eventos, busque Eventos de entrega de actividades en directo.

4. Busque eventos relacionados con la entrega push de APNS.

5. Compruebe la existencia de las luces testigo siguientes:

   • Solicitud push a APNS: Confirma que Adobe envió la notificación push a los servidores de Apple
   • Respuesta de APN: Muestra si APN aceptó o rechazó la notificación push
   • Estado de entrega: Indicación de éxito o error

6. Si se encuentran problemas, consulte los siguientes problemas comunes de entrega de APN:

   table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
   Problema	Síntoma en Assurance	Resolución
   Certificado de APNS caducado	Error de autenticación	Renovar y cargar un nuevo certificado de APN
   Entorno incorrecto (dev vs prod)	Error de coincidencia de tokens	Asegúrese de que el certificado coincida con el tipo de creación de aplicación
   ID de paquete no coincidente	Identificador de paquete no válido	Verificar que el ID del paquete de certificados coincida con la aplicación
   Token caducado	Error InvalidToken de APNS	Volver a registrar tokens de actividad activos
   Limitación de velocidad	Demasiadas solicitudes	Reducir frecuencia de llamada de API

1. Compruebe las métricas del ciclo vital de la actividad en directo en el informe de Campaign.

   En el informe de campaña, revise la sección Ciclo de vida de la actividad en directo:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
   Métrica	Qué comprobar
   Inicios remotos	Debe mostrar el recuento de inicios activados por API
   Actualizaciones	Debe mostrar el recuento de eventos de actualización
   Finaliza	Debe mostrar el recuento de eventos finales
   Recuento de totales	Volumen general del evento de actividad en directo

   Si estas métricas son cero o no coinciden con sus llamadas de API, hay un problema de envío entre Adobe y APNS.

2. Si Adobe muestra un envío correcto pero el dispositivo no muestra la actividad en directo:

   • Compruebe si hay errores de actividad en directo en los registros de dispositivos iOS.
   • Verifique que la aplicación esté en primer o segundo plano (no finalizada).
   • Confirme que el dispositivo tiene conectividad de red.
   • Realice pruebas en varios dispositivos para descartar problemas específicos del dispositivo.
   • Compruebe que la versión de iOS sea 16.1 o posterior.

Si ha completado todos los pasos y el problema sigue sin resolverse, póngase en contacto con el Servicio de atención al cliente de Adobe con:

Información necesaria:

• ID y nombre de la campaña
• Área de nombres e ID de perfil
• liveActivityID de carga útil de API
• Marcas de hora de llamadas API
• Capturas de pantalla de:
• Informes De Campaña (Estadísticas De Envío, Motivos De Error, Motivos De Exclusión)
• Eventos de perfil (liveActivity.updateToken, message.feedback)
• Sesión de Assurance que muestra eventos de envío
• Carga útil de solicitud de API completa
• Detalles del certificado de APNS (caducidad, entorno, ID de paquete)

1. Abra la sesión de Assurance.

2. Asegúrese de que la sesión esté activa cuando se inició la actividad en directo en el dispositivo.

3. Filtre o busque eventos con eventType = "liveActivity.updateToken".

4. Seleccione el evento e inspeccione la carga útil:

   • Compruebe que el campo token contenga una cadena de token de actualización válida.
   • Compruebe que liveActivityID coincida con su instancia de actividad en directo.
   • Confirme que activityType coincide con su attributes-type.

5. Si no se encuentra el evento:

   • SDK no ha generado ni capturado el token de actualización.
   • Compruebe si el usuario ha concedido permisos de actividad en directo.
   • Compruebe que la actividad Live se haya iniciado correctamente en el dispositivo.
   • Confirme que el SDK móvil está correctamente integrado para capturar los tokens de actualización.

6. Si se encuentra el evento, continúe con el paso 2.

1. Vaya a Cliente > Perfiles en Journey Optimizer.

2. Busque y abra el perfil.

3. Seleccione la ficha Eventos.

4. Busque liveActivity.updateToken eventos.

5. Compruebe los detalles del evento:

   • Compruebe que la marca de tiempo sea reciente (coincide con el momento en el que se inició la actividad en directo).
   • Confirme que token y liveActivityID están presentes.
   • Asegúrese de que activityType sea correcto.

6. Si el evento no se encuentra en el perfil:

   • Es posible que el evento de token de actualización aún no se haya introducido en el perfil.
   • Espere de 5 a 10 minutos y vuelva a efectuar la comprobación.
   • Si sigue faltando después de 15 minutos, puede haber un problema de ingesta de evento.

7. Si se encuentra el evento, se ha sincronizado el token de actualización. Puede continuar con el paso 3.

1. En la sesión de Assurance, ejecute una actualización o termine la llamada a la API.

2. En la Lista de eventos, busque Eventos de entrega de actividades en directo (eventos push de APN).

3. Compruebe si hay eventos que indiquen:

   • Notificación push enviada a APNS.
   • Respuesta de APNS (éxito o error).
   • Confirmación de envío.

4. Si el evento de envío de APNS está presente: Se envió la notificación push. Si el dispositivo sigue sin actualizarse, el problema puede estar en el dispositivo (la aplicación no gestiona la notificación push, los problemas de red, etc.).

5. Si falta el evento de envío de APNS: es posible que el token de actualización no se almacene correctamente o no esté asociado al perfil en el sistema de Adobe.

6. Si hay eventos de error: inspeccione los detalles del error por motivos de error específicos (token no válido, APN rechazados, etc.).

1. Abra Campaña de marketing activada por API en Journey Optimizer.

2. Vaya a la sección Audiencia y verifique:

   • Se selecciona una audiencia para la campaña.
   • El ID de audiencia coincide con el utilizado en la carga útil de la API.
   • La audiencia contiene los perfiles esperados.

3. Vaya a la sección Acciones.

4. Compruebe la configuración de actividad activa:

   • La configuración debe establecerse para la aplicación de iOS con el identificador de paquete correcto.
   • El tipo de actividad debe coincidir con attributes-type en su carga útil de API. Por ejemplo, si la carga útil contiene "attributes-type": "AirplaneTrackingAttributes", la campaña debe especificar este mismo tipo de actividad.

La estructura de carga útil de difusión difiere de las campañas unitarias. Compruebe que la carga útil sigue el formato de difusión correcto.

Campos obligatorios para la difusión:

{
   "campaignId": "878a11d4-b519-47bd-8313-fecfee19857b",
   "audience": {
      "id": "8c3dbdea-2957-401f-acf0-3966fba1601e"
   },
   "context": {
      "requestPayload": {
      "aps": {
         "input-push-channel": "FEt0NgvLEfEAAOqA6AXdIQ==",
         "content-available": 1,
         "timestamp": 1771829292,
         "event": "update",
         "attributes-type": "AirplaneTrackingAttributes",
         "content-state": { ... },
         "attributes": { ... }
      }
      }
   }
}

Problemas comunes de carga útil:

Campos críticos específicos de difusión:

• input-push-channel:

  • Necesario para todas las actividades de difusión en directo.
  • Sirve como identificador único para esta instancia de difusión específica.
  • Todos los perfiles de la audiencia reciben actividades en directo vinculadas a este canal.
  • Debe coincidir con channelID en liveActivityData.channelID (consulte el paso 3).
  • El cliente debe crear para appID en Apple Developer Portal.
  • Solo se pueden usar los canales creados para appID en concreto para difundir una actividad en directo en esa aplicación.

• audience.id:

  • Debe hacer referencia a un segmento de audiencia válido creado en Adobe Experience Platform.
  • Todos los perfiles de esta audiencia están segmentados para la actividad en directo.
  • La audiencia debe estar activada y contener perfiles con liveActivityPushNotificationDetails válidos.

Usar siempre la marca de tiempo más reciente:

• El campo timestamp debe ser siempre el tiempo de Unix epoch actual (en segundos) para cada llamada de API.
• Este requisito se aplica a todos los tipos de eventos: start, update y end.
• Crítico para actualizaciones/finalización: el uso de marcas de tiempo antiguas provoca que las solicitudes de actualización y finalización fallen.
• Genere una nueva marca de tiempo para cada llamada de API de difusión.

Campos opcionales:

• dismissal-date: tiempo de Unix Epoch para el despido automático (solo relevante para end eventos)
• alert: objeto con title y body para notificación

Consulte la documentación de la API de mensajería Adobe Journey Optimizer para obtener especificaciones completas de la API.

Asegúrese de que los campos de carga útil coincidan con la implementación ActivityAttributes de su aplicación iOS y de que input-push-channel coincida con channelID en liveActivityData.

1. Revise la definición de Atributos de actividad de iOS.

Su estructura ActivityAttributes personalizada debe implementar el protocolo LiveActivityAttributes de Adobe:

struct AirplaneTrackingAttributes: LiveActivityAttributes {
   public struct ContentState: Codable, Hashable {
      var journeyProgress: Int
   }

   // Adobe SDK requirement
   var liveActivityData: LiveActivityData

   // Your custom attributes
   var arrivalAirport: String
   var departureAirport: String
   var arrivalTerminal: String
}

1. Asigne campos de iOS a la carga útil de la API de difusión.

Para todos los eventos, incluya attributes y content-state:

      {
      "aps": {
         "input-push-channel": "FEt0NgvLEfEAAOqA6AXdIQ==",
         "event": "start",
         "timestamp": 1771829292,
         "attributes-type": "AirplaneTrackingAttributes",
         "content-state": {
         "journeyProgress": 0
         },
         "attributes": {
         "arrivalAirport": "DEL",
         "departureAirport": "MUM",
         "arrivalTerminal": "T1",
         "liveActivityData": {
            "channelID": "FEt0NgvLEfEAAOqA6AXdIQ=="
         }
         }
      }
      }

Crítico: input-push-channel debe coincidir conchannelID

• El valor input-push-channel en la raíz de aps debe coincidir exactamente con channelID en liveActivityData.
• En el ejemplo anterior, ambos valores son "FEt0NgvLEfEAAOqA6AXdIQ==".
• Esta coincidencia vincula la instancia de difusión con los datos de la actividad en directo.
• Un desajuste provoca errores de entrega.

Puntos de validación clave:

• Incluir todos los ContentState campos en content-state para todos los tipos de eventos.
• Incluir todos los campos personalizados LiveActivityAttributes en attributes solo para eventos de inicio.
• Para los eventos de inicio, liveActivityData.channelID debe coincidir con input-push-channel.
• Los nombres de campo distinguen entre mayúsculas y minúsculas y deben coincidir exactamente.
• Los tipos de datos deben coincidir (String, Int, Bool, objetos anidados, etc.).
• Para los eventos de actualización/finalización, use el mismo input-push-channel que el evento de inicio original.

Errores comunes:

Compruebe la ejecución de la API y la entrega de carga útil mediante Assurance:

1. Abra la sesión de Assurance en un dispositivo de prueba que forme parte de la audiencia.

2. Ejecute la llamada de API de difusión.

3. En Lista de eventos, busque:

   • Eventos de ejecución de Campaign.
   • Eventos de entrega de actividad en directo.
   • Eventos de error que indican errores de validación de carga útil.

4. Inspeccione las cargas útiles de eventos para confirmar:

   • La carga útil se ha procesado correctamente.
   • El input-push-channel está presente.
   • No se han producido errores de validación.
   • Se han enviado actividades activas a APNS para miembros de la audiencia.

En primer lugar, confirme si el perfil que debe recibir la actividad en directo es realmente parte de la audiencia.

1. Vaya a Audiencias en Adobe Experience Platform.

2. Busque y abra la audiencia usando audience.id de su campaña.

3. Haga clic en Examinar o Perfiles de muestra para ver los miembros de la audiencia.

4. Busque el perfil de prueba con el área de nombres y el valor de identidad.

5. Si no se encuentra el perfil en la audiencia:

   • El perfil no cumple los criterios de audiencia ni las reglas de segmentos.
   • Revise la definición de la audiencia para comprender los requisitos de pertenencia.
   • Actualice los datos del perfil o la definición de audiencia para incluir el perfil.
   • Espere a que se complete la evaluación de audiencias (consulte el paso 2).

6. Si el perfil se encuentra en la audiencia: Continúe con el paso 2 para comprobar la actualización de los datos.

Identifique si la audiencia utiliza la evaluación por lotes o de flujo continuo, ya que esto determina la actualización de los datos.

1. En la página Detalles de audiencia, compruebe el método de evaluación:

   • Lote: evaluado una vez al día según una programación.
   • Transmisión en tiempo real: se evalúa en tiempo real cuando se producen actualizaciones de perfil.
   • Edge: evaluado en ubicaciones de Edge en tiempo real.

Siga los pasos adecuados para la resolución de problemas según el método de evaluación:

Si la audiencia usa la evaluación por lotes:

1. Comprenda las limitaciones de audiencia por lotes:

   • Las audiencias por lotes se evalúan una vez al día (normalmente de la noche a la mañana).
   • La instantánea de audiencia puede tener hasta 24 horas de antigüedad.
   • Si un perfil ha registrado recientemente tokens de actividad en directo, es posible que esos tokens no estén en la instantánea actual.
   • Las actualizaciones de los perfiles no se reflejarán hasta la siguiente evaluación por lotes.

2. Comprobar cuándo se produjo la última evaluación:

   • En los detalles de la audiencia, busque la marca de tiempo Última evaluación.
   • Si las liveActivityPushNotificationDetails del perfil se actualizaron después de esta marca de tiempo, la audiencia tiene datos obsoletos.

3. Resolver datos obsoletos:

   1. Opción 1: esperar la evaluación programada por lotes

      • La siguiente evaluación por lotes incluirá los datos de perfil actualizados.
      • Esto sucede automáticamente una vez al día.
      • Ideal para escenarios no urgentes.

   2. Opción 2: evaluación de audiencia bajo demanda de Déclencheur

      1. Vaya a Audiencias en AEP.
      2. Seleccione el público.
      3. Haga clic en Evaluar ahora o en Activar bajo demanda.
      4. Espere a que se complete la evaluación (esto puede tardar entre minutos y horas según el tamaño de la audiencia).
      5. Compruebe que el perfil tiene ahora datos actualizados en la instantánea de audiencia.
      6. Vuelva a intentar la llamada de API de difusión.

Si la audiencia usa la evaluación de transmisión:

1. Comprender el comportamiento de la audiencia de streaming:

   • Las audiencias de streaming evalúan en tiempo real cuándo se producen actualizaciones de perfil.
   • Nuevos perfiles: Se califican poco después de la creación si cumplen los criterios del segmento.
   • Perfiles actualizados: Califique o descalifique poco después de ser actualizado.
   • Perfiles existentes sin cambios: No se vuelven a evaluar a menos que se produzca una actualización.

2. Identificar el problema:

   • Si un perfil ya existe y cumple los criterios del segmento, pero no se produce ninguna actualización en ese perfil, es posible que no se añada a una audiencia de streaming recién creada.
   • El perfil debe recibir una actualización (cualquier cambio de atributo) para volver a evaluar los déclencheur.

3. Resolver el problema:

   • Para nuevos perfiles: Se califican automáticamente si se cumplen los criterios. No se necesita ninguna acción.

   • Para perfiles existentes sin actualizaciones recientes:

     • Realice una actualización menor del perfil (por ejemplo, actualice un campo de marca de tiempo).
     • Esto déclencheur la evaluación de la transmisión y añade el perfil a la audiencia.
     • Alternativa: Utilice una audiencia por lotes o una audiencia perimetral para los perfiles existentes.