La page d'Importation de Données offre une fonctionnalité permettant de réaliser des importations manuelles ad hoc, et de planifier des auto-importations régulières de vos données de contact dans la Plateforme Marketing Emarsys.
Dans cet article
- Qu'est-ce que l'Importation de Données ?
- Comment ça marche ?
- Gestion d'opt-in
- Pourquoi utiliser l'Importation de Données ?
- Fonctionnalité supportée
- FAQ pour l'importation de données
Guides utilisateur
- Importation de Données - Guide pour l'utilisateur final
- Importation de Données - Résolution des problèmes
Lecture complémentaire
Qu'est-ce que l'Importation de Données ?
L'Importation de Données offre un assistant facile d'utilisation pour l'importation de fichiers de données externes. Il vous permet aussi de vous assurer que tous les champs sont correctement associés.
Il y a deux types d'importations, les importations manuelles et les auto-importations. Les importations manuelles permettent des téléversements ponctuels, tandis que les auto-importations peuvent être configurées pour des événements de synchronisation réguliers.
C'est cette méthode que vous utiliserez sans doute pour le téléversement initial de vos contacts pendant la phase d'intégration (ce téléversement peut être soit manuel soit en auto-importation, en fonction de la taille de votre base de données).
Vous pouvez aussi utiliser l'importation manuelle pour téléverser toutes vos inscriptions hors ligne collectées via les flyers, les foires commerciales etc.
L'Importation de Données est conçue pour les utilisateurs ayant peu de compétences techniques. Si vous possédez en interne les ressources techniques vous permettant d'utiliser l' API Emarsys, nous vous conseillons cette éthode pour une performance et une synchronisation en temps réel supérieures.
Comment ça marche ?
Importations manuelles
Dans une importation manuelle, vous téléversez un fichier CSV à partir d'une source locale, associez les champs et les valeurs à vos champs Emarsys et l'importez. L'importation est traitée en arrière-plan et vous recevrez une notification quand elle est achevée.
L'importation nécessite un champ d'identifiant unique qui est utilisé pour vérifier si un contact existe ou pas. Les nouveaux contacts sont créés dans votre base de données Emarsys, tandis que les contacts existants sont téléversés. Pour tous les champs, les nouvelles valeurs écraseront les anciennes, à l'exception du champ opt-in par email.
Pour plus d'informations, voir Associer les champs et les valeurs du fichier téléversé.
Auto-importations
Avec les auto-importations, vous définissez un endroit où Emarsys vérifiera régulièrement la présence de fichiers qui suivent une certaine convention de désignation, puis les importera.
Tous les contacts importés via l'auto-importation sont sauvegardés sur l'application Emarsys en tant que liste de contact.
Pour configurer une auto-importation, vous aurez besoin d'un fichier type. Il sera utilisé pour associer les champs et les valeurs et vérifier que le texte et les délimiteurs de champ sont corrects. Il est ensuite supprimé (aucun contact du fichier type n'est importé).
Un fichier type ne nécessite qu'un seul ou bien deux contacts effectifs mais ces derniers doivent comporter :
- Tous les champs qui seront inclus dans les fichiers d'importation effectifs, dans le même ordre que les fichiers importés.
- Toutesles valeurs possibles pour tous les champs à choix multiples ou unique contenus dans les fichiers d'importation.
Pré-traitement
Les importations automatisées acceptent aussi le "pré-traitement", qui est la phase où les fichiers cryptés peuvent être automatiquement décompressés et importés. Le pré-traitement peut être configuré par Emarsys comme partie de la configuration de l'importation automatisée, et compte sur la permanence du mot de passe de chaque fichier. Les formats PGP (Pretty Good Privacy) et GPG (GNU Privacy Guard) sont tous deux admis.
Emarsys accepte une variété de formats de compression standard, semblables à ceux admis par 7-zip.org. Pour en savoir plus, veuillez contacter le Support Emarsys.
Gestion d'opt-in
Le champ opt-in par email est géré par importations de la manière suivante :
Pour les nouveaux contacts
On vous demande de définir le statut d'opt-in dans les paramètres d'importation.
Pour les contacts existants
La gestion des doublons appréhende le champ d'opt-in de la manière suivante :
- Si le champ d'opt-in dans le fichier importé et dans votre compte ont la même valeur, le contact fusionné conservera cette valeur, et l'historique du champ sera mis à jour avec l'horodatage le plus récent des deux versions.
- Si le fichier d'importation a la valeur
FALSE
alors que votre compte aTRUE
, le contact fusionné aura la valeurFALSE
. - Si le fichier d'importation a la valeur
NULL
alors que votre compte aFALSE
, le contact fusionné aura la valeurFALSE
. - Si le fichier d'importation a la valeur
NULL
alors que votre compte aTRUE
, le contact fusionné aura la valeurTRUE
.
Le champ d'opt-in ne doit jamais avoir une chaîne vide comme valeur, car cela sera traité comme une valeur invalide. Utilisez plutôt NULL
.
Pourquoi utiliser l'Importation de Données ?
Le principal cas d'utilisation concernant l'Importation de Données est quand vous utilisez Emarsys comme votre base de données de contact principale et que dans certains scénarios l'utilisation de l'API Emarsys n'est pas appropriée. Par exemple pour le téléversement de listes de contacts collectées hors ligne.
C'est aussi une option de secours si vous n'avez pas les ressources techniques nécessaires pour gérer votre transfert de données de contact via l'API.
Enfin, vous pouvez utiliser les auto-importations pour déclencher des programmes automatisés.
Fonctionnalité supportée
Vous pouvez faire ce qui suit sur la page d'Importation de Données :
- Consultez vos importations en cours
- Consultez votre historique d'importation
- Initier une importation manuelle
- Configurer une auto-importation
- Modifier une importation
- Annuler une importation
- Associer le champ et les valeurs du téléversement
- Changer l'association de champ d'une auto-importation existante
Commencer à utiliser l'Importation de Données
Avant de commencer à utiliser l'Importation de Données
Dans le cas des importations manuelles, vous devez prendre en compte deux choses :
- Seuls les fichiers CSV peuvent être téléversés.
- La taille du fichier téléversé ne peut excéder 64 MO.
Si vous avez des besoins différents, vous devriez envisager de configurer une auto-importation.
Dans le cas des auto-importations, vous aurez besoin d'un endroit où conserver le fichier à téléverser.
Il y a deux options :
- un dossier WebDAV (créé par votre Propriétaire de Compte, voir ici pour plus de détails).
- votre propre serveur SFTP ou FTPS.
Emarsys vérifie l'arrivée de nouveaux fichiers dans le WebDAV à chaque minute, et sur les serveurs SFTP ou FTPS toutes les heures.
FAQ pour l'importation de données
Non, vous ne pouvez que créer de nouvelles listes, mais il y a deux solutions de contournement :
- Incluez un champ unique dans le fichier d'importation (nommé par exemple d'après le nom de l'auto-importation) et créez un segment qui filtre les contacts avec la valeur appropriée à ce champ.
- Utilisez le noeud d'entrée Sur auto-importation du Centre d'Automatisation puis embrayez avec un noeud Enregistrer la liste de contact , avec le paramètre Ajouter de nouveaux contacts à une liste existante activé.
Vous ne pouvez pas importer plus d'un fichier manuellement via l'assistant d'importation - pour ce faire vous devrez installer une auto-importation. Les auto-importations récupéreront tous les fichiers qui sont correctement téléchargés sur le dossier de stockage.
Les serveurs SFTP ou FTPS sont les protocoles de transfert les plus sécurisés disponibles actuellement et nous vous conseillons cette option si vous disposez des ressources techniques nécessaires. Emarsys vérifie les sources extérieures une fois par heure et les fichiers importés avec succès sont supprimés de la source.
Un WebDAV est une source sécurisée par SSL, hébergée et entretenue par Emarsys. Beaucoup de clients trouvent cela pratique parce que le Support Emarsys l'installe pour vous (gratuitement) et tout ce qu'il vous reste à faire est d'utiliser une application client adaptée telle que Bitkinex ou Cyberduck pour accéder au dossier, ou programmer des mises à jour automatiques directement à partir de votre CRM.
Emarsys vérifie le WebDAV de chaque compte à chaque minute et traite tout nouveau fichier qu'il y trouve. Les fichiers traits sont sauvegardés à nouveau sur le WebDAV avec la convention de dénomination suivante :
- filename.csv.done - pour les importations réussies.
- filename.csv.error pour les échecs d'importation. Une notification détaillant l'erreur sera envoyée au Centre de Notification.
- filename.csv.ignore pour les fichiers dont les noms n'obéissent pas à la convention de dénomination définie pour aucune des auto-importations activées.
Note : si vous utilisez un fichier de compression, le fichier d'importation sera extrait vers le WebDAV et renommé comme ci-dessus, puis le fichier de compression sera supprimé.
Nous vous conseillons d'intégrer à la fois des parties statiques et des parties dynamiques dans les noms de fichier. La partie fixe doit être claire et facilement compréhensible, et liée dans l'idéal à un certain aspect de votre stratégie de cycle de vie client, tandis que la partie dynamique (par exemple l'horodatage) différenciera les fichiers individuels. La partie dynamique est représentée par un astérisque de joker * dans le champ de convention de dénomination.
Exemples
- Si vous n'avez besoin que d'une seule configuration d'auto-importation, vous pouvez utiliser une convention de dénomination simple telle que .csv. Cela signifie que chaque fichier .csv file placé sur le dossier source sera traité.
- Si vous utilisez plus d'une auto-importation, nous vous conseillons alors d'associer la partie fixe au nom de l'auto-importation, et de garder la partie dynamique pour un horodatage. De cette manière vous pourrez définir la convention de dénomination pour l'auto-importation des prospects convertis comme : converted-leads-*.csv, puis nommer chaque fichier individuels de cette façon : converted-leads-2015-02-12.csv
Veuillez noter que les noms de fichier sont sensibles à la casse.
Pourquoi ai-je besoin d'un fichier type pour les auto-importations ?Un fichier type est nécessaire pour qu'Emarsys sache à quels champs s'attendre dans les fichiers d'importation, et comment les associer à leurs valeurs dans les champs existants dans la base de données Emarsys. Si vous apportez un changement quelconque, même mineur, aux fichiers d'importations, vous devez téléverser un nouveau fichier type basé sur le nouveau fichier d'importation.
Un fichier type doit contenir tous les champs attendus, dans le bon ordre et avec toutes les valeurs possibles pour n'importe quels champs à choix multiples et unique.
Non. Emarsys ne s'intéresse qu'aux paramètres de fichier, aux champs et aux valeurs.
La plupart des comptes Emarsys ne sont compatibles qu'avec le cryptage UTF-8. Les seules exceptions sont les comptes sur les environnements www.emarsys.net et www1.emarsys.net, qui n'acceptent que Latin1.
Veuillez noter qu'Emarsys ne vérifie pas le cryptage utilisé. Si vous utilisez tout autre cryptage, les données de contact que vous importez pourraient être corrompues et inutilisables.
Le fichier d'importation lui-même doit être un fichier CSV. Vous pouvez toutefois compresser ce fichier. Les formats de compression suivants sont compatibles : .zip, .arg, .gzip, .tar, .tgz, .bzip2, .7z.
Si vous voulez utiliser un format de fichier compressé, assurez-vous d'intégrer la convention de dénomination pour le fichier compressé et tout mot de passe requis pour l'ouvrir.
Cela peuple le champ Langue d'inscription. C'est purement au cas où vous voulez segmenter vos contact par langue, par exemple lors de l'envoi de newsletters en divers langues.
Modifier le paramètre de langue du fichier d'importation peut affecter deux choses :
- Les noms et les valeurs de champ
Si une langue de fichier est définie, Emarsys utilisera cette langue pour associer les champs et leurs valeurs dans le fichier d'importation. Veuillez noter que cela nécessite que vous fournissiez les traductions pertinentes pour tout champ personnalisé inclus, dans la/les langue(s) respective(s). - Le format de date
Certains formats de date sont associés à différentes langues. Emarsys vérifiera le fichier type pour le format de date, et s'il ne correspond pas à la langue, une erreur apparaîtra dans l'assistant d'auto-importation. Les formats de date admis sont :- AA-MM-JJ
- JJ.MM.AA
- MM/JJ/AA
- JJ/MM/AA