Adobe Campaign gère une liste d'adresses en quarantaine. Les destinataires dont l'adresse est en quarantaine sont par défaut exclus lors de l'analyse d'une diffusion : ils ne seront pas ciblés. Une adresse email peut être mise en quarantaine par exemple lorsque la boîte de messagerie est pleine ou si l'adresse n'existe pas. Dans tous les cas, la mise en quarantaine répond à des règles précises qui sont décrites ci-après.
Cette section s'applique aux canaux on-line : email, SMS et notification push.
Les profils dont lʼadresse e-mail ou le numéro de téléphone est en quarantaine sont exclus automatiquement lors de la préparation des messages (consultez la section Identification des adresses en quarantaine pour une diffusion). Le taux d'erreur ayant une incidence importante sur la vitesse de diffusion, les envois sont ainsi accélérés.
Certains fournisseurs d'accès Internet considèrent automatiquement les emails comme du spam si le taux d'adresses invalides est trop élevé. La quarantaine permet donc d’éviter d’être ajouté à une liste bloquée par ces fournisseurs.
De plus, elles réduisent les coûts d’envoi des SMS en excluant les numéros de téléphone erronés des diffusions.
Pour plus d’informations sur les bonnes pratiques en matière de sécurisation et d’optimisation de vos diffusions, consultez cette page.
La quarantaine et la liste bloquée ne s’appliquent pas au même objet :
La quarantaine s’applique uniquement à une adresse (ou un numéro de téléphone, etc.), et non au profil lui-même. Par exemple, un profil dont l’adresse e-mail est en quarantaine peut mettre à jour son profil et saisir une nouvelle adresse, puis être ciblé de nouveau par des actions de diffusion. De même, si deux profils ont le même numéro de téléphone, ils seront tous deux affectés si le numéro est mis en quarantaine.
Les adresses ou numéros de téléphone mis en quarantaine s’affichent dans les logs d'exclusion (pour une diffusion) ou dans la liste de quarantaine (pour l'ensemble de la plateforme).
En revanche, en cas d'insertion en liste bloquée, le profil ne sera plus ciblé par aucune diffusion, par exemple après une désinscription (opt-out), pour un canal donné. Par exemple, si un profil de la liste bloquée pour le canal e-mail comporte deux adresses e-mail, les deux adresses seront exclues de la diffusion.
Vous pouvez vérifier si un profil est sur liste bloquée pour un ou plusieurs canaux dans la section Ne plus contacter de l’onglet Général du profil. Consultez cette section.
La mise en quarantaine inclut un statut Sur liste bloquée, qui s’applique lorsque les destinataires signalent votre message comme étant un spam ou répondent à un message SMS avec un mot-clé tel que « STOP ». Dans ce cas, l’adresse ou le numéro de téléphone du profil impliqué est mis en quarantaine avec le statut Sur liste bloquée. Pour plus d'informations sur la gestion des messages SMS STOP, consultez cette section.
Les adresses en quarantaine peuvent être répertoriées pour une diffusion spécifique ou lʼensemble de la plateforme.
Les adresses en quarantaine pour une diffusion spécifique sont répertoriées pendant la phase de préparation de la diffusion, dans les logs de diffusion du tableau de bord des diffusions (consultez la section Logs et historique de la diffusion).
Les administrateurs peuvent répertorier les adresses en quarantaine pour l'ensemble de la plateforme depuis le nœud Administration > Gestion de campagne > Gestion des NP@I > NP@I et adresses.
Ce menu répertorie les éléments en quarantaine pour les canaux email, SMS et notification push.
Les informations disponibles pour chacune des adresses sont les suivantes :
L'augmentation du nombre de quarantaines est un phénomène normal, lié à "l'usure" de la base. Par exemple, si l'on considère que la durée de vie d'une adresse e-mail est de trois ans et que la table des destinataires augmente de 50 % tous les ans, l'augmentation des quarantaines peut être calculée comme suit :
Fin de l'année 1 : (1 * 0,33) / (1 + 0,5) = 22 %.
Fin de l'année 2 : ((1,22 * 0,33) + 0,33) / (1,5 + 0,75) = 32,5 %.
Les rapports suivants fournissent des informations relatives aux adresses en quarantaine :
Pour chaque diffusion, le rapport Synthèse de la diffusion permet de consulter le nombre d'adresses en quarantaine dans la cible de la diffusion. Il affiche :
le nombre d'adresses mises en quarantaine lors de l'analyse de la diffusion,
le nombre d'adresses passées en quarantaine suite à l'action de diffusion.
Le rapport Echecs et retours affiche des informations relatives aux adresses en quarantaine, aux types d'erreurs rencontrées, etc., et une répartition des échecs par domaines.
Vous pouvez consulter ces informations pour l'ensemble des diffusions de la plateforme (Page d'accueil > Rapports) ou pour une diffusion particulière. Vous pouvez également créer des rapports personnalisés et sélectionner les informations à afficher.
Pour chaque destinataire, vous pouvez consulter lʼétat de son adresse e-mail. Pour cela, sélectionnez le profil du destinataire et cliquez sur lʼonglet Diffusions. Vous pouvez voir pour lʼensemble des diffusions vers ce destinataire si lʼadresse a été en échec, mise en quarantaine lors de lʼanalyse, etc. Pour chaque dossier, vous ne pouvez afficher que les destinataires dont lʼadresse e-mail est en quarantaine. Pour cela, utilisez le filtre applicatif E-mail en quarantaine.
Adobe Campaign gère la mise en quarantaine en fonction du type d’échec de la diffusion et de la raison attribuée lors de la qualification des messages d’erreur (voir les sections Qualification des e-mails bounce et Types de diffusion en échec et raisons).
Si un utilisateur qualifie un email comme du spam (système de gestion des plaintes (feedback loop)), le message est automatiquement redirigé vers une boîte email technique gérée par Adobe. L’adresse e-mail de l’utilisateur est alors automatiquement mise en quarantaine avec le statut Sur liste bloquée. Ce statut ne concerne que l’adresse. Le profil n’est pas placé sur liste bloquée afin que l’utilisateur puisse continuer à recevoir des SMS et des notifications push.
La quarantaine dans Adobe Campaign respecte la casse. Veillez à importer les adresses e-mail en minuscules, de telle sorte qu'elles ne soient pas reciblées ultérieurement.
Dans la liste des adresses en quarantaine (voir Identifier les adresses en quarantaine pour l’ensemble de la plateforme), le champ Raison de l’erreur indique pourquoi l’adresse sélectionnée a été mise en quarantaine.
Contrairement aux erreurs de type Hard, les erreurs de type Soft ne provoquent pas de mise en quarantaine immédiate mais incrémentent un compteur d'erreurs.
Les reprises seront effectuées pendant la durée de diffusion. Quand le compteur d'erreurs atteint le seuil limite, l'adresse passe en quarantaine. Pour en savoir plus, voir la section Reprises après une diffusion temporairement en échec.
Le compteur d'erreurs est réinitialisé si la dernière erreur significative s'est produite plus de 10 jours avant. Le statut de l'adresse passe à Valide et est supprimé de la liste des quarantaines grâce au workflow Nettoyage de la base.
Pour les installations hébergées ou hybrides, si vous avez effectué une mise à niveau vers la méthode MTA amélioré, le nombre maximum de reprises à effectuer en cas de statut En erreur et le délai minimum entre deux tentatives reposent désormais sur les performances historiques et actuelles d’une IP sur un domaine donné.
Pour les installations on-premise et les installations hébergées/hybrides utilisant l’ancien MTA de Campaign, vous pouvez modifier le nombre d’erreurs et la période entre deux erreurs. Pour ce faire, modifiez les paramètres correspondants dans l’assistant de déploiement (Canal e-mail > Paramètres avancés) ou au niveau de la diffusion.
Les adresses qui correspondent à des conditions spécifiques sont automatiquement supprimées de la liste de quarantaine par le workflow Nettoyage de la base de données.
Les adresses sont automatiquement supprimées de la liste de quarantaine dans les cas suivants :
Leur état devient ensuite Valide.
Les destinataires avec une adresse dont le statut est En quarantaine ou Sur liste bloquée ne font jamais l’objet d’une suppression, même s’ils/elles reçoivent un e-mail.
Vous pouvez également retirer une adresse en quarantaine manuellement. Pour supprimer manuellement une adresse de la liste de quarantaine, modifiez son statut en Valide depuis le nœud Administration > Gestion de campagne > Gestion des échecs > Échecs de diffusion et adresses.
Vous devrez peut-être effectuer des mises à jour en bloc sur la liste de quarantaine, par exemple en cas de panne du FAI. Dans ce cas, les e-mails sont incorrectement marqués comme rebonds, car ils ne peuvent pas être correctement remis à leur destinataire. Ces adresses doivent être supprimées de la liste de quarantaine.
Pour ce faire, créez un workflow et ajoutez une activité Requête sur votre table de quarantaine pour filtrer tous les destinataires concernés. Une fois identifiés, ils peuvent être supprimés de la liste de quarantaine et inclus dans les prochaines diffusions e-mail de Campaign.
Vous trouverez ci-dessous les instructions recommandées pour cette requête :
Pour les environnements Campaign Classic v7 contenant des informations de règles d’email entrant dans le champ Texte d’erreur de la liste de quarantaine :
Pour les instances Campaign Classic v7 contenant des informations de réponse de rebond SMTP dans le champ Texte d’erreur de la liste de quarantaine :
où « support.ISP.com » peut être « support.apple.com » ou « support.google.com », par exemple.
Une fois que vous disposez de la liste des destinataires concernés, ajoutez une activité Mise à jour de données pour définir le statut de leur adresse e-mail sur Valide afin qu’ils soient supprimés de la liste de quarantaine par le workflow Nettoyage de la base de données. Vous pouvez également les supprimer uniquement de la table de quarantaine.
Le mécanisme de quarantaine des notifications push est globalement identique au processus général. Toutefois, certaines erreurs sont gérées différemment pour les notifications Push. Par exemple, pour certaines erreurs logicielles, aucune nouvelle tentative n'est effectuée pour une même diffusion. Les spécificités des notifications Push sont énumérées ci-dessous. Le mécanisme d'une nouvelle tentative (nombre de tentatives, fréquence) est le même que pour les emails.
Les éléments mis en quarantaine sont les jetons d'appareil.
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
Le mécanisme de quarantaine des messages SMS est globalement identique au processus général. Voir À propos des quarantaines. Les spécificités des 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. Pour plus d'informations sur le connecteur SMPP générique étendu, consultez cette page.
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 emails. Pour plus d'informations, consultez la section Types de diffusion en échec et raisons.
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. Voir cette page.
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. Voir cette page.
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. Voir cette page.
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 emails. Pour plus d'informations, consultez la section Qualification des emails bounce.
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.