Présentation des diffusions en échec

Dernière mise à jour : 2023-07-07
  • Créé pour :
  • Beginner
    Intermediate
    User

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.

Pourquoi la diffusion du message a-t-elle échoué ?

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.

Erreurs synchrones et asynchrones

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.

REMARQUE

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.

Qualification des e-mails rebonds

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.

Gestion des reprises

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.

REMARQUE

Les paramètres de reprise dans les propriétés de la diffusion ne sont pas utilisés par Campaign.

Période de validité

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.

Types d'erreur e-mail

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.

Types d'erreur des notifications push

Pour le canal des applications mobiles, les raisons possibles d'un échec de diffusion sont répertoriées ci-dessous.

Quarantaine iOS

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

Quarantaine Android

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 :

  • Dépassement de la longueur de la payload, problème de connexion, problème lié à la disponibilité du service : reprise effectuée, erreur soft, raison de l'échec : Refusés.
  • Dépassement du quota d'appareils : aucune reprise, erreur soft, raison de l'échec : Refusés.
  • Jeton non valide ou désinscrit, erreur inattendue, problème lié au compte de l'expéditeur : aucune reprise, erreur hard, raison de l'erreur : Refusés.

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.

REMARQUE

Pour les utilisateurs qui ont recours au connecteur Baidu, voici les différents types d'erreur :

  • Problème de connexion au début de la diffusion : type d'échec Indéfini, raison d'échec Inatteignable, reprise effectuée.
  • Perte de connexion pendant une diffusion : erreur soft, raison d'échec Refusés, reprise effectuée.
  • Erreur synchrone renvoyée par Baidu pendant l'envoi : erreur hard, raison d'échec Refusés, aucune reprise.

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

Quarantaines des SMS

Pour les connecteurs standards

Les spécificités du canal SMS sont énumérées ci-dessous.

REMARQUE

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.

REMARQUE

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.

Sur cette page