Les retours sont le résultat d'une tentative de diffusion ayant échoué pour laquelle le FAI renvoie des avis d'échec. Le traitement de la gestion des retours est un aspect essentiel de l'hygiène des listes. Une fois qu'un e-mail donné a été retourné plusieurs fois de suite, ce processus le signale pour qu'il soit supprimé.
Ce processus empêche les systèmes de continuer à envoyer des e-mails à des adresses e-mail non valides. Les retours sont l'un des éléments clés des données que les FAI utilisent pour déterminer la réputation des adresses IP. Il est important de garder un œil sur cette mesure. « Diffusé » par rapport à « Retourné » est probablement le moyen le plus courant de mesurer la diffusion des messages marketing : plus le pourcentage de diffusion est élevé, mieux c'est.
Si un message ne peut pas être envoyé à un profil, le serveur distant envoie automatiquement un message d'erreur à Adobe Campaign. Cette erreur est qualifiée pour déterminer si l'adresse e-mail, le numéro de téléphone ou l'appareil doit être mis en quarantaine. Pour plus d'informations, consultez la section Qualification des e-mails bounce.
Une fois un message envoyé, vous pouvez visualiser l'état de la diffusion pour chaque profil, le type d'échec et la raison associés dans les logs de diffusion.
Lorsqu'une adresse e-mail est mise en quarantaine ou qu'un profil est en liste bloquée, le destinataire est exclu à l'étape de préparation des diffusions. Les messages exclus sont répertoriés dans le tableau de bord de la diffusion.
Deux types d'erreur sont liés à un message en échec. Chaque type d'échec de diffusion détermine si une adresse est envoyée en quarantaine ou non.
Erreurs hard
Les erreurs hard sont des échecs permanents générés lorsqu'un FAI détermine qu'une tentative de publipostage vers une adresse d'abonné n'est pas livrable. Dans Adobe Campaign, les erreurs hard classées comme non livrables sont ajoutées à la liste de quarantaine, ce qui signifie qu'elles ne seront pas retentées. Dans certains cas, une erreur hard peut être ignorée si la cause de l'échec est inconnue.
Voici quelques exemples courants d'erreurs hard : adresse inexistante, compte désactivé, syntaxe incorrecte, domaine incorrect.
Erreurs soft
Les erreurs soft sont des échecs temporaires que les FAI génèrent lorsqu'ils ont des difficultés à diffuser des e-mails. Les échecs de type soft feront l'objet de plusieurs reprises (avec des variations selon l'utilisation de paramètres de diffusion personnalisés ou prêts à l'emploi) afin de tenter une diffusion réussie. Les adresses qui continuent à provoquer des erreurs soft ne seront pas mises en quarantaine tant que le nombre maximum de reprises n'aura pas été tenté (qui varie encore selon les paramètres).
Voici quelques causes courantes des erreurs soft : boîte pleine, serveur de messagerie de réception en panne, problèmes de réputation de l'expéditeur
Le type d'erreur ignoré est une erreur temporaire, par exemple « Absent du bureau », ou une erreur technique, par exemple si l'expéditeur est de type « postmaster ».
La boucle des retours fonctionne comme les e-mails rebonds : lorsqu'un utilisateur qualifie un e-mail de spam, vous pouvez configurer des règles de messagerie dans Adobe Campaign pour bloquer toutes les diffusions à cet utilisateur. Les adresses de ces utilisateurs figurent sur la liste bloquée même s'ils n'ont pas cliqué sur le lien de désinscription. Les adresses sont ajoutées à la table des quarantaines (NmsAddress) et non à la table des destinataires (NmsRecipient), avec le statut Placée sur la liste bloquée. Apprenez-en davantage sur le mécanisme de boucle des retours dans le guide des bonnes pratiques en matière de délivrabilité d'Adobe.
Une diffusion de message peut échouer immédiatement. Dans ce cas, nous qualifions cela d'erreur synchrone. Si l'envoi du message échoue ou si l'envoi échoue plus tard, une fois qu'il a été envoyé, l'erreur est asynchrone.
Ces types d'erreurs sont gérés comme suit :
Erreur synchrone : le serveur distant contacté par le serveur de diffusion Adobe Campaign retourne immédiatement un message d'erreur. L'envoi de la diffusion au serveur du profil n'est pas autorisé. Le MTA (Mail Transfer Agent) détermine le type de rebond et qualifie l’erreur, puis renvoie ces informations à Campaign afin de déterminer si les adresses e-mail concernées doivent être mises en quarantaine. Voir Qualification des e-mails bounce.
Erreur asynchrone : un e-mail bounce ou un SR est renvoyé plus tard par le serveur de réception. Cette erreur est qualifiée avec un libellé associé à l'erreur. Les erreurs asynchrones peuvent se produire jusqu'à une semaine après l'envoi d'une diffusion.
En tant qu’utilisateur de Managed Cloud Services, la configuration de la boîte de réception de rebonds est réalisée par Adobe.
Actuellement, le traitement de la qualification des e-mails bounce dans Adobe Campaign dépend du type d’erreur :
Erreurs synchrones : le MTA détermine le type et la qualification du rebond, puis renvoie ces informations à Campaign. Les qualifications de mails rebonds dans la table Qualification des logs de diffusion ne sont plus utilisées pour les messages d'erreur relatifs aux échecs des diffusions synchrones.
Erreurs asynchrones : les règles utilisées par Campaign pour qualifier les diffusions en échec asynchrones sont répertoriées dans le nœud Administration > Gestion de campagne > Gestion des échecs > Qualification des logs de diffusion. Les retours asynchrones restent qualifiés par le processus inMail grâce aux règles de mail entrant. Pour en savoir plus à ce sujet, consultez la documentation Adobe Campaign Classic v7.
Si la diffusion d'un message échoue suite à une erreur temporaire (Soft ou Ignoré), Campaign réalise une nouvelle tentative d'envoi. Ces reprises peuvent être effectuées jusqu'à la fin de la durée de diffusion.
Les reprises des soft bounces et l’intervalle qui les sépare sont déterminés par le MTA en fonction du type et de la gravité des réponses des bounces provenant du domaine de messagerie du message.
Les paramètres de reprise dans les propriétés de la diffusion ne sont pas utilisés par Campaign.
Le paramètre de la période de validité dans vos diffusions Campaign est limité à 3,5 jours ou moins. Si vous définissez une valeur supérieure à 3,5 jours pour une diffusion dans Campaign, elle ne sera pas prise en compte.
Par exemple, si la période de validité est définie sur la valeur par défaut de 5 jours dans Campaign, les messages soft bounce seront placés dans la file d’attente de reprises du MTA et ne feront l’objet d’une reprise que pendant 3,5 jours à compter du moment où ils ont atteint le MTA. Dans ce cas, la valeur définie dans Campaign ne sera pas utilisée.
Une fois qu’un message figure dans la file d’attente du MTA depuis 3,5 jours et qu’il n’a pas été diffusé, il expire et son statut est mis à jour de Envoi à Échec dans les logs de diffusion.
Pour plus d’informations sur la période de validité, consultez la documentation Adobe Campaign Classic v7.
Pour le canal e-mail, les raisons possibles d'un échec de diffusion sont répertoriées ci-dessous.
Libellé de l'erreur | Type d'erreur | Valeur technique | Description |
Compte désactivé | Soft/Hard | 4 | Le compte associé à l'adresse n'est plus actif. Lorsque le Fournisseur d'Accès Internet (FAI) détecte une inactivité prolongée, il peut fermer le compte de l'utilisateur, ce qui rend les diffusions vers son adresse impossibles. Si le compte est temporairement désactivé en raison d'une inactivité de 6 mois et qu'il peut toujours être activé, le statut En erreur sera affecté. Une tentative d'utilisation du compte est alors effectuée jusqu'à ce que le compteur d'erreurs atteigne 5. Si l'erreur signale que le compte est désactivé de manière permanente, il sera directement défini comme étant en quarantaine. |
Adresse en quarantaine | Hard | 9 | L'adresse a été mise en quarantaine. |
Adresse non renseignée | Hard | 7 | L'adresse du destinataire n'est pas renseignée. |
Adresse de mauvaise qualité | Ignoré | 14 | L'indice de qualité de l'adresse postale est trop faible. |
Adresse placée sur la liste bloquée | Hard | 8 | L'adresse a été ajoutée à la liste bloquée au moment de l'envoi. Cet état est utilisé pour importer des données à partir de listes externes et de systèmes externes dans la liste Quarantaine d'Adobe Campaign. |
Adresse témoin | Ignoré | 127 | L'adresse de l'expéditeur fait partie de la population témoin. |
Double | Ignoré | 10 | L'adresse du destinataire apparaissait déjà dans cette diffusion. |
Erreur ignorée | Ignoré | 25 | L'adresse est sur la liste autorisée. L'erreur est donc ignorée et un email sera envoyé. |
Exclu par un arbitrage | Ignoré | 12 | Le destinataire a été exclu par une règle de typologie de campagne de type 'arbitrage'. |
Exclu par une règle SQL | Ignoré | 11 | Le destinataire a été exclu par une règle de typologie de campagne de type 'SQL'. |
Domaine invalide | Soft | 2 | Le domaine de l'adresse email est erroné ou n'existe plus. Ce profil sera ciblé de nouveau jusqu'à ce que le nombre d'erreurs atteigne 5. Une fois ce chiffre atteint, l'enregistrement sera défini sur le statut Quarantaine et aucune autre reprise ne sera effectuée. |
Boîte pleine | Soft | 5 | La boîte de messagerie de l'utilisateur est pleine et ne peut plus accepter d'autres messages. Ce profil sera ciblé de nouveau jusqu'à ce que le nombre d'erreurs atteigne 5. Une fois ce chiffre atteint, l'enregistrement sera défini sur le statut Quarantaine et aucune autre reprise ne sera effectuée. Ce type d'erreur est géré par un processus de nettoyage, l'adresse est défini sur un statut valide au bout de 30 jours. Avertissement : pour que l'adresse soit automatiquement retirée de la liste des adresses en quarantaine, le workflow technique Nettoyage de la base de données doit être démarré. |
Non connecté | Ignoré | 6 | Le téléphone portable du destinataire est éteint ou n'est pas connecté au réseau au moment de l'envoi du message. |
Non définie | Non définie | 0 | L'adresse est en cours de qualification parce que l'erreur n'a pas encore été incrémentée. Ce type d'erreur apparaît lorsqu'un nouveau message d'erreur est envoyé par le serveur : il peut s'agir d'une erreur isolée, mais si elle se répète, le compteur d'erreur augmente, ce qui permet d'alerter les équipes techniques. Elles peuvent ensuite analyser les messages et qualifier cette erreur, via le nœud Administration/Gestion de campagne/Gestion des NP@I dans l'arborescence. |
Non éligible aux offres | Ignoré | 16 | Le destinataire n'était pas éligible aux offres de la diffusion. |
Refusés | Soft/Hard | 20 | L'adresse a été mise en quarantaine en raison d'un retour de sécurité signalant du spam. Selon l'erreur, l'adresse sera utilisée de nouveau jusqu'à ce que le compteur d'erreur atteigne 5 ou elle sera directement mise en quarantaine. |
Cible limitée en taille | Ignoré | 17 | La taille de diffusion maximale a été atteinte pour le destinataire. |
Adresse non qualifiée | Ignoré | 15 | L'adresse postale n'a pas été qualifiée. |
Inatteignable | Soft/Hard | 3 | Une erreur s'est produite dans la chaîne de distribution du message. Il peut s'agir d'un incident sur le relais SMTP, d'un domaine temporairement inatteignable, etc. Selon l'erreur, l'adresse sera utilisée de nouveau jusqu'à ce que le compteur d'erreur atteigne 5 ou elle sera directement mise en quarantaine. |
Utilisateur inconnu | Hard | 1 | L'adresse n'existe pas. Aucune autre diffusion ne sera envoyée pour ce profil. |
Pour le canal des applications mobiles, les raisons possibles d'un échec de diffusion sont répertoriées ci-dessous.
Le protocole HTTP/V2 permet des retours et un état directs pour chaque diffusion push. Si le connecteur de protocole HTTP/V2 est utilisé, le service des retours n'est plus appelé par le workflow mobileAppOptOutMgt. Un jeton est considéré comme non enregistré lorsqu'une application mobile est désinstallée ou réinstallée.
Si l'APNS renvoie de manière synchrone un statut "désinscrit" pour un message, le jeton cible est immédiatement mis en quarantaine.
Scénario |
Status |
Message de l'erreur |
Type de l'échec |
Raison de l'échec |
Réessayer |
Appareil ciblé sous tension |
Ok |
||||
Appareil ciblé hors tension |
Ok |
||||
L'utilisateur désactive les notifications de l'application |
Ok |
||||
Création du message/phase d'analyse - payload trop volumineuse |
Echec |
Payload trop longue |
Soft |
Refusés |
Non |
Création du message/phase d'analyse - problème lié à un format de contenu inattendu |
Echec |
Messages d'erreur différents selon l'erreur |
Soft |
Indéfinie |
Non |
Problème de certificat (mot de passe, endommagement, etc.) et problème de test de connexion à l'APNS |
Echec |
Messages d'erreur différents selon l'erreur |
Soft |
Refusés |
Non |
Perte de la connexion réseau pendant l'envoi |
Echec |
Erreur de connexion |
Indéfinie |
Inatteignable |
Oui |
Rejet du message par l'APNS : désinscription l'utilisateur a supprimé l'application ou le jeton a expiré |
Echec |
Désinscrit |
Hard |
Utilisateur inconnu |
Non |
Rejet du message par l'APNS : toutes les autres erreurs |
Echec |
La raison de l'erreur de rejet est indiquée dans le message d'erreur |
Soft |
Refusés |
Non |
Pour Android V1
Pour chaque notification, Adobe Campaign reçoit les erreurs synchrones directement du serveur FCM. Adobe Campaign les gère à la volée et génère des erreurs hard ou soft selon la gravité des erreurs. Des reprises peuvent être effectuées :
Le workflow mobileAppOptOutMgt s'exécute toutes les 6 heures pour mettre à jour la table AppSubscriptionRcp. Pour les jetons déclarés comme désinscrits ou qui ne sont plus valides, le champ Désactivé est défini sur True et l'inscription associée à ce jeton d'appareil est automatiquement exclue des prochaines diffusions.
Pendant l'analyse de la diffusion, tous les appareils qui sont exclus de la cible sont automatiquement ajoutés à la table excludeLogAppSubRcp.
Pour les utilisateurs qui ont recours au connecteur Baidu, voici les différents types d'erreur :
Adobe Campaign contacte le serveur Baidu toutes les 10 minutes pour récupérer le statut du message envoyé et met à jour les broadlogs. Si un message est déclaré comme envoyé, le statut du message dans les broadlogs est défini sur Reçu. Si Baidu déclare une erreur, le statut est défini sur Echoué.
Pour Android V2
Le mécanisme de mise en quarantaine d'Android V2 utilise le même processus qu'Android V1. Il en va de même pour la mise à jour des abonnements et des exclusions. Pour en savoir plus, consultez la section Android V1.
Scénario |
Status |
Message de l'erreur |
Type de l'échec |
Raison de l'échec |
Réessayer |
Création du message/phase d'analyse : mots-clés illégaux utilisés dans les champs personnalisés |
Echec |
Les mots-clés suivants ne peuvent être utilisés : {1} |
Soft |
Non |
|
Création du message/phase d'analyse : payload trop volumineuse |
Echec |
La notification est trop lourde : {1} bits contre {2} autorisés |
Soft |
Refusés |
Non |
Perte de la connexion réseau pendant l'envoi |
Echec |
Aucune réponse du service Firebase Cloud Messaging pour cette adresse : {1} |
Soft |
Inatteignable |
Oui |
Rejet du message par le FCM : le serveur FCM est temporairement hors service (par exemple avec des délais). |
Echec |
Le service Firebase Cloud Messaging est temporairement hors service |
Soft |
Inatteignable |
Oui |
Rejet du message par le FCM : erreur lors de l'authentification du compte de l'expéditeur |
Echec |
Echec de l'identification du compte développeur, vérifiez votre identifiant et mot de passe |
Soft |
Refusés |
Non |
Rejet du message par le FCM : dépassement du quota d'appareils |
Echec |
Soft |
Refusés |
Oui |
|
Rejet du message par le FCM : inscription invalide / non inscrit |
Echec |
Hard |
Utilisateur inconnu |
Non |
|
Rejet du message par le FCM : toutes les autres erreurs |
Echec |
Le serveur Firebase Cloud Messaging a retourné un code d'erreur non attendu : {1} | Refusés |
Non |
|
Rejet du message par le FCM : argument non valide |
Echec |
INVALID_ARGUMENT | Ignoré | Indéfinie |
Non |
Rejet du message par le FCM : erreur d'authentification tierce |
Echec |
THIRD_PARTY_AUTH_ERROR | Ignoré | Refusés |
Oui |
Rejet du message par le FCM : le Sender ID ne correspond pas |
Echec |
SENDER_ID_MISMATCH | Soft | Utilisateur inconnu |
Non |
Rejet du message par le FCM : non enregistré |
Echec |
UNREGISTERED | Hard | Utilisateur inconnu |
Non |
Rejet du message par le FCM : interne |
Echec |
INTERNAL | Ignoré | Refusés |
Oui |
Rejet du message par le FCM : non disponible |
Echec |
UNAVAILABLE | Ignoré | Refusés |
Oui |
Rejet du message par le FCM : code d'erreur inattendu |
Echec |
code d'erreur inattendu | Ignoré | Refusés |
Non |
Authentification : problème de connexion |
Echec |
Impossible de se connecter au serveur d'authentification | Ignoré | Refusés |
Oui |
Authentification : client non autorisé ou périmètre demandé. |
Echec |
unauthorized_client | Ignoré | Refusés |
Non |
Authentification : le client n'est pas autorisé à récupérer des jetons d'accès à l'aide de cette méthode, ou le client n'est pas autorisé pour l'un des paramètres demandés. |
Echec |
unauthorized_client | Ignoré | Refusés |
Non |
Authentification : accès refusé |
Echec |
access_denied | Ignoré | Refusés |
Non |
Authentification : adresse électronique non valide |
Echec |
invalid_grant | Ignoré | Refusés |
Non |
Authentification : JWT non valide |
Echec |
invalid_grant | Ignoré | Refusés |
Non |
Authentification : signature JWT non valide |
Echec |
invalid_grant | Ignoré | Refusés |
Non |
Authentification : périmètre OAuth non valide ou audience de jeton d'ID non valide fourni |
Echec |
unauthorized_client | Ignoré | Refusés |
Non |
Authentification : client OAuth désactivé |
Echec |
disabled_client | Ignoré | Refusés |
Non |
Pour les connecteurs standards
Les spécificités du canal SMS sont énumérées ci-dessous.
Le tableau Qualification des logs de diffusion ne s'applique pas au connecteur SMPP Générique étendu.
Scénario |
Status |
Message de l'erreur |
Type de l'échec |
Raison de l'échec |
Transmis au prestataire |
Envoyés |
|||
Reçu sur le mobile |
Reçu |
|||
Erreur retournée par le prestataire |
Echec |
Erreur lors de la récupération de données (SR ou MO). |
Soft |
Inatteignable |
Accusé de réception du MT non valide |
Echec |
Erreur '{1}' lors du traitement de la trame d'accusé réception d'une requête d'envoi. |
Soft |
Inatteignable |
Erreur lors de l'envoi du MT |
Echec |
Erreur lors de l'envoi des messages. |
Soft |
Inatteignable |
Pour le connecteur SMPP générique étendu
Lors de l'utilisation du protocole SMPP pour envoyer des SMS, la gestion des erreurs est traitée différemment.
Le connecteur SMPP récupère les données du message du SR (rapport d'état) qui est renvoyé à l'aide d'expressions régulières (regex) pour filtrer son contenu. Ces données sont alors mises en correspondance avec les informations figurant dans la table Qualification des logs de diffusion (disponible via le menu Administration > Gestion de campagnes > Gestion des NP@I).
Avant qu'un nouveau type d'erreur ne soit qualifié, la raison de l'échec est toujours défini sur Refusé par défaut.
Les raisons et les types des échecs sont les mêmes que pour les e-mails.
Demandez à votre prestataire la liste des codes d'erreur et des états pour définir les types et les raisons corrects des erreurs dans la table Qualification des logs de diffusion.
Exemple de message généré :
SR Generic DELIVRD 000|#MESSAGE#
Tous les messages d'erreur commencent par SR pour faire la distinction entre les codes d'erreur SMS et les codes d'erreur email.
La seconde partie (Generic, dans cet exemple) du message d'erreur fait référence au nom de l'implémentation du SMSC comme défini dans le champ Nom de l'implémentation du SMSC du compte externe SMS.
Comme un même code d'erreur peut avoir une signification différente pour chaque prestataire, ce champ vous permet de déterminer quel prestataire a généré le code d'erreur. Vous pouvez alors rechercher l'erreur dans la documentation du prestataire adéquat.
La troisième partie (DELIVRD, dans cet exemple) du message d'erreur correspond au code d'état récupéré du SR à l'aide de la regex d'extraction de code d'état définie dans le compte externe SMS.
Cette regex est spécifiée dans l'onglet Spécificités du SMSC du compte externe.
Par défaut, la regex extrait le champ stat: comme défini dans la section Appendix B de la spécification SMPP 3.4.
La quatrième partie (000, dans cet exemple) du message d'erreur correspond au code d'erreur extrait du SR à l'aide de la regex d'extraction de code d'erreur définie dans le compte externe SMS.
Cette regex est spécifiée dans l'onglet Spécificités du SMSC du compte externe.
Par défaut, la regex extrait le champ err: comme défini dans la section Appendix B de la spécification SMPP 3.4.
Tous les éléments qui se trouvent après la barre verticale (|) ne sont affichés que dans la colonne Premier texte de la table Qualification des logs de diffusion. Le contenu est toujours remplacé par #MESSAGE#, une fois le message normalisé. Ce processus permet d'éviter plusieurs entrées pour des erreurs similaires et est le même que pour les e-mails.
Le connecteur SMPP générique étendu applique une méthode heuristique pour rechercher des valeurs par défaut sensibles : si l'état commence par DELIV, il est considéré comme une réussite, car il correspond aux états DELIVRD ou DELIVERED courants, utilisés par la plupart des prestataires. Tout autre état correspond à un échec hard.