Il firebase push connector include funzioni di manutenzione automatica e tracciamento dettagliato per garantire la qualità dei dati, la coerenza tra dispositivi e la pulizia dei token non più validi.
Queste funzioni operano in background e sono fondamentali per mantenere efficiente il canale push nel tempo, evitando errori di invio e accumulo di record obsoleti.
1. Task pianificato: Pulizia Firebase Recipients
Il connettore esegue periodicamente un task schedulato di manutenzione, denominato “Pulizia Firebase Recipients”, che rimuove i token push obsoleti o non più validi dai database di magnews.
Questo processo riduce il rischio di errori durante l’invio delle notifiche e migliora le prestazioni delle campagne.
Funzione
Identifica i token non più registrati in Firebase (invalidati o scaduti).
Elimina i recipient (associazioni token-contatto) non più attivi.
Aggiorna le statistiche di invio per evitare conteggi errati nei report.
Configurazione
Accedi a Management → AppCenter → Google Firebase Push Connector.
Apri la sezione Scheduled Tasks.
Verifica che il task Pulizia Firebase Recipients sia attivo.
Specifica l’intervallo di esecuzione (es. giornaliero o settimanale).
Comportamento
Se attivo, il task viene eseguito automaticamente dal sistema backend di magnews.
I token eliminati non vengono più considerati per gli invii futuri.
L’operazione viene loggata per scopi di audit interno.
Nota: il task non elimina i contatti dal database, ma solo le associazioni push non valide. I dati dei contatti restano intatti.
2. Tracciamento dei messaggi inviati
Il connettore dispone di una sezione dedicata al trace dei messaggi push, utile per analizzare in dettaglio gli invii e gli esiti di consegna.
La funzione è accessibile tramite AppCenter → Google Firebase Push Connector → Trace of sent messages.
Attivazione del trace
Accedi ad AppCenter.
Nella sezione del connettore, abilita la funzione Trace of sent messages.
Salva la configurazione.
Quando attiva, magnews registra automaticamente ogni notifica inviata, con un record strutturato all’interno di una datatable dedicata.
Struttura della datatable
| Campo | Descrizione |
|---|---|
id_contact | Identificativo del contatto associato alla notifica. |
id_push | Identificativo interno del push inviato. |
app_id | App ID utilizzata per l’invio. |
message_id | Identificatore del messaggio (mn_message_id). |
status | Stato dell’invio (SENT, FAILED, RETRY, ecc.). |
sent_ts | Timestamp di invio. |
delivery_status | Esito ricevuto da Firebase (SUCCESS, INVALID_TOKEN, ecc.). |
error_message | Dettagli in caso di errore. |
I dati sono disponibili per analisi interne, verifica tecnica e integrazioni esterne tramite API o esportazione CSV.
3. Buone pratiche di monitoraggio
Verifica periodicamente la pulizia dei token: i token scaduti o duplicati causano errori e rallentano gli invii.
Analizza regolarmente i log di trace: errori frequenti su specifici App ID possono indicare problemi di configurazione in Firebase o nell’app.
Segmenta i database per piattaforma: mantiene le statistiche più accurate (Android, iOS, Web).
Monitora i tassi di consegna e click: variazioni improvvise possono segnalare aggiornamenti SDK o modifiche nei permessi push.
Documenta le versioni del connettore e le date di aggiornamento: utile per correlare eventuali anomalie a cambi di versione o patch.
Suggerimento: pianifica la pulizia dei recipient in orari di bassa attività (es. notturni) per minimizzare l’impatto sulle campagne schedulate.
4. Troubleshooting e verifiche rapide
| Problema | Possibile causa | Soluzione |
|---|---|---|
| Notifiche non consegnate | Token scaduto o rimosso | Verifica che il task di pulizia sia attivo e funzionante. |
| Invii rallentati | Database con troppi recipient inattivi | Esegui manualmente la pulizia o riduci la frequenza di invio. |
| Eventi non tracciati | App non invia /event | Controlla che il client invii correttamente mn_message_id e push_id_enc. |
| Dati incoerenti tra report e webhook | webhook non attivo o endpoint non raggiungibile | Verifica URL e risposta HTTP. |
5. Controllo post-invio
Dopo ogni campagna push:
Accedi alla sezione Insight → Comunicazioni → Push.
Analizza le metriche di recapito, click e conversione.
Verifica il numero di token eliminati dal task di manutenzione.
In caso di scarti elevati, valuta la rigenerazione o sincronizzazione dei token app-side.