Comprendere la consegna delle notifiche push
Scopri la consegna delle notifiche push, incluso come vengono consegnate le notifiche e perché la consegna potrebbe non riuscire.
Consegna delle notifiche push
Klaviyo registra un evento Received Push quando il servizio di notifica push di Apple o Google accetta una notifica push standard per la consegna. Questo non conferma che la notifica abbia raggiunto il dispositivo del destinatario.
Un profilo può avere più di 1 token push se ha installato la tua app mobile su più dispositivi. Per impostazione predefinita, Klaviyo tenta la consegna su tutti i dispositivi idonei. In Consegna push, puoi selezionare Entrambi, iOS o Android e scegliere Tutti i dispositivi o Dispositivo principale (1 dispositivo per profilo). Se selezioni Dispositivo principale e quel dispositivo non corrisponde alla piattaforma selezionata, il profilo viene ignorato.
Il concetto di deliverability non si applica alle notifiche push come avviene per le e-mail, perché le notifiche push non prevedono il posizionamento nella casella di posta o nella cartella spam. Le impostazioni di notifica di un dispositivo possono comunque influire su quando e come viene visualizzata una 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. Una notifica può essere saltata prima di raggiungere questi servizi, ad esempio se il profilo non ha un token push o ha negato l’autorizzazione per le notifiche push standard.
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 respinto 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 la campagna da cui è stata inviata la notifica.
L’evento Bounced Push 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 chi sviluppa la tua app per risolvere l’errore in base alla descrizione nell’evento.
Per visualizzare i metadati di un evento, apri il menu dell’evento nel registro attività del profilo e seleziona Dettagli attività.
Notifica push silenziosa
Puoi vedere il tasso di consegna e il tasso di rimbalzo per una singola notifica push silenziosa. Le notifiche push silenziose usano metriche di consegna e di rimbalzo separate e non contribuiscono con aperture o conversioni attribuite alla reportistica standard sulle prestazioni delle notifiche push. Puoi anche selezionare le metriche delle notifiche push silenziose in un Report su metriche multiple.
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. |
Un profilo senza token push viene saltato prima che Klaviyo contatti APNs o FCM. Se un servizio rifiuta un token non valido o scaduto, Klaviyo registra un evento Push respinto. I token possono diventare non validi dopo che qualcuno disinstalla la tua app. Klaviyo rimuove i token che il servizio segnala come non registrati o scaduti.
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 alle notifiche push, invita i clienti ad abilitare le notifiche tramite la richiesta di autorizzazione nativa della tua app. Scegli un momento in cui i clienti possano capire perché riceverebbero le notifiche.
Come best practice, usa un linguaggio di consenso chiaro nella tua app e lascia che i clienti scelgano se attivare le notifiche push. Spiega quanto segue:
- Tipi di notifiche inviate dal tuo brand
Includi dettagli sulle diverse notifiche push che il tuo brand prevede di inviare (ad esempio, modifiche dell’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.