Dépannage et questions fréquentes concernant Firebase Cloud Messaging

Quelle est la différence entre le compositeur de notifications et FCM ?

Firebase Cloud Messaging fournit un ensemble complet de fonctionnalités de messagerie via ses SDK clients et son protocole de serveur HTTP. FCM est le bon choix pour les déploiements avec des exigences de messagerie plus complexes.

L'outil de création de notifications est une solution de messagerie légère et sans serveur basée sur Firebase Cloud Messaging. Grâce à une console graphique conviviale et à des exigences de codage réduites, le compositeur de notifications permet aux utilisateurs d'envoyer des messages pour réengager et fidéliser les utilisateurs, favoriser la croissance des applications et soutenir les campagnes marketing.

Dois-je utiliser d'autres services Firebase pour utiliser FCM ?

Vous pouvez utiliser Firebase Cloud Messaging comme composant autonome, sans utiliser d'autres services Firebase.

Pourquoi mes appareils cibles ne semblent-ils pas recevoir de messages ?

Si les appareils ne semblent pas recevoir les messages, vérifiez d'abord les deux causes potentielles suivantes :

Gestion des messages au premier plan pour les messages de notification. Les applications clientes doivent ajouter une logique de gestion des messages pour gérer les messages de notification lorsque l'application est au premier plan sur l'appareil. Consultez les détails pour iOS et Android.

Restrictions de pare-feu réseau Si votre organisation dispose d'un pare-feu qui limite le trafic vers ou depuis Internet, vous devez le configurer pour autoriser la connectivité avec FCM afin que vos applications clientes Firebase Cloud Messaging puissent recevoir des messages. Voici les ports à ouvrir :

• 5228
• 5229
• 5230

FCM utilise généralement le port 5228, mais parfois aussi les ports 5229 et 5230. FCM ne fournit pas d'adresses IP spécifiques. Vous devez donc autoriser votre pare-feu à accepter les connexions sortantes vers toutes les adresses IP contenues dans les blocs d'adresses IP listés dans l'ASN 15169 de Google.

Pourquoi onMessageReceived n'est-il pas appelé dans mon application Android ?

Lorsque votre application est en arrière-plan, les messages de notification s'affichent dans la barre d'état système et onMessageReceived n'est pas appelé. Pour les messages de notification avec une charge utile de données, le message de notification s'affiche dans la barre d'état système, et les données incluses dans le message de notification peuvent être récupérées à partir de l'intent lancé lorsque l'utilisateur appuie sur la notification.

Pour en savoir plus, consultez Recevoir et traiter les messages.

Pourquoi est-ce que je reçois une erreur 404 lorsque j'envoie des messages à une instance d'application active restaurée à partir d'une sauvegarde ?

Le FID (ID d'installation Firebase) est l'identifiant d'une instance d'application. Par défaut, les données d'installation Firebase sont sauvegardées et restaurées. Ainsi, dans le cas d'une restauration, l'instance d'application restaurée et l'instance d'application d'origine partagent le même FID. Étant donné que FCM ne stocke qu'un seul jeton par FID, si l'instance d'application d'origine et l'instance d'application restaurée sont toutes deux utilisées, lorsqu'une instance d'application s'enregistre auprès de FCM, le jeton de l'autre instance d'application est supprimé, ce qui entraîne des erreurs 404.

Nous recommandons aux développeurs d'effectuer les actions suivantes dans leur application :

• Excluez les données d'installation Firebase de la sauvegarde. Les données d'installation de Firebase sont stockées dans un fichier PersistedInstallation....json. Le nom de fichier est une constante pour une application. Par exemple, <exclude domain="file" path="PersistedInstallation.W0R...GQ.json" />

Apple a annoncé l'abandon de l'ancien protocole binaire pour APNs. Dois-je faire quelque chose ?

Non. Firebase Cloud Messaging est passé au protocole APNs basé sur HTTP/2 en 2017. Si vous utilisez FCM pour envoyer des notifications aux appareils iOS, aucune action n'est requise de votre part.

Comment puis-je avertir une large clientèle en deux minutes ?

Ce cas d'utilisation n'est pas accepté. Vous devez répartir votre trafic sur cinq minutes.

Mon application informe les utilisateurs d'événements, et ces messages doivent être envoyés immédiatement pour soutenir mon modèle économique. Puis-je obtenir plus de quota ?

Malheureusement, nous ne pouvons pas augmenter votre quota pour cette raison. Vous devez répartir votre trafic sur cinq minutes pour éviter les pics de trafic.

Mes messages concernent des événements programmés. Comment envoyer tout le trafic au début de l'heure ?

Nous vous recommandons de commencer à envoyer les notifications au moins cinq minutes avant l'événement. Vous pouvez également envoyer des messages de données et implémenter l'équivalent du gestionnaire onMessageReceived de votre plate-forme pour planifier des notifications locales à l'avance.

Comment suivre mon utilisation des quotas ?

Consultez les conseils de Google Cloud pour représenter graphiquement et surveiller les métriques de quota.

Les erreurs 429 sont difficiles à gérer pour moi et mon entreprise. Puis-je obtenir une exemption ou un quota plus élevé pour éviter de recevoir des erreurs 429 ?

Nous comprenons que les limites de quota peuvent être contraignantes, mais elles sont essentielles pour garantir la fiabilité du service. Nous ne pouvons donc pas accorder d'exceptions. Utilisez des nouvelles tentatives pour gérer correctement les erreurs 429.

Combien de temps faut-il pour que ma demande d'augmentation de quota soit traitée ?

Votre demande d'augmentation de quota dépend de votre utilisation de FCM. Dans tous les cas, vous devriez recevoir une réponse sous quelques jours ouvrés. Dans certains cas, il peut y avoir des échanges concernant votre utilisation de FCM et diverses circonstances, ce qui peut prolonger le processus. Si toutes les conditions sont remplies, la plupart des demandes sont traitées sous deux semaines.

Puis-je obtenir plus de quota pour un événement temporaire ?

Vous pouvez demander un quota supplémentaire pour un événement d'une durée maximale d'un mois. Envoyez la demande au moins un mois avant l'événement en précisant clairement les dates de début et de fin. FCM fera tout son possible pour y répondre. Si elles sont accordées, ces augmentations de quota seront annulées après la date de fin de l'événement.

Mon quota actuel est-il susceptible d'être modifié ?

Bien que Google ne le fasse pas à la légère, les quotas peuvent être modifiés si nécessaire pour protéger l'intégrité du système. Dans la mesure du possible, Google vous informera à l'avance de ces modifications. Maintenez à jour vos contacts pour le contrat-cadre de services Cloud afin d'augmenter vos chances de recevoir des annonces sur le service.

Quelles API et fonctionnalités sont obsolètes et seront mises hors service ? Que dois-je faire si j'utilise ces API ?

Toutes les API de serveur InstanceId et la fonctionnalité de groupe d'appareils sont obsolètes et seront mises hors service le 29 septembre 2027. Le tableau suivant fournit plus de détails sur les API/fonctionnalités obsolètes et l'action requise.

Si j'utilise le SDK Admin Firebase pour gérer les abonnements aux thèmes, serai-je concerné par l'abandon ? Que dois-je faire ?

Si vous utilisez des versions antérieures du SDK Admin Firebase pour gérer les abonnements aux thèmes, vous serez concerné par l'arrêt de la prise en charge. Vous devrez mettre à niveau votre SDK Admin Firebase vers les versions suivantes :

Vais-je constater une dégradation du service avant le 29 septembre 2027 ?

Non. Vous disposez de 12 mois pour migrer des API obsolètes vers des alternatives sans que le service soit dégradé. Nous vous recommandons vivement de planifier la migration dès que possible afin de ne pas être affecté par l'arrêt de l'ancienne version.

Vous devriez recevoir des erreurs lorsque vous appellerez des API obsolètes après le 29 septembre 2027.