Risoluzione dei problemi e domande frequenti di Firebase Cloud Messaging

Questa pagina fornisce assistenza per la risoluzione dei problemi e risposte alle domande frequenti su Cloud Messaging.

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

Firebase Cloud Messaging fornisce un set completo di funzionalità di messaggistica tramite gli SDK client e il protocollo server HTTP. Per i deployment 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 di facile utilizzo e a requisiti di codifica ridotti, il compositore di notifiche consente agli utenti di inviare messaggi per coinvolgere e fidelizzare gli utenti, promuovere la crescita delle app e supportare le campagne di marketing.

Funzionalità		Compositore di notifiche	Cloud Messaging
Destinazione	Singolo dispositivo
	Clienti iscritti ad argomenti (ad es. meteo)
	Clienti in un segmento utenti predefinito (app, versione, lingua)
	Clienti nei segmenti di pubblico di Analytics specificati
	Clienti nei gruppi di dispositivi
	Upstream da client a server
Tipo di messaggio	Notifiche fino a 2 KB
	Messaggi di dati fino a 4 KB
Pubblicazione	Immediata
	Ora locale del dispositivo client futura
Analytics	Raccolta di dati analitici delle notifiche e analisi della canalizzazione integrate

Devo utilizzare altri servizi Firebase per poter utilizzare FCM?

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

Perché sembra che i miei dispositivi di destinazione non ricevano i messaggi?

Se 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 una 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 ha un firewall che limita il traffico da o verso internet, devi configurarlo per consentire la connettività con FCM affinché le app client di Firebase Cloud Messaging ricevano i messaggi. Le porte da aprire sono:

• 5228
• 5229
• 5230

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

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

Quando l'app è in background, notifica messaggi 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 un errore 404 quando invio messaggi a un'istanza dell'app attiva ripristinata da un backup?

FID (Firebase Installation ID) è l'identificatore di un'istanza dell'app. Per impostazione predefinita, i dati di installazione di 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 l'istanza dell'app ripristinata, quando un'istanza dell'app si registra con FCM, il token dell'altra istanza dell'app viene rimosso, causando errori 404.

Ti consigliamo di eseguire le seguenti operazioni nella tua app:

• Escludi i dati di installazione di Firebase dal backup. I dati di installazione di Firebase vengono memorizzati 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 che ritirerà il 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.

FCM quote e limiti

Come faccio a inviare una notifica a una base di clienti di grandi dimensioni entro 2 minuti?

Questo caso d'uso non è supportato. Devi distribuire il traffico su 5 minuti.

La mia app invia notifiche agli utenti in merito agli eventi e questi messaggi devono essere inviati immediatamente per supportare la mia impresa. Posso ottenere una quota maggiore?

Purtroppo, non possiamo concedere aumenti di 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'analogo del gestore onMessageReceived della tua piattaforma per programmare le notifiche locali in anticipo.

Come faccio a monitorare l'utilizzo della quota?

Consulta le indicazioni di Google Cloud su come rappresentare graficamente e monitorare le metriche della quota.

Per me e la mia impresa è difficile gestire gli errori 429. Posso ottenere un'esenzione o una quota maggiore per evitare di ricevere errori 429?

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

Quanto tempo ci vorrà 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, puoi aspettarti una risposta entro pochi giorni lavorativi. In alcuni casi, potrebbero essere necessari alcuni scambi di informazioni 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 viene 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 1 mese. Presenta la richiesta almeno 1 mese prima dell'evento e fornisci dettagli chiari su quando inizia e termina l'evento. FCM farà ogni sforzo pratico per soddisfare la richiesta. Se concessi, questi aumenti di quota verranno ripristinati dopo la data di fine dell'evento.

La mia quota attuale è soggetta a modifiche?

Sebbene Google non lo faccia con leggerezza, le quote possono essere modificate in base alle esigenze per proteggere l'integrità del sistema. Quando possibile, Google ti avviserà in anticipo di queste modifiche. Mantieni aggiornati i contatti MSA Cloud per aumentare le probabilità di ricevere annunci di servizio.