Escenarios comunes de solución de problemas de actividades Live troubleshoot-mobile-live

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 token, appId y attributeType estén presentes.
4. Confirme que el evento se ha enviado 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 del evento y la carga útil.

Si no se encuentran eventos, la aplicación no está llamando a Messaging.registerLiveActivities correctamente. Corrija 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 no es correcto, actualice la aplicación móvil, regístrese de nuevo 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 y vuelva a comprobarlo.

Android utiliza el token de registro de FCM estándar para las actividades activas. No hay ningún evento liveActivity.pushToStart ni token push de actividad en directo independiente.

1. En Assurance, abra la lista Events y busque el evento de registro de token de inserción estándar.
2. Seleccione el evento e inspeccione su carga útil para comprobar que el token de registro de FCM está presente.
3. Confirme que el evento de registro se ha enviado correctamente.
4. En Adobe Experience Platform, abra la ficha Atributos del perfil y confirme que el token se encuentra en pushNotificationDetails, tal como se describe en el paso 2.

Si falta el evento de registro o el token de perfil, compruebe que la aplicación reenvía el token de registro de FCM a SDK mediante MobileCore.setPushIdentifier(token).

1. Desde su perfil, acceda a la ficha Atributos.

2. Busque pushNotificationDetails. Android usa este objeto en lugar de liveActivityPushNotificationDetails y no requiere un campo attributeType.

3. Compruebe que la configuración del token sigue esta estructura:

   code language-json
   { "pushNotificationDetails": [ { "appId": "com.adobe.marketing.mobile.liveupdatessample", "token": "fcm-registration-token...", "platform": "fcm", "denylisted": false, "identity": {} } ] }

Validar cada campo:

Si algún campo es incorrecto, corrija la configuración de la aplicación según sea necesario, reenvíe el token de FCM de nuevo con MobileCore.setPushIdentifier(token), espere 5-10 minutos y vuelva a comprobar el perfil.

Si falta pushNotificationDetails, el token aún no se ha sincronizado. Después de confirmar el registro del token en Assurance, espere de 5 a 10 minutos y vuelva a comprobar el perfil.

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 una nueva marca de tiempo

• Establezca timestamp al tiempo actual de Unix epoch (en segundos) en el momento en que realice cada llamada de API. Esto se aplica a todos los tipos de eventos: start, update y end.
• Una marca de tiempo antigua o reutilizada hace que las solicitudes de actualización y finalización fallen o que el dispositivo la ignore. no reutiliza las marcas de tiempo de solicitudes anteriores o valores almacenados en caché.

Campos opcionales (todos los tipos de eventos):

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

Acerca de dismissal-date:

• Opcional. Tiempo de Unix epoch en segundos. Relevante solo cuando event es "end".
• Especifica cuándo se elimina automáticamente la actividad en directo del dispositivo. Si lo omite, 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. En Journey Optimizer, abra su Campaña y vaya al menú Acciones.
2. Comprueba tu configuración de actividad en vivo. La superficie debe dirigirse a la aplicación de Android con un nombre de paquete que coincida con el appId en el pushNotificationDetails del perfil.
3. Compruebe que la superficie utiliza las credenciales de FCM para esa aplicación. La plataforma de token del perfil debe ser "fcm".
4. Confirme que notification_channel_id en la carga útil coincide con un canal de notificación creado por la aplicación.

Coloque los campos de actividad de Android Live en context.requestPayload.fcm.

Carga de inicio unitario:

{
   "requestId": "your-request-id",
   "campaignId": "your-campaign-id",
   "recipients": [
      {
         "type": "aep",
         "userId": "your-device-ECID",
         "namespace": "ECID",
         "context": {
            "requestPayload": {
               "fcm": {
                  "notification_id": "flight-DL-321",
                  "timestamp": 1756984054,
                  "notification_channel_id": "live_updates_channel",
                  "priority": "PRIORITY_HIGH",
                  "event_type": "start",
                  "title": "Flight DL-321",
                  "body": "Boarding starts shortly",
                  "critical_text": "25 min",
                  "content_state": {
                     "custom_key_template_type": "progress",
                     "custom_key_journey_start": "DEL",
                     "custom_key_journey_progress": 10,
                     "custom_key_journey_end": "MUM"
                  }
               }
            }
         }
      }
   ]
}

Reemplace la marca de tiempo de ejemplo por la hora actual de Unix epoch en segundos. Las claves content_state son ejemplos y deben coincidir con el proveedor de estilos de la aplicación.

Para las difusiones, use una campaña de marketing activada por API con audience.id y coloque el objeto fcm en context.requestPayload. Establezca topic_name en el tema de FCM al que se han suscrito los dispositivos de destino. Mantenga el tema y notification_id sin cambios en los eventos de inicio, actualización y finalización. Consulte los ejemplos de carga útil de difusión de Android.

Problemas comunes de carga útil:

Comprobaciones de ciclo vital y marca de tiempo:

• Use un(a) nuevo(a) timestamp en segundos epoch para cada evento de inicio, actualización y finalización. Asegúrese de que sea mayor que el valor anterior para el mismo notification_id (o topic_name para difusiones), incluso cuando las solicitudes se realicen dentro del mismo segundo.
• Se omiten las marcas de tiempo antiguas o iguales. No reutilice las marcas de tiempo en caché.
• El campo opcional when controla el tiempo mostrado de la notificación, no el orden de los mensajes. Manténgalo razonablemente actualizado y exprésalo en segundos epoch.
• Para actualizar o finalizar una actividad, cambie event_type sin modificar notification_id. Android utiliza el mismo token de registro de FCM para los tres eventos de ciclo vital; no se requiere un token de actualización independiente.

Despido del evento final:

Para event_type: "end", si lo desea, puede establecer dismiss_after en el número de segundos que la actividad en directo completada debe permanecer visible antes de la eliminación. Es una duración, no una marca de tiempo de época.

El proveedor de estilos de la aplicación determina cómo se representan los valores de content_state en la notificación de actividad en directo.

1. Confirme que la mensajería y la extensión Live Activities estén integradas en la aplicación.
2. Compruebe que cada campo de content_state coincide con una clave controlada por el proveedor de estilo, incluido su tipo de valor esperado.
3. Compruebe que title, body y critical_text contengan el texto que se desea mostrar. critical_text se usa para el chip de barra de estado.
4. Confirme que los permisos de notificación se han concedido y que el canal identificado por notification_channel_id existe.

Errores comunes:

Para obtener más ejemplos, consulte Crear actividades activas.

Utilice Assurance en un dispositivo de prueba conectado a Android.

1. Abra una sesión de Assurance y confirme que el registro de token de FCM está visible.
2. Ejecute la llamada de API para iniciar la actividad en directo y, a continuación, envíe los eventos de actualización y finalización con las mismas notification_id y las marcas de tiempo en aumento.
3. Revise los eventos y las cargas útiles de SDK disponibles para detectar errores de procesamiento o validación. Confirme que la carga útil de Android utiliza fcm y los valores de ciclo de vida deseados.
4. En la ficha Eventos del perfil, inspeccione los eventos message.feedback que coincidan. Compruebe que serviceProvider es fcm y revise feedbackStatus, errorCode y errorMessage para detectar errores de entrega.
5. Si la entrega se realiza correctamente pero no se representa la actividad Live, revise los registros de la aplicación, las asignaciones del proveedor de estilos, los permisos de notificación y la configuración de canal en el dispositivo.

Omita este paso si el informe de campaña no muestra errores de envío. De lo contrario, combine el error de la tabla Motivos del error con los siguientes errores comunes de APN:

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 excluyó en el informe de campaña.

Si feedbackStatus es sent: Journey Optimizer entregó la notificación a APNS. Esto no confirma la renderización del dispositivo. Continúe con las comprobaciones del lado del dispositivo en el paso 4.

1. Abra la sesión de Assurance y manténgala 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

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.
• Compruebe 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 Campaign que muestran estadísticas de envío, motivos de error y motivos de exclusión
• Eventos de perfil relevantes (liveActivity.updateToken para problemas de actualización/finalización unitarios y message.feedback)
• Detalles de la sesión de Assurance y capturas de pantalla relevantes del evento
• Carga útil y respuesta de solicitud de API, con credenciales y tokens de dispositivo censurados
• Detalles del certificado de APNS (caducidad, entorno, ID de paquete)

Omita este paso si el informe de campaña no muestra errores de envío. De lo contrario, combine el error de la tabla Motivos del error con los siguientes errores comunes de FCM:

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 para las marcas de tiempo de campaña y de llamada de API que está investigando.

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	fcm	Entrega push de Android gestionada por FCM
   errorCode	Código de error del proveedor para null	Código de error específico de FCM si falla la entrega
   errorMessage	Descripción del error para null	Mensaje de error legible por un ser humano

7. Si feedbackStatus: "error":

   • Inspeccione errorCode y errorMessage y aplique la resolución de FCM correspondiente del paso 1.

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

   • Es posible que no se haya intentado enviar la notificación push o que aún no se hayan recibido los comentarios.
   • Compruebe si el perfil se excluyó en el informe de campaña.

Si feedbackStatus es sent: FCM aceptó la notificación. Esto no confirma que el dispositivo haya procesado la actividad en directo. Continúe con las comprobaciones del lado del dispositivo en el paso 4.

Utilice Assurance en un dispositivo de prueba conectado a Android.

1. Abra una sesión de Assurance y manténgala activa durante la llamada de API.
2. Ejecute la llamada API con event_type establecido en start, update o end.
3. En la lista Events, inspeccione los eventos de envío push disponibles para la solicitud a FCM y su respuesta.
4. Compruebe si FCM ha aceptado o rechazado la solicitud e inspeccione los detalles de error notificados.
5. Para las solicitudes rechazadas, utilice los errores de FCM en el paso 1 para comprobar el token, las credenciales del proyecto de Firebase y la carga útil. Si los eventos del proveedor no están disponibles en la sesión, utilice message.feedback eventos e informes de campaña.

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

• Inspeccione los registros de la aplicación de Android para ver si hay errores de gestión push y de representación de actividades activas.
• Confirme que se permiten las notificaciones y que las notificaciones promocionadas se permiten con canPostPromotedNotifications().
• Compruebe que se hayan concedido los permisos de POST_NOTIFICATIONS y POST_PROMOTED_NOTIFICATIONS y que exista el canal identificado por notification_channel_id.
• Asegúrese de que timestamp sea más reciente que el último evento procesado y de que notification_id no haya cambiado. Para las difusiones, compruebe también la suscripción del dispositivo a topic_name.
• Confirme que la aplicación no se ha detenido a la fuerza.
• Confirme que el dispositivo tiene conectividad de red.
• Realice pruebas en varios dispositivos para descartar problemas específicos del dispositivo.
• Compruebe que el dispositivo ejecuta Android 16.1 (nivel de API 36.1) o posterior y que la aplicación utiliza targetSdk 36.
• Compruebe que las claves y los tipos de valor de content_state coinciden con el proveedor de estilos de la aplicación.

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
• notification_id y event_type de la carga útil de API; para difusiones, incluya también topic_name y el ID de audiencia
• Marcas de hora de llamadas API
• Capturas de pantalla de informes de Campaign que muestran estadísticas de envío, motivos de error y motivos de exclusión
• Eventos de perfil message.feedback relevantes, incluidos mensajes y códigos de error de FCM
• Detalles de la sesión de Assurance y capturas de pantalla relevantes del evento
• Carga útil y respuesta de solicitud de API, con credenciales y tokens de dispositivo censurados
• Nombre del paquete Android, proyecto Firebase, ID de remitente y detalles de configuración de las credenciales de FCM; no incluya claves privadas
• Versión del sistema operativo Android, modelo del dispositivo, estado de permisos de notificación y registros de aplicaciones relevantes

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": "start",
            "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).
  • Su equipo 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.

Incluir content-state para todos los tipos de eventos. Incluir attributes, incluido liveActivityData.channelID, solo para eventos de inicio:

{
   "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.

1. Abra su campaña de mercadotecnia desencadenada 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 que la configuración de la actividad en directo se dirige al paquete de Android correcto y utiliza las credenciales de FCM coincidentes. Android no utiliza un campo de tipo de actividad o attributes-type.

Las difusiones de Android utilizan un tema de FCM. Incluya audience.id y coloque el objeto fcm en context.requestPayload, en lugar de en un destinatario individual.

Ejemplo de carga de inicio de difusión:

{
   "requestId": "your-request-id",
   "campaignId": "your-marketing-campaign-id",
   "audience": {
      "id": "your-audience-id"
   },
   "context": {
      "requestPayload": {
         "fcm": {
            "topic_name": "flight_DL321",
            "notification_id": "flight-DL-321",
            "notification_channel_id": "live_updates_channel",
            "timestamp": 1771829292,
            "priority": "PRIORITY_HIGH",
            "event_type": "start",
            "title": "Flight DL-321",
            "body": "Boarding starts shortly",
            "critical_text": "25 min",
            "content_state": {
               "custom_key_template_type": "progress",
               "custom_key_journey_start": "DEL",
               "custom_key_journey_progress": 10,
               "custom_key_journey_end": "MUM"
            }
         }
      }
   }
}

Reemplace la marca de tiempo de ejemplo por la hora actual de Unix epoch en segundos. Adapte las claves content_state al proveedor de estilos de su aplicación.

Problemas comunes de carga útil:

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

• topic_name: identifica el tema de FCM al que se suscribieron los dispositivos de destino. Incluya el mismo valor no vacío en cada solicitud de inicio, actualización y finalización.
• audience.id: identifica la audiencia de la campaña en Adobe Experience Platform. Compruebe su pertenencia y perfiles de muestra para pushNotificationDetails válidos.

Marca de tiempo y campos opcionales:

• Genere un nuevo timestamp en segundos epoch para cada evento y asegúrese de que sea estrictamente mayor que el último valor para el mismo tema. Se omiten los valores anteriores o iguales.
• when establece de forma opcional el tiempo mostrado de la notificación en segundos epoch. No controla el orden de los mensajes.
• Para event_type: "end", dismiss_after especifica de forma opcional cuántos segundos permanece visible la actividad completada antes de la eliminación. Es una duración, no una marca de tiempo de época.

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

1. Confirme que el dispositivo de prueba se suscribe al tema exacto especificado en topic_name, con FirebaseMessaging.getInstance().subscribeToTopic(topic).
2. Compruebe que la suscripción se haya realizado correctamente y que la aplicación lo notifique a través de la API de seguimiento de suscripción a temas compatible con la extensión de actividades de Adobe Live instalada.
3. Mantener topic_name y notification_id sin cambios en los eventos de inicio, actualización y finalización.
4. Compruebe que las claves y los tipos de valor de content_state coinciden con el proveedor de estilos de la aplicación.
5. Compruebe que se hayan concedido permisos de notificación y que notification_channel_id coincida con un canal creado por la aplicación.

Errores comunes:

Consulte el ejemplo de carga útil de difusión de Android para ver campos y ejemplos adicionales.

Utilice Assurance en un dispositivo de prueba de Android conectado que forme parte de la audiencia y esté suscrito al tema de difusión.

1. Abra la sesión de Assurance antes de ejecutar la llamada de API de difusión.
2. Enviar solicitudes de inicio, actualización y finalización con los mismos topic_name y notification_id, y aumentar las marcas de tiempo.
3. En la lista Events, compruebe los eventos de SDK y envío disponibles para detectar errores de procesamiento de carga útil.
4. Confirme que la carga útil contiene los valores de objeto fcm, topic_name y event_type deseados.
5. Revise los informes de campaña y los eventos message.feedback disponibles para confirmar los resultados de la entrega de FCM. El valor de Android serviceProvider es fcm.
6. Si FCM acepta el mensaje pero el dispositivo no procesa la actividad, consulte la suscripción del tema, los permisos de notificación, la configuración del canal y los registros de la aplicación. La aceptación del proveedor no confirma la representación del dispositivo.