Risoluzione dei problemi e domande frequenti di Firebase Cloud Messaging

Qual è la differenza tra il compositore di notifiche e FCM?

Firebase Cloud Messaging fornisce un set completo di funzionalità di messaggistica tramite i suoi SDK client e il protocollo del server HTTP. Per le implementazioni con requisiti di messaggistica più complessi, FCM è la scelta giusta.

Il compositore di notifiche è una soluzione di messaggistica serverless leggera basata su Firebase Cloud Messaging. Grazie a una console grafica intuitiva e a requisiti di codifica ridotti, il compositore di notifiche consente agli utenti di inviare messaggi per coinvolgere e fidelizzare gli utenti, favorire la crescita delle app e supportare le campagne di marketing.

Devo utilizzare altri servizi Firebase per utilizzare FCM?

Puoi utilizzare Firebase Cloud Messaging come componente autonomo, senza utilizzare altri servizi Firebase.

Perché i miei dispositivi target non riescono apparentemente a ricevere messaggi?

Quando sembra che i dispositivi non abbiano ricevuto correttamente i messaggi, controlla prima queste due potenziali cause:

Gestione dei messaggi in primo piano per i messaggi di notifica. Le app client devono aggiungere la logica di gestione dei messaggi per gestire i messaggi di notifica quando l'app è in primo piano sul dispositivo. Consulta i dettagli per iOS e Android.

Limitazioni del firewall di rete. Se la tua organizzazione dispone di un firewall che limita il traffico da o verso internet, devi configurarlo per consentire la connettività con FCM affinché le app client Firebase Cloud Messaging ricevano i messaggi. Le porte da aprire sono:

• 5228
• 5229
• 5230

FCM di solito utilizza la porta 5228, ma a volte utilizza le porte 5229 e 5230. FCM non fornisce IP specifici, pertanto devi consentire al firewall di accettare connessioni in uscita a tutti gli indirizzi IP contenuti nei blocchi IP elencati nell'ASN 15169 di Google.

Perché onMessageReceived non viene chiamato nella mia app per Android?

Quando l'app è in background, i messaggi di notifica vengono visualizzati nella barra delle applicazioni e onMessageReceived non viene chiamato. Per i messaggi di notifica con un payload di dati, il messaggio di notifica viene visualizzato nella barra delle applicazioni e i dati inclusi nel messaggio di notifica possono essere recuperati dall'intent avviato quando l'utente tocca la notifica.

Per saperne di più, consulta Ricevere e gestire i messaggi.

Perché ricevo l'errore 404 quando invio messaggi a un'istanza dell'app attiva ripristinata da un backup?

L'ID installazione Firebase (FID) è l'identificatore di un'istanza dell'app. Per impostazione predefinita, i dati di installazione Firebase vengono sottoposti a backup e ripristinati. Pertanto, nel caso del ripristino, l'istanza dell'app ripristinata e l'istanza dell'app originale condividono lo stesso FID. Poiché FCM memorizza un solo token per FID, se sono in uso sia l'istanza dell'app originale sia quella ripristinata, quando un'istanza dell'app si registra con FCM, il token dell'altra istanza dell'app viene rimosso, causando errori 404.

Consigliamo agli sviluppatori di procedere come segue nella propria app:

• Escludi i dati di installazione di Firebase dal backup. I dati di installazione di Firebase vengono archiviati in un file PersistedInstallation....json. Il nome file è una costante per un'app. Ad esempio, <exclude domain="file" path="PersistedInstallation.W0R...GQ.json" />

Apple ha annunciato il ritiro del protocollo binario legacy per APN. Devo fare qualcosa?

No. Firebase Cloud Messaging è passato al protocollo APN basato su HTTP/2 nel 2017. Se utilizzi FCM per inviare notifiche ai dispositivi iOS, non dovresti dover fare nulla.

Come faccio a inviare una notifica a un'ampia base di clienti in 2 minuti?

Questo caso d'uso non può essere supportato. Devi distribuire il traffico su 5 minuti.

La mia app invia notifiche agli utenti di eventi e questi messaggi devono essere recapitati immediatamente per supportare la mia impresa. Posso ottenere più quota?

Purtroppo, non possiamo concedere aumenti della quota per questo motivo. Devi distribuire il traffico su 5 minuti per evitare picchi di traffico.

I miei messaggi riguardano eventi programmati. Come faccio a inviare tutto il traffico all'inizio dell'ora?

Ti consigliamo di iniziare a inviare le notifiche almeno 5 minuti prima dell'evento. In alternativa, invia messaggi di dati e implementa l'equivalente del gestore onMessageReceived della tua piattaforma per pianificare le notifiche locali in anticipo.

Come posso monitorare l'utilizzo della quota?

Consulta le indicazioni di Google Cloud su come creare grafici e monitorare le metriche delle quote.

Gli errori 429 sono difficili da gestire per me e la mia impresa. Posso ottenere un'esenzione o una quota maggiore per evitare di ricevere errori 429?

Sebbene ci rendiamo conto che i limiti di quota possano essere difficili da gestire, le quote sono fondamentali per mantenere l'affidabilità del servizio e non possiamo concedere esenzioni. Utilizza i nuovi tentativi per gestire correttamente gli errori 429.

Quanto tempo ci vuole per soddisfare la mia richiesta di aumento della quota?

La tua richiesta di aumento della quota dipende dal tuo utilizzo di FCM. In ogni caso, dovresti ricevere una risposta entro pochi giorni lavorativi. In alcuni casi, potrebbero esserci alcuni scambi di comunicazioni in merito al tuo utilizzo di FCM e a varie circostanze, il che può prolungare la procedura. Se tutti i requisiti sono soddisfatti, la maggior parte delle richieste verrà gestita entro 2 settimane.

Posso ottenere una quota maggiore per un evento temporaneo?

Puoi richiedere una quota aggiuntiva per supportare un evento della durata massima di un mese. Invia la richiesta almeno un mese prima dell'evento e con dettagli chiari su quando inizia e termina l'evento. FCM farà ogni sforzo pratico per soddisfare la richiesta. Se concessi, questi aumenti della quota verranno ripristinati dopo la data di fine dell'evento.

La mia quota attuale è soggetta a modifiche?

Anche se Google non lo farà alla leggera, le quote potrebbero essere modificate in base alle esigenze per proteggere l'integrità del sistema. Se possibile, Google ti avviserà in anticipo di queste modifiche. Mantieni aggiornati i tuoi contatti Cloud MSA per aumentare le probabilità di ricevere annunci di servizio.

Quali API e funzionalità sono deprecate e verranno ritirate? Che cosa devo fare se utilizzo queste API?

Tutte le API server InstanceId e la funzionalità dei gruppi di dispositivi sono ritirate e verranno ritirate il 29 settembre 2027. La tabella seguente mostra maggiori dettagli sulle API/funzionalità ritirate e sull'azione richiesta.

Se utilizzo l'SDK Firebase Admin per gestire le iscrizioni agli argomenti, sarò interessato dal ritiro? Che cosa devo fare?

Se utilizzi versioni precedenti dell'SDK Firebase Admin per gestire le iscrizioni agli argomenti, la deprecazione ti interesserà. Dovrai eseguire l'upgrade dell'SDK Firebase Admin alle seguenti versioni:

Vedrò un downgrade del servizio prima del 29 settembre 2027?

No. Hai 12 mesi di tempo per eseguire la migrazione dalle API ritirate alle alternative senza alcun downgrade del servizio. Ti consigliamo vivamente di pianificare la migrazione il prima possibile per evitare problemi dovuti al ritiro.

È previsto che riceverai errori quando chiami le API ritirate dopo il 29 settembre 2027.