Comprendere la consegna delle notifiche push
Scopri la consegna delle notifiche push, incluso come viene consegnata e perché potrebbe non andare a buon fine.
Consegna delle notifiche push
La consegna di una notifica push si riferisce a quando una notifica push viene consegnata correttamente al dispositivo di un destinatario.
Un profilo può avere più di 1 token push se l’app mobile è installata su più dispositivi. Le notifiche push verranno tentate su tutti i dispositivi con un token memorizzato nel profilo.
Il concetto di deliverability non si applica alle notifiche push come avviene per le e-mail, poiché non viene effettuato alcun ordinamento una volta che il dispositivo del destinatario riceve correttamente la notifica.
Quando invii una notifica push tramite una campagna o un flusso, Klaviyo controlla la notifica push e poi la invia ad Apple Push Notification Service (APNs) per iOS oppure al servizio di notifica push di Android, Firebase Cloud Messaging (FCM), per la consegna al dispositivo del destinatario. Potresti vedere alcune notifiche push saltate se c’è un problema con la consegna.
APNs e FCM accetteranno la notifica e proveranno a recapitarla sul dispositivo del destinatario oppure rifiuteranno la notifica con una serie di possibili errori.
Klaviyo ha approfondimenti solo sul fatto che questi servizi accettino la notifica o la rifiutino. Klaviyo non può confermare se la notifica non riesce dopo che APNs o FCM ha accettato la notifica push.
Vuoi richiedere una funzionalità per le notifiche push di Klaviyo? Compila questo modulo Google per raccontarci di cosa si tratta!
Motivi del rifiuto
Se Klaviyo riceve una risposta di errore da APNs o FCM dopo l’invio di una notifica, viene creato un evento chiamato Push respinta per ogni token interessato dalla consegna non riuscita. Questo verrà visualizzato nel feed attività del profilo del destinatario insieme all’attività del destinatario per il rispettivo flusso o campagna da cui è stata inviata la notifica.
L’evento Push respinto include metadati che mostrano il messaggio del codice di errore (ad es. ExpiredToken) restituito da APNs o Firebase. Se riscontri problemi di consegna, collabora con lo sviluppatore della tua app per risolvere l’errore in base alla descrizione nell’evento.
Per visualizzare i metadati di un evento, fai clic su Dettagli attività dell’evento nel registro attività del profilo.
Notifica push silenziosa
Puoi vedere il tasso di consegna e il tasso di rimbalzo per una singola notifica push silenziosa; tuttavia, le notifiche push silenziose sono escluse da tutta la reportistica sulle prestazioni aggregata in Klaviyo. Sono incluse cose come il tasso di apertura di Mobile Push nel tempo, poiché non hanno aperture o conversioni.
Tieni presente che vedrai eventi diversi per le notifiche push silenziose rispetto alle notifiche push standard, ovvero Ricevuta notifica push silenziosa e Notifica push silenziosa non recapitata.
Se riscontri problemi con la consegna di notifiche push silenziose su iOS, tieni presente che iOS non garantisce la consegna delle notifiche push silenziose. Potrebbero non consegnarle in base allo stato attuale del dispositivo, ad esempio il livello della batteria e la connessione di rete.
iOS
Per le notifiche push iOS inviate tramite APNs, i rifiuti possono verificarsi per almeno uno dei motivi elencati nel riferimento di Apple su come gestire le risposte alle notifiche da APNs.
Codice di stato | Stringa di errore APNs | Descrizione di APNs |
400 | BadDeviceToken | Il token del dispositivo specificato non era valido. Verifica che la richiesta contenga un token valido e che il token corrisponda all’ambiente. |
400 | Argomento errato | Il valore di apns-topic non è valido. |
400 | DeviceTokenNotForTopic | Il token del dispositivo non corrisponde all'argomento specificato. |
400 | IntestazioniDuplicate | Una o più intestazioni sono state ripetute. |
400 | IdleTimeout | Timeout per inattività. |
400 | Tipo di push non valido | Il valore apns-push-type non è valido. |
400 | PayloadEmpty | Il payload del messaggio era vuoto. |
403 | Certificato non valido | Il certificato non era valido. |
403 | Ambiente con certificato non valido | Il certificato client era per l'ambiente sbagliato. |
403 | InvalidProviderToken | Il token del provider non è valido o non è stato possibile verificare la firma del token. |
404 | Percorso non valido | La richiesta conteneva un valore :path non valido. |
405 | Metodo non consentito | Il :method specificato non era POST. |
410 | Token scaduto | Il token del dispositivo è scaduto. |
410 | Non registrato | Il token del dispositivo è inattivo per l’argomento specificato. |
429 | Troppi aggiornamenti del token del provider | Il token del provider viene aggiornato troppo spesso. |
500 | Errore interno del server | Si è verificato un errore interno del server. |
503 | Servizio non disponibile | Il servizio non è disponibile. |
Android
Per le notifiche push Android inviate tramite FCM, i rifiuti possono verificarsi per almeno uno dei motivi elencati nel riferimento di Google per i codici di errore FCM.
Codice di stato | Stringa di errore FCM | Descrizione FCM |
400 | ARGOMENTO_NON_VALIDO | Controlla il formato del token di registrazione che passi al server. Assicurati che corrisponda al token di registrazione che l'app client riceve quando si registra con Firebase Notifications. Non troncare il token e non aggiungere caratteri aggiuntivi. |
400 | ARGOMENTO_NON_VALIDO | Assicurati che il messaggio sia stato indirizzato a un token di registrazione il cui nome del pacchetto corrisponda al valore passato nella richiesta. |
400 | ARGOMENTO_NON_VALIDO | Verifica che la dimensione totale dei dati del payload inclusi in un messaggio non superi i limiti di FCM: 4096 byte per la maggior parte dei messaggi oppure 2048 byte nel caso di messaggi per argomenti. Questo include sia le chiavi sia i valori. |
400 | ARGOMENTO_NON_VALIDO | Verifica che i dati del payload non contengano una chiave (ad esempio from, o gcm, o qualsiasi valore con prefisso google) che viene usata internamente da FCM. Tieni presente che alcune parole (ad esempio collapse_key) vengono usate anche da FCM, ma sono consentite nel payload; in questo caso, il valore del payload verrà sovrascritto dal valore FCM. |
400 | ARGOMENTO_NON_VALIDO | Verifica che il valore usato in ttl sia un numero intero che rappresenta una durata in secondi compresa tra 0 e 2.419.200 (4 settimane). |
400 | ARGOMENTO_NON_VALIDO | Controlla che i parametri forniti abbiano il nome e il tipo corretti. |
403 | SENDER_ID_MISMATCH | L'ID mittente autenticato è diverso dall'ID mittente per il token di registrazione. |
404 | NON REGISTRATO | L’istanza dell’app è stata annullata dalla registrazione in FCM. Di solito significa che il token utilizzato non è più valido e che ne deve essere usato uno nuovo. |
429 | QUOTA_EXCEEDED | Limite di invio superato per il destinatario del messaggio. Viene restituita un’estensione di tipo google.rpc.QuotaFailure per specificare quale quota è stata superata. |
500 | INTERNO | Si è verificato un errore interno sconosciuto. |
503 | Non disponibile | Il server è sovraccarico. |
Vedrai anche un evento Push rimbalzato se manca il destinatario o se ha un token push non valido.
Procedure consigliate
Raccogli il consenso
Per inviare una notifica push standard a un profilo, devi prima raccogliere il suo consenso esplicito .
Per raccogliere il consenso per le notifiche push, devi mostrare ai clienti una richiesta nella schermata delle autorizzazioni durante la loro prima interazione con la tua app mobile.
È consigliabile che il messaggio della schermata delle autorizzazioni includa un testo di consenso che fornisca le seguenti informazioni e consenta di scegliere se aderire o non aderire:
- Tipi di notifiche che il tuo brand invia
Includi dettagli sulle diverse notifiche push che il tuo brand prevede di inviare (ad esempio, modifiche all’account, modifiche all’account, promemoria e sconti speciali). - Perché le persone dovrebbero dare il consenso
Includi informazioni sul motivo per cui un cliente dovrebbe concedere le autorizzazioni (ad esempio, per ricevere aggiornamenti importanti o l’accesso anticipato alle promozioni).
Scopri di più su come raccogliere il consenso alle notifiche push.
Invia notifiche pertinenti
Quando invii campagne di notifiche push, è importante sfruttare la segmentazione di Klaviyo per inviare contenuti personalizzati e pertinenti ai tuoi iscritti.
Ad esempio, se sai di avere un segmento di clienti abituali affezionati, potresti usare le notifiche push per avvisarli di nuove offerte o promozioni prima di chiunque altro.
Assicurandoti che i contenuti che invii alla clientela siano pertinenti ai suoi interessi e alle sue preferenze, puoi ridurre la probabilità che la clientela decida di annullare l’iscrizione e massimizzare la tua capacità di raggiungerla con notifiche push.
Monitora e analizza le prestazioni
È essenziale monitorare costantemente le prestazioni delle notifiche push con Klaviyo per identificare rapidamente i problemi di consegna e i cali nelle metriche push chiave.
Il modo migliore per farlo è monitorare i seguenti eventi di notifica push:
- Notifica push ricevuta
- Notifica push aperta
- Push rimbalzato
Può impostare un report su metriche multiple in Klaviyo per monitorare come le sue prestazioni con questi eventi cambiano nel tempo.
Risorse aggiuntive
- Comprendere il consenso alle notifiche push
Scopri il consenso alle notifiche push e le best practice per la conformità. Queste linee guida possono aiutarti a raccogliere i consensi in modo conforme e a mantenere un rapporto positivo con i tuoi clienti.
- Come inviare una campagna di notifiche push
Scopri come usare Klaviyo per inviare campagne di notifiche push tramite la tua app iOS o Android.
- Comprendere le impostazioni delle notifiche push
Scopri la pagina delle impostazioni delle notifiche push, dove puoi configurare le notifiche push per la tua app mobile e regolare la finestra di Smart Sending.