Passer au contenu principal
La validation d’adresse e-mail détecte les problèmes courants dans les adresses e-mail avant qu’elles n’atteignent votre audience. Elle signale les fautes de frappe, les domaines invalides, les adresses basées sur un rôle et les services d’e-mail jetables qui pourraient augmenter votre taux de rebond ou nuire à votre réputation d’expéditeur. Elle s’exécute automatiquement lors de l’importation CSV et est également disponible comme outil de validation en masse pour votre audience existante.
La validation d’adresse e-mail vérifie les adresses selon les critères de validation de OneSignal. Ce n’est pas une vérification de rebond en temps réel et ne garantit pas la délivrabilité.

​
Vérifications de validation

La validation d’adresse e-mail évalue chaque adresse selon les vérifications suivantes :
VérificationCe qu’elle détecte
Validation de syntaxeAdresses malformées avec des composants obligatoires manquants (ex. : @ absent, TLD invalide)
Détection de fautes de frappeErreurs d’orthographe courantes de domaine comme gnail.com ou gmail.con
Vérification d’enregistrement MXDomaines sans enregistrement d’échange de courrier valide ; les e-mails envoyés ici ne peuvent pas être livrés
Adresse basée sur un rôleAdresses comme sales@, info@, admin@ qui n’appartiennent probablement pas à un individu
E-mail jetableDomaines associés à des services d’e-mail temporaires ou jetables
Les forfaits gratuits incluent la validation de syntaxe et la détection de fautes de frappe. Les forfaits payants incluent tout ce qui précède ainsi que la vérification des enregistrements MX, la détection des adresses basées sur un rôle et le filtrage des e-mails jetables.
Si une adresse échoue à une vérification, la validation d’adresse e-mail renvoie une erreur lisible expliquant le problème spécifique. Si une adresse échoue à plusieurs vérifications, tous les motifs d’échec sont renvoyés ensemble.

​
Valider les adresses lors de l’importation CSV

Lors de l’importation d’un CSV, vous pouvez configurer les paramètres de validation d’adresse e-mail à l’étape de Révision avant de confirmer l’importation.
1

Démarrer une importation CSV

Allez dans Audience > Import et téléchargez votre fichier. Complétez les étapes Upload et Map Fields. Si des adresses e-mail invalides sont détectées, un avertissement apparaîtra à l’étape Map Fields.
Étape Map Fields d'importation CSV affichant un avertissement d'e-mails invalides détectés
2

Configurer les paramètres de validation à l'étape de Révision

À l’étape de Révision, développez Paramètres de validation d’adresse e-mail. Les options suivantes sont disponibles :
Étape de Révision d'importation CSV avec les Paramètres de validation d'adresse e-mail développés
  • Valider les domaines d’e-mail (enregistrements MX) : confirmer que le domaine peut recevoir des e-mails
  • Exclure les adresses e-mail jetables : empêcher les adresses temporaires ou à usage unique susceptibles de réduire l’engagement
  • Exclure les adresses e-mail basées sur un rôle : empêcher les adresses partagées comme info@ ou support@ qui ont généralement un engagement plus faible
Les trois sont activés par défaut. Décochez ceux que vous ne souhaitez pas appliquer à cette importation.
Si vous devez importer des adresses e-mail invalides (par exemple, pour mettre à jour le statut de suppression ou d’abonnement), cochez Autoriser les adresses e-mail invalides. Cela contourne la validation et accepte toute chaîne comme adresse e-mail.
3

Confirmer et importer

Cliquez sur Confirmer et importer. Une fois l’importation terminée, vous recevrez un e-mail récapitulant les résultats :
  • Abonnements ajoutés
  • Abonnements modifiés
  • Lignes non importées, avec un lien pour télécharger les lignes rejetées

​
Résultat

Les adresses valides sont ajoutées à votre audience. Vous recevez un e-mail lorsque l’importation est terminée. Les adresses qui ont échoué à la validation sont exclues et disponibles au téléchargement via le lien dans l’e-mail de résultats.

​
Valider votre audience existante en masse

Utilisez la validation en masse pour vérifier les adresses e-mail déjà présentes dans votre audience OneSignal. Vous recevez les résultats par e-mail sous forme d’export CSV.
1

Ouvrir l'outil Valider les adresses e-mail

Allez dans Audience > Subscriptions (ou Audience > Users), cliquez sur Update/Import Users, puis sélectionnez Validate Email Addresses.
Menu déroulant Update/Import Users avec l'option Validate Email Addresses mise en évidence
2

Démarrer la validation

Dans le modal, cliquez sur Start validation. La validation d’adresse e-mail s’exécute sur toutes les adresses e-mail de votre application.
Modal Validate Email Addresses affichant le bouton Start validation
3

Recevoir vos résultats par e-mail

Lorsque la validation est terminée, vous recevrez un e-mail de OneSignal avec un lien Télécharger l’export CSV. Le lien est actif pendant 72 heures. L’e-mail résume le nombre d’adresses ayant échoué, ventilé par :
E-mail de résultats OneSignal affichant le résumé de validation et le bouton Télécharger l'export CSV
  • Fautes de frappe
  • Adresses basées sur un rôle
  • Domaines jetables
  • Enregistrements MX invalides
4

Examiner et réimporter

Téléchargez le CSV et examinez les adresses signalées.
Export CSV affichant les colonnes email, reason, suggested_email, created_at, last_opened et last_clicked
Pour nettoyer votre audience, créez un nouveau CSV avec les adresses corrigées ou traitées et réimportez-le en utilisant l’un des formats de colonnes suivants :
ObjectifColonnes requisesValeur
Réabonner les adresses corrigéesemail, subscribedsubscribed = yes
Désabonner les adresses signaléesemail, subscribedsubscribed = no
Supprimer les adresses signaléesemail, suppressedsuppressed = true

​
Résultat

Vous recevez un e-mail avec un export CSV des adresses signalées et un résumé des résultats de validation ventilés par type d’erreur.

​
Référence des erreurs de validation

Les erreurs suivantes peuvent apparaître dans les résultats de validation :
ErreurSignificationQue faire
Entrée invalideL’adresse est malformée et ne répond pas aux exigences syntaxiques de base (ex. : @ absent, TLD invalide).Corrigez ou supprimez l’adresse.
Faute de frappe dans l’adresse e-mailUne probable faute d’orthographe a été détectée dans le domaine. Une correction suggérée apparaît dans la colonne adjacente.Appliquez la correction suggérée ou supprimez l’adresse.
Enregistrement MX introuvableLe domaine n’a pas d’enregistrement d’échange de courrier valide. L’e-mail ne peut pas être livré à cette adresse.Supprimez ou retirez l’adresse.
Adresse e-mail basée sur un rôleLa partie locale (avant @) correspond à un modèle basé sur un rôle connu comme sales@ ou support@. Ces adresses n’appartiennent probablement pas à un individu.Vérifiez si l’adresse est appropriée pour votre cas d’utilisation, puis supprimez-la ou retirez-la.
Adresse e-mail jetableLe domaine est associé à un service d’e-mail temporaire ou jetable.Supprimez ou retirez l’adresse.

​
Réponses d’erreur de l’API

La validation d’adresse e-mail s’applique également aux adresses soumises via l’API. Les sections ci-dessous décrivent les réponses d’erreur que vous pouvez rencontrer.
La validation de l’API vérifie uniquement que l’adresse e-mail est correctement formatée. Elle ne vérifie pas les fautes de frappe, les enregistrements MX, les adresses basées sur un rôle ou les domaines jetables. Ces vérifications ne sont disponibles que lors de l’importation CSV et de la validation en masse.

​
Envoyer un e-mail : Créer un message

Lorsque vous envoyez à une ou plusieurs adresses invalides via le point de terminaison Créer un message, les adresses invalides sont exclues de la livraison et renvoyées sous invalid_email_tokens. 
{
  "id": "",
  "errors": {
    "invalid_email_tokens": ["invalid@email"]
  }
}

​
Ajouter un utilisateur ou un abonnement : API Modèle Utilisateur

Lorsque vous créez un utilisateur ou un abonnement avec un e-mail invalide via le point de terminaison Créer un utilisateur ou Créer un abonnement : 
{
  "errors": [
    {
      "title": "Invalid `token` format for device type email"
    }
  ]
}

​
Ajouter un appareil : API Players héritée

Lorsque vous ajoutez ou modifiez un enregistrement de player avec un e-mail invalide via l’API Players héritée : 
{
  "success": false,
  "errors": ["[\"Identifier invalid format.\"]"]
}
L’API Players héritée est obsolète. Migrez vers l’API Modèle Utilisateur pour recevoir des erreurs de validation plus descriptives et accéder aux fonctionnalités actuelles.