Vous apprendrez
Renseignez-vous sur la diffusion des notifications push, notamment sur la manière dont elles sont diffusées et sur les raisons pour lesquelles elles peuvent échouer.
Envoi de notifications pushEnvoi de notifications push
La livraison d'une notification push correspond au moment où une notification push est livrée avec succès à l'appareil d'un destinataire.
Un profil peut avoir plus d'un jeton push s'il a installé votre application mobile sur plusieurs appareils. Les notifications push seront tentées pour tous les appareils avec un jeton stocké sur le profil.
Le concept de délivrabilité ne s'applique pas aux notifications push comme c'est le cas pour le courrier électronique, car il n'y a pas de tri effectué une fois que l'appareil du destinataire a bien reçu la notification.
Lorsque vous envoyez une notification push par le biais d'une campagne ou d'un flux, Klaviyo vérifie le push et l'envoie ensuite au service de notification push d'Apple (APN) pour iOS, ou au service de notification push d'Android, Firebase Cloud Messaging (FCM), pour qu'il soit délivré à l'appareil du destinataire. Il se peut que certaines notifications push soient ignorées en cas de problème de livraison.
Les APN et les FCM acceptent la notification et tentent de la transmettre à l'appareil du destinataire, ou la rejettent en indiquant une série d'erreurs possibles.
Klaviyo ne sait que si ces services acceptent ou rejettent la notification. Klaviyo ne peut pas confirmer si la notification échoue après que l'APN ou le FCM ait accepté le push.
Vous souhaitez demander une fonctionnalité pour les notifications push de Klaviyo ? Remplissez ce formulaire Google pour nous en parler !
Motifs de rejet
Si Klaviyo reçoit une réponse d'erreur de la part des APNs ou FCM après avoir envoyé une notification, un événement appelé Bounced push est créé pour chaque token concerné par l'échec de la livraison. Elle apparaîtra dans le flux d'activité du profil destinataire avec l'activité du destinataire pour le flux ou la campagne à partir duquel la notification a été envoyée.
L'événement push Bounced comprend des métadonnées qui indiquent le code d'erreur (par exemple, ExpiredToken) renvoyé par les APN ou Firebase. Si vous rencontrez des problèmes de livraison, travaillez avec le développeur de votre application pour résoudre l'erreur en vous basant sur la description de l'événement.
Pour afficher les métadonnées d'un événement, cliquez sur Détails de l'activité de l'événement dans le journal d'activité du profil.
iOS
Pour les notifications push iOS envoyées par l'intermédiaire d'APN, des rejets peuvent se produire pour au moins l'une des raisons énumérées dans la référence d'Apple pour le traitement des réponses de notification provenant d'APN.
| Code d'état |
Chaîne d'erreur APNs |
Description des APN |
|
400 |
BadDeviceToken |
Le jeton de périphérique spécifié était mauvais. Vérifiez que la demande contient un jeton valide et que ce jeton correspond à l'environnement. |
|
400 |
BadTopic |
La valeur apns-topic n'est pas valide. |
|
400 |
DeviceTokenNotForTopic |
Le jeton d'appareil ne correspond pas au sujet spécifié. |
|
400 |
DuplicateHeaders |
Un ou plusieurs en-têtes ont été répétés. |
|
400 |
Délai d'inactivité |
Temps mort. |
|
400 |
InvalidPushType |
La valeur apns-push-type n'est pas valide. |
|
400 |
PayloadEmpty |
La charge utile du message était vide. |
|
403 |
Mauvais certificat |
Le certificat était mauvais. |
|
403 |
Mauvais environnement de certificat |
Le certificat du client n'était pas destiné au bon environnement. |
|
403 |
InvalidProviderToken |
Le jeton du fournisseur n'est pas valide ou la signature du jeton n'a pas pu être vérifiée. |
|
404 |
Mauvais chemin |
La demande contient une mauvaise valeur :path. |
|
405 |
Méthode non autorisée |
La méthode :spécifiée n'est pas POST. |
|
410 |
ExpiredToken |
Le jeton de l'appareil a expiré. |
|
410 |
Non enregistré |
Le jeton de périphérique est inactif pour le sujet spécifié. |
|
429 |
TooManyProviderTokenUpdates (mises à jour trop nombreuses du fournisseur) |
Le jeton du fournisseur est mis à jour trop souvent. |
|
500 |
Erreur du serveur interne |
Une erreur interne du serveur s'est produite. |
|
503 |
Service indisponible |
Le service est indisponible. |
Android
Pour les notifications push Android envoyées par le FCM, des rejets peuvent se produire pour au moins l'une des raisons énumérées dans la référence de Google pour les codes d'erreur du FCM.
|
Code d'état |
Chaîne d'erreur FCM |
Description du FCM |
|
400 |
ARGUMENT_INVALIDE |
Vérifiez le format du jeton d'enregistrement que vous transmettez au serveur. Assurez-vous qu'il correspond au jeton d'enregistrement que l'application cliente reçoit lorsqu'elle s'enregistre auprès de Firebase Notifications. Ne tronquez pas et n'ajoutez pas de caractères supplémentaires. |
|
400 |
ARGUMENT_INVALIDE |
Assurez-vous que le message a été adressé à un jeton d'enregistrement dont le nom de paquetage correspond à la valeur transmise dans la demande. |
|
400 |
ARGUMENT_INVALIDE |
Vérifiez que la taille totale des données utiles incluses dans un message ne dépasse pas les limites du FCM : 4096 octets pour la plupart des messages, ou 2048 octets dans le cas des messages aux sujets. Cela comprend à la fois les clés et les valeurs. |
|
400 |
ARGUMENT_INVALIDE |
Vérifiez que les données de la charge utile ne contiennent pas de clé (telle que from, ou gcm, ou toute valeur préfixée par google) utilisée en interne par le FCM. Notez que certains mots (tels que collapse_key) sont également utilisés par le FCM mais sont autorisés dans la charge utile, auquel cas la valeur de la charge utile sera remplacée par la valeur du FCM. |
|
400 |
ARGUMENT_INVALIDE |
Vérifiez que la valeur utilisée dans ttl est un entier représentant une durée en secondes comprise entre 0 et 2 419 200 (4 semaines). |
|
400 |
ARGUMENT_INVALIDE |
Vérifiez que les paramètres fournis ont le bon nom et le bon type. |
|
403 |
INCOMPATIBILITÉ DE L'IDENTIFIANT DE L'EXPÉDITEUR (SENDER_ID_MISMATCH) |
L'ID de l'expéditeur authentifié est différent de l'ID de l'expéditeur du jeton d'enregistrement. |
|
404 |
UNREGISTERED |
L'instance de l'application a été désenregistrée du FCM. Cela signifie généralement que le jeton utilisé n'est plus valide et qu'il faut en utiliser un nouveau. |
|
429 |
QUOTA_EXCEEDED |
Limite d'envoi dépassée pour la cible du message. Une extension de type google.rpc.QuotaFailure est renvoyée pour indiquer quel quota a été dépassé. |
|
500 |
INTERNE |
Une erreur interne inconnue s'est produite. |
|
503 |
NON DISPONIBLE |
Le serveur est surchargé. |
Vous verrez également un événement "Bounced push " si le destinataire n'est pas présent ou si son jeton de poussée n'est pas valide.
Meilleures pratiques
Recueillir le consentement de l'utilisateurRecueillir le consentement de l'utilisateur
Pour envoyer une notification push à un profil, vous devez d'abord obtenir son consentement explicite .
Pour recueillir le consentement à l'envoi de notifications push, vous devez proposer aux clients un écran d'autorisation lors de leur première interaction avec votre application mobile.
La meilleure pratique consiste à inclure dans l'invite de votre écran d'autorisation un langage de consentement qui fournit les informations suivantes et permet aux utilisateurs d'accepter ou de refuser l'invitation :
-
Quels types de notifications votre marque envoie-t-elle
Incluez des détails sur les différentes notifications push que votre marque prévoit d'envoyer (par exemple, changements de compte, rappels et remises spéciales). -
Pourquoi les utilisateurs doivent-ils accepter
Incluez des informations sur les raisons pour lesquelles un client doit accorder des autorisations (par exemple, pour recevoir des mises à jour importantes ou un accès anticipé aux ventes).
En savoir plus sur le recueil du consentement à la notification push .
Envoyez des notifications pertinentes
Lorsque vous envoyez des campagnes de notification push, il est important de tirer parti de la segmentation de Klaviyo pour envoyer un contenu personnalisé et pertinent à vos abonnés.
Par exemple, si vous savez que vous avez un segment de clients fidèles, vous pouvez utiliser les notifications push pour les avertir avant tout le monde des nouvelles offres ou promotions.
En veillant à ce que le contenu que vous envoyez à vos clients corresponde à leurs intérêts et à leurs préférences, vous pouvez réduire la probabilité que les clients se désabonnent et maximiser votre capacité à atteindre vos clients grâce aux notifications push.
Contrôler et analyser les performancesContrôler et analyser les performances
Il est essentiel de surveiller en permanence les performances de vos notifications push avec Klaviyo afin d'identifier rapidement les problèmes de livraison et les baisses des indicateurs clés de push.
La meilleure façon de le faire est de surveiller les événements de notification push suivants :
- Poussée reçue
- Poussée ouverte
- Poussée rebondissante
Vous pouvez créer un rapport multi-métrique dans Klaviyo pour suivre l'évolution de vos performances dans le cadre de ces événements.
Ressources complémentairesRessources complémentaires
Comprendre le consentement à la notification push