Imparerai
Impara a conoscere la consegna delle notifiche push, compreso il modo in cui vengono consegnate e perché potrebbero fallire.
Consegna di notifiche pushConsegna di notifiche push
La consegna della notifica push si riferisce a quando una notifica push viene consegnata con successo al dispositivo del destinatario.
Un profilo può avere più di un token push se ha installato la sua applicazione mobile su più dispositivi. Le notifiche push saranno tentate per tutti i dispositivi con un token memorizzato sul profilo.
Il concetto di deliverability non si applica alle notifiche push come alle e-mail, in quanto non viene effettuato alcuno smistamento una volta che il dispositivo del destinatario ha ricevuto con successo la notifica.
Quando invia una notifica push attraverso una campagna o un flusso, Klaviyo controlla il push e poi lo invia al servizio di notifica push di Apple (APNs) per iOS, o al servizio di notifica push di Android, Firebase Cloud Messaging (FCM) per la consegna al dispositivo del destinatario. Potrebbe vedere alcune notifiche push saltate se c'è un problema di consegna.
Gli APN e gli FCM accetteranno la notifica e tenteranno di consegnarla al dispositivo del destinatario, oppure rifiuteranno la notifica con una serie di possibili errori.
Klaviyo sa solo se questi servizi accettano la notifica o la rifiutano. Klaviyo non può confermare se la notifica fallisce dopo che gli APN o l'FCM accettano il push.
Vuole richiedere una funzionalità per le notifiche push di Klaviyo? Compili questo modulo Google per parlarcene!
Motivi del rifiuto
Se Klaviyo riceve una risposta di errore da APN o FCM dopo l'invio di una notifica, viene creato un evento chiamato Bounced push per ogni token interessato dalla mancata consegna. Questo apparirà nel feed di attività del profilo ricevente insieme all'attività del destinatario per il rispettivo flusso o campagna da cui è stata inviata la notifica.
L'evento push Bounced include metadati che mostrano il messaggio di codice di errore (ad esempio, ExpiredToken) restituito da APN o Firebase. Se riscontra problemi di consegna, collabori con lo sviluppatore della sua app per risolvere l'errore in base alla descrizione dell'evento.
Per visualizzare i metadati di un evento, clicchi su Dettagli attività per l'evento nel registro attività del profilo.
iOS
Per le notifiche push iOS inviate tramite APN, i rifiuti possono verificarsi per almeno uno dei motivi elencati nel riferimento di Apple per la gestione delle risposte alle notifiche da parte degli APN.
| Codice di stato |
Stringa di errore APN |
Descrizione degli APN |
|
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 |
BadTopic |
Il valore apns-topic non è valido. |
|
400 |
DeviceTokenNotForTopic |
Il token del dispositivo non corrisponde all'argomento specificato. |
|
400 |
DuplicateHeaders |
Una o più intestazioni sono state ripetute. |
|
400 |
IdleTimeout |
Time out inattivo. |
|
400 |
InvalidPushType |
Il valore apns-push-type non è valido. |
|
400 |
PayloadEmpty |
Il carico utile del messaggio era vuoto. |
|
403 |
CattivoCertificato |
Il certificato era scadente. |
|
403 |
BadCertificateEnvironment |
Il certificato del cliente era per l'ambiente sbagliato. |
|
403 |
InvalidProviderToken |
Il token del fornitore non è valido o non è stato possibile verificare la firma del token. |
|
404 |
BadPath |
La richiesta conteneva un valore :path errato. |
|
405 |
MetodoNonConsentito |
Il metodo :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 providerToken |
Il token del fornitore viene aggiornato troppo spesso. |
|
500 |
InternalServerError |
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_INVALIDO |
Verifichi il formato del token di registrazione che passa al server. Si assicuri che corrisponda al token di registrazione che l'app client riceve dalla registrazione con Firebase Notifications. Non tronchi o aggiunga caratteri aggiuntivi. |
|
400 |
ARGOMENTO_INVALIDO |
Si assicuri che il messaggio sia stato indirizzato a un token di registrazione il cui nome del pacchetto corrisponde al valore passato nella richiesta. |
|
400 |
ARGOMENTO_INVALIDO |
Verificare che la dimensione totale dei dati del carico utile inclusi in un messaggio non superi i limiti FCM: 4096 byte per la maggior parte dei messaggi, o 2048 byte nel caso di messaggi agli argomenti. Questo include sia le chiavi che i valori. |
|
400 |
ARGOMENTO_INVALIDO |
Verificare che i dati del payload non contengano una chiave (come from, o gcm, o qualsiasi valore preceduto da google) che viene utilizzata internamente da FCM. Si noti che alcune parole (come collapse_key) sono utilizzate anche da FCM ma sono consentite nel payload, nel qual caso il valore del payload sarà sovrascritto dal valore di FCM. |
|
400 |
ARGOMENTO_INVALIDO |
Verifichi che il valore utilizzato in ttl sia un numero intero che rappresenta una durata in secondi compresa tra 0 e 2.419.200 (4 settimane). |
|
400 |
ARGOMENTO_INVALIDO |
Verifica che i parametri forniti abbiano il nome e il tipo giusto. |
|
403 |
MITTENTE_ID_MISMATCH |
L'ID mittente autenticato è diverso dall'ID mittente del token di registrazione. |
|
404 |
REGISTRATO |
L'istanza dell'app non è stata registrata da FCM. Questo di solito significa che il token utilizzato non è più valido e bisogna utilizzarne uno nuovo. |
|
429 |
QUOTA_ESEGUITA |
Limite di invio superato per il target 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 |
INDISPONIBILE |
Il server è sovraccarico. |
Vedrà anche un evento push Bounced se il destinatario manca o ha un token push non valido.
Le migliori pratiche
Raccogliere il consenso dell'utenteRaccogliere il consenso dell'utente
Per inviare una notifica push a un profilo, deve prima raccogliere il suo consenso esplicito .
Per raccogliere il consenso alle notifiche push, deve fornire ai clienti una schermata di autorizzazione durante la loro prima interazione con la sua app mobile.
La prassi migliore è che la schermata di richiesta di autorizzazione includa un linguaggio di consenso che fornisca le seguenti informazioni e che consenta di scegliere se partecipare o meno:
-
Quali tipi di notifiche invia il suo marchio
Includa dettagli sulle diverse notifiche push che il suo marchio intende inviare (ad esempio, modifiche dell'account, cambi di account, promemoria e sconti speciali). -
Perché gli utenti dovrebbero aderire
Includa informazioni sul motivo per cui un cliente dovrebbe fornire le autorizzazioni (ad esempio, per ricevere aggiornamenti importanti o accesso anticipato alle vendite).
Per saperne di più sulla raccolta del consenso alle notifiche push .
Inviare notifiche pertinenti
Quando invia campagne di notifica push, è importante sfruttare la segmentazione di Klaviyo per inviare contenuti personalizzati e rilevanti per i suoi abbonati.
Ad esempio, se sa di avere un segmento di clienti abituali dedicati, può utilizzare le notifiche push per avvisarli di nuove offerte o promozioni prima di chiunque altro.
Assicurandosi che i contenuti che invia ai clienti siano pertinenti ai loro interessi e alle loro preferenze, può ridurre la probabilità che i clienti si ritirino e massimizzare la sua capacità di raggiungere i clienti con le notifiche push.
Monitorare e analizzare le prestazioniMonitorare e analizzare le prestazioni
È essenziale monitorare costantemente le prestazioni delle sue 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:
- Spinta ricevuta
- Spinta aperta
- Spinta rimbalzata
Può impostare un rapporto multimetrico in Klaviyo per monitorare come le sue prestazioni con questi eventi cambiano nel tempo.
Risorse aggiuntiveRisorse aggiuntive
Capire il consenso alle notifiche push