DocumentationDocumentation de Campaign Standard

Modifications du canal de notification push push-upgrade

Last update: Fri Apr 05 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Experienced
  • Admin

Vous pouvez utiliser Campaign pour envoyer des notifications push sur les appareils Android et iOS. Pour ce faire, Campaign repose sur des services d’abonnement spécifiques. Certaines modifications importantes apportées au service Android FCM (Firebase Cloud Messaging), publiées en 2024, pourront avoir une incidence sur votre mise en œuvre d’Adobe Campaign. Il se peut que la configuration de vos services d’abonnement pour les notifications push Android doive être mise à jour pour prendre en charge cette modification.

En outre, Adobe recommande vivement de passer à une connexion au service APN basée sur des jetons plutôt que sur des certificats, pour une solution davantage sécurisée et évolutive.

Pour garantir un service ininterrompu, vous devez mettre à niveau votre ou vos applications mobiles enregistrées auprès d’Adobe Campaign afin d’incorporer les derniers mécanismes d’authentification pour FCM (Android) et APNS (iOS).

En savoir plus sur la configuration des certificats de vos applications mobiles dans Adobe Campaign Standard

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

Qu’est-ce qui a changé ? fcm-changes

Dans le cadre des efforts constants de Google pour améliorer ses services, les API FCM héritées seront abandonnées le 20 juin 2024. Pour en savoir plus sur le protocole HTTP Firebase Cloud Messaging, consultez la documentation de Google Firebase.

Démarrage Version 24.1, Adobe Campaign Standard prend en charge les API HTTP v1 pour envoyer des messages de notification push Android.

Cela vous concerne-t-il ? fcm-impact

Si vous utilisez déjà Adobe Campaign Standard pour envoyer des notifications push, votre mise en oeuvre doit être mise à jour.

La transition vers les dernières API est obligatoire pour éviter toute distraction de service.

Comment effectuer la mise à jour ? fcm-transition-procedure

Conditions préalables fcm-transition-prerequisites

  • Le soutien de API HTTP v1 Le mode a été ajouté à la version 24.1. Si votre environnement s’exécute sur une ancienne version, une condition préalable à cette modification est de mettre à niveau votre environnement vers dernière version de Campaign Standard.

  • Le fichier JSON du compte du service SDK Firebase Admin Android est nécessaire pour que l’application mobile soit déplacée vers HTTP v1. Découvrez comment obtenir ce fichier dans la documentation de Google Firebase.

  • Si vous utilisez toujours cette version héritée du SDK, vous devez mettre à jour votre mise en oeuvre avec le SDK Adobe Experience Platform. Découvrez comment migrer vers Adobe Experience Platform SDK dans cet article.

  • Assurez-vous que la variable Configuration des applications mobiles autorisation dans Adobe Experience Platform Data Collection Mobile avant d’effectuer les étapes ci-dessous. En savoir plus.

Procédure de transition fcm-transition-steps

Pour déplacer votre environnement vers HTTP v1, procédez comme suit :

  1. Accédez à Administration > Canaux > Application mobile (SDK AEP).

  2. Sélectionnez l’application mobile spécifique qui nécessite la mise à jour du certificat.

  3. Vérifiez les Mise à jour des informations d’identification de l’application .

  4. Indiquez l’ID de l’application (nom du module Android) provenant de votre projet Android build.gradle fichier . Par exemple : com.android.test.testApp. Veillez à utiliser différents identifiants pour les environnements d’évaluation et de production.

  5. Téléchargez votre fichier de clé JSON de clé privée Android.

  6. Cliquer sur le bouton Enregistrer.

NOTE
Une fois ces modifications appliquées, toutes les nouvelles diffusions de notifications push sur les appareils Android utilisent l’API HTTP v1. Les diffusions de notifications push existantes en reprise, et actuellement utilisées continueront à utiliser l’API HTTP (héritée).

Service de notification Push Apple iOS (APN) apns-push-upgrade

Qu’est-ce qui a changé ? ios-changes

Comme recommandé par Apple, vous devez sécuriser vos communications avec le service de notifications Push Apple (APN) en utilisant des jetons d’authentification sans état.

L’authentification par jeton offre un moyen sans état de communiquer avec le service APN. La communication sans état est plus rapide que la communication basée sur un certificat, car elle ne nécessite pas de service APN pour rechercher le certificat, ni d’autres informations en lien avec votre serveur de fournisseur. L’utilisation de l’authentification par jeton présente d’autres avantages :

  • Vous pouvez utiliser le même jeton depuis plusieurs serveurs de fournisseurs.

  • Vous pouvez utiliser un jeton pour distribuer des notifications pour toutes les applications de votre entreprise.

En savoir plus sur les connexions au service APN basées sur les jetons dans la Documentation destinée aux équipes de développement Apple.

Adobe Campaign Standard prend en charge les connexions basées sur des jetons et sur des certificats. Si votre mise en œuvre repose sur une connexion basée sur un certificat, Adobe vous recommande vivement de la mettre à jour vers une connexion basée sur un jeton.

Cela vous concerne-t-il ? ios-impact

Si votre mise en œuvre actuelle repose sur des demandes basées sur des certificats pour vous connecter au service APN, cela vous concerne. Il est recommandé d’effectuer une transition basée sur un jeton.

Comment effectuer la mise à jour ? ios-transition-procedure

Conditions préalables ios-transition-prerequisites

  • Le soutien de Authentification basée sur les jetons Le mode a été ajouté dans Version 24.1. Si votre environnement s’exécute sur une ancienne version, une condition préalable à cette modification est de mettre à niveau votre environnement vers dernière version de Campaign Standard.

  • Vous avez besoin d’une clé de signature de jeton d’authentification APN pour générer les jetons utilisés par votre serveur. Vous pouvez demander cette clé à votre compte de développement Apple, en suivant la procédure décrite à la section Documentation destinée aux équipes de développement Apple.

Procédure de transition ios-transition-steps

Pour déplacer vos applications mobiles iOS vers le mode d’authentification basé sur les jetons, procédez comme suit :

  1. Accédez à Administration > Canaux > Application mobile (SDK AEP).

  2. Sélectionnez l’application mobile spécifique qui nécessite la mise à jour du certificat.

  3. Vérifiez les Mise à jour des informations d’identification de l’application .

  4. Fournissez les ID de l’application (Identifiant du bundle iOS). Vous pouvez trouver le Bundle ID iOS (ID d’application) dans la cible principale de votre application dans Xcode.

  5. Téléchargez votre Fichier de certificat iOS p8.

  6. Renseignez les paramètres de connexion de l'APNS ID de clé et Identifiant d’équipe iOS.

  7. Cliquez sur Enregistrer.

Votre application iOS est maintenant déplacée vers le mode d’authentification basé sur les jetons.

Questions fréquentes push-upgrade-faq

Pouvons-nous conserver le même appID sur l’instance intermédiaire et prod ?
Pour les applications mobiles iOS, vous pouvez utiliser le même ID d’application, qui est votre ID de lot d’applications iOS, pour les environnements d’évaluation et de production. Cependant, sur Android, l’ID d’application doit être unique pour chaque environnement. Par conséquent, notre suggestion consiste à ajouter "stage" à l’ID d’application créé dans l’environnement d’évaluation.
Pouvons-nous simplement migrer l’application Android uniquement ?
Non, les applications Android et iOS doivent être migrées conformément aux étapes décrites ci-dessus.
Quel type de vérification devons-nous effectuer après la migration ?
Nous vous recommandons d’effectuer une validation fonctionnelle de tous vos cas d’utilisation liés aux notifications push.
Que faire en cas d’erreur <>Non autorisé<> lors de l’enregistrement de l’application mobile ?
Il semble s’agir d’un problème d’autorisation lié à la collecte de données Adobe Experience Platform. Pour résoudre ce problème, vous devez ajouter les autorisations "Mobile" et "Mobile App Configuration" dans Adobe Admin Console, comme indiqué dans la section Conditions préalables de cet article.
Les modifications sont-elles requises dans le code de l’application mobile ?
Non, seules les modifications liées à la configuration dans Firebase et le compte de développeur d’applications sont requises. Les modifications apportées à l’application mobile du client ne sont pas requises.
Devons-nous mettre à jour le certificat iOS chaque année ?
Non, après cette migration, il n’est pas nécessaire de mettre à jour le certificat iOS chaque année.
Que se passe-t-il si cette migration n’est pas terminée ?
Les messages push Android commenceront à échouer après le 20 juin 2024, conformément à la notification de Google. En savoir plus.
Les clients peuvent-ils revenir à FCM après avoir terminé la migration FCMv1 ?
Oui, les clients pourront effectuer une migration vers FCM jusqu’au 20 juin 2024. À compter de cette date, l’option de migration ne sera plus disponible.
La migration de l’API HTTP v1 est-elle prise en charge sur l’application mobile SDK V4 ?
Non, les clients doivent d’abord migrer leur application mobile vers le SDK V5, puis procéder à la migration ci-dessus. Il doit le faire en priorité, car son service push commencera à échouer à partir de juin 2024, conformément à la notification de Google.
La modification sur l’instance d’évaluation aura-t-elle un impact sur l’instance de production ?
Non, les modifications apportées à l’application mobile intermédiaire n’ont aucun impact sur l’instance de production.
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff