Cambios del canal de notificaciones push push-upgrade

Puede utilizar Campaign para enviar notificaciones push a dispositivos Android y iOS. Para ello, Campaign se basa en servicios de suscripción específicos. Algunos cambios importantes en el servicio Android Firebase Cloud Messaging (FCM) se lanzarán en 2024 y pueden afectar a su implementación de Adobe Campaign. Es posible que sea necesario actualizar la configuración de los servicios de suscripción para los mensajes push de Android a fin de admitir este cambio.

Además, Adobe recomienda encarecidamente pasar a la conexión basada en tokens a APNS en lugar de a una conexión basada en certificados, que es más segura y escalable.

Para garantizar un servicio ininterrumpido, debe actualizar las aplicaciones móviles registradas con Adobe Campaign para incorporar los mecanismos de autenticación más recientes para FCM (Android) y APN (iOS).

Obtenga más información sobre cómo configurar los certificados de las aplicaciones móviles en Adobe Campaign Standard

Servicio Google Android Firebase Cloud Messaging (FCM) fcm-push-upgrade

¿Qué ha cambiado? fcm-changes

Como parte del esfuerzo continuo de Google por mejorar sus servicios, las API de FCM existentes dejarán de usarse el 20 de junio de 2024. Obtenga más información acerca del protocolo HTTP de Firebase Cloud Messaging en Documentación de Google Firebase.

A partir de la versión 24.1, Adobe Campaign Standard admite las API HTTP v1 para enviar mensajes de notificación push de Android.

¿Se ha visto afectado? fcm-impact

Si ya utiliza Adobe Campaign Standard para enviar notificaciones push, la implementación debe actualizarse.

La transición a las API más recientes es obligatoria para evitar cualquier interrupción del servicio.

¿Cómo realizar la actualización? fcm-transition-procedure

Requisitos previos fcm-transition-prerequisites

  • La compatibilidad con el modo HTTP v1 API se ha agregado en la versión 24.1. Si su entorno se está ejecutando en una versión anterior, un requisito previo para este cambio es actualizar su entorno a la última versión de Campaign Standard.

  • El archivo JSON de la cuenta del servicio Android Firebase Admin SDK es necesario para mover la aplicación móvil a HTTP v1. Obtenga información sobre cómo obtener este archivo en Documentación de Google Firebase.

  • Si sigue utilizando esta versión heredada del SDK, debe actualizar la implementación con el SDK de Adobe Experience Platform. Obtenga información sobre cómo migrar al SDK de Adobe Experience Platform en este artículo.

  • Asegúrese de tener el permiso Configuración de aplicación móvil en la recopilación de datos de Adobe Experience Platform Mobile antes de realizar los pasos siguientes. Más información.

Procedimiento de transición fcm-transition-steps

Para mover el entorno a HTTP v1, siga estos pasos:

  1. Vaya a Administration > Channels > Mobile app (AEP SDK).

  2. Seleccione la aplicación móvil específica que requiere la actualización del certificado.

  3. Marque la casilla Update app credentials.

  4. Proporcione el ID de aplicación (nombre del paquete de Android) del archivo build.gradle de su proyecto de Android. Por ejemplo, com.android.test.testApp. Asegúrese de utilizar ID diferentes para los entornos de ensayo y producción.

  5. Cargue el archivo de clave privada JSON de Android.

  6. Haga clic en el botón Save.

NOTE
Una vez aplicados estos cambios, todos los nuevos envíos de notificaciones push a dispositivos Android utilizan la API HTTP v1. Los envíos push existentes en reintento, en curso y en uso siguen utilizando la API HTTP (heredada).

Servicio de notificaciones push de Apple iOS (APN) apns-push-upgrade

¿Qué ha cambiado? ios-changes

Como recomienda Apple, debe proteger sus comunicaciones con el servicio de notificaciones push de Apple (APN) mediante tokens de autenticación sin estado.

La autenticación basada en tokens ofrece una forma sin estado de comunicarse con APNS. La comunicación sin estado es más rápida que la comunicación basada en certificados porque no requiere que los APN busquen el certificado u otra información relacionada con el servidor de su proveedor. El uso de la autenticación basada en token ofrece otras ventajas:

  • Puede utilizar el mismo token desde varios servidores de proveedores.

  • Puede utilizar un token para distribuir notificaciones para todas las aplicaciones de la empresa.

Obtenga más información acerca de las conexiones basadas en tokens a APN en Documentación para desarrolladores de Apple.

Adobe Campaign Standard admite conexiones basadas en tokens y en certificados. Si la implementación depende de una conexión basada en certificados, Adobe le recomienda encarecidamente que la actualice a una conexión basada en tokens.

¿Se ha visto afectado? ios-impact

Si la implementación actual depende de solicitudes basadas en certificados para conectarse a APNS, se verá afectado. Se recomienda la transición a una conexión basada en token.

¿Cómo realizar la actualización? ios-transition-procedure

Requisitos previos ios-transition-prerequisites

  • La compatibilidad con el modo Autenticación basada en tokens se ha agregado en 24.1. Si su entorno se está ejecutando en una versión anterior, un requisito previo para este cambio es actualizar su entorno a la última versión de Campaign Standard.

  • Necesita una clave de firma de token de autenticación de APNS para generar los tokens que utiliza su servidor. Usted solicita esta clave desde su cuenta de desarrollador de Apple, como se explica en Documentación para desarrolladores de Apple.

Procedimiento de transición ios-transition-steps

Para mover las aplicaciones móviles de iOS al modo de autenticación basado en tokens, siga estos pasos:

  1. Vaya a Administration > Channels > Mobile app (AEP SDK).

  2. Seleccione la aplicación móvil específica que requiere la actualización del certificado.

  3. Marque la casilla Update app credentials.

  4. Proporcione el ID de aplicación (ID de paquete de iOS). Puede encontrar el ID del paquete de iOS (ID de aplicación) en el destino principal de la aplicación en Xcode.

  5. Cargue su archivo de certificado p8 de iOS.

  6. Complete la configuración de conexión de APNS Key Id y iOS Team Id.

  7. Haga clic en Save.

La aplicación de iOS ahora se mueve al modo de autenticación basado en token.

Preguntas frecuentes push-upgrade-faq

¿Podemos mantener el mismo appID en la instancia de stage y prod?
En el caso de las aplicaciones móviles de iOS, puede utilizar el mismo ID de aplicación, que es el ID del paquete de aplicaciones de iOS, para los entornos de ensayo y producción. Sin embargo, en Android, el ID de la aplicación debe ser único para cada entorno. Por lo tanto, se recomienda anexar "fase" al ID de aplicación creado en el entorno de ensayo
¿Podemos migrar solo la aplicación de Android?
No, tanto las aplicaciones de Android como las de iOS deben migrarse según los pasos descritos anteriormente.
¿Qué tipo de verificación necesitamos realizar después de la migración?
Nuestra recomendación es llevar a cabo la validación funcional de todos los casos de uso relacionados con push.
¿Qué hacer cuando se produce el error <>No autorizado<> al guardar la aplicación móvil?
Parece ser un problema de permisos relacionado con la recopilación de datos de Adobe Experience Platform. Para resolver esto, debe agregar los permisos "Mobile" y "Mobile App Configuration" en Adobe Admin Console, tal como se describe en la sección Requisitos previos de este artículo.
¿Se requieren cambios en el código de la aplicación móvil?
No, solo se requieren los cambios relacionados con la configuración en Firebase y en la cuenta de desarrollador de aplicaciones. No es necesario realizar cambios en la aplicación móvil del cliente.
¿Es necesario actualizar el certificado de iOS cada año?
No, después de esta migración, no es necesario actualizar el certificado de iOS cada año.
¿Qué sucede si no se realiza esta migración?
Los mensajes push de Android empezarán a fallar después del 20 de junio de 2024, según la notificación de Google. Más información.
¿Pueden los clientes volver a migrar a FCM después de completar la migración a FCMv1?
Sí, los clientes podrán volver a migrar a FCM hasta el 20 de junio de 2024. Después de esta fecha, la opción de migración ya no estará disponible.
¿Se admite la migración de la API HTTP v1 en la aplicación móvil SDK V4?
No, los clientes deben migrar primero su aplicación móvil al SDK V5 y, a continuación, continuar con la migración anterior. Deben hacerlo como una prioridad, ya que su servicio push empezará a fallar a partir de junio de 2024, según la notificación de Google.
¿El cambio en la instancia de fase tendrá algún impacto en la instancia de producción?
No, los cambios en la aplicación móvil de fase no afectan a la instancia de producción.
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff