Vous êtes ici :
Importation d'activité dans Email Studio
Chaque activité d'importation utilise les informations d'un fichier externe pour mettre à jour une liste d'abonnés ou une extension de données.
Si votre compte est intégré avec un compte Salesforce, utilisez une activité d’importation pour créer et remplir une extension de données avec les données d’un objet ou d'un rapport Salesforce.
Considérations
- Lorsque vous importez dans une liste en utilisant l’activité d’importation, le système utilise List Detective pour empêcher l’importation de mauvaises adresses e-mail.
- Si le fichier que vous importez est crypté ou compressé, créez une activité de transfert de fichier afin de préparer le fichier pour l'importation.
- Lorsque vous définissez une activité d'importation, fournissez les informations que l’activité utilise lors de chaque exécution. Les informations présentent les détails du fichier à importer et guident le comportement de l'activité d'importation pendant l'exécution de l'importation.
- Selon la configuration du compte, déterminez si plusieurs enregistrements avec la même clé primaire peuvent être affichés dans un fichier d'importation. Alternativement, conservez uniquement la dernière instance de l'enregistrement à sauvegarder.
- Spécifiez le codage de caractères à utiliser avec les importations. Votre administrateur Marketing Cloud Engagement peut activer cette spécification.
- Si vous importez dans une extension de données sans clé primaire, seule l'option de type de mise à jour par remplacement est prise en charge.
- L’emplacement source du fichier par défaut est le dossier d'importation de votre compte FTP.
- Si votre compte utilise Automation Studio, vous pouvez importer des données dans une liste de publication. Les attributs d’abonné ne sont pas pris en charge pour les importations de listes de publication.
- Lors de l'enregistrement d'une définition d'importation qui importe un objet ou un rapport Salesforce, l'extension de données est créée automatiquement en fonction du schéma de l'objet ou du rapport. Une fois l'extension de données créée, vous ne pouvez pas changer la source des données.
- Par défaut, l'activité d'importation ignore les lignes contenant des données incorrectes et importe le reste du fichier.
- L'importation de données en utilisant les options de mise à jour Remplacer ou Ajouter seulement est généralement la plus rapide.
- L'utilisation de l'option Ajouter et Mettre à jour lorsqu’il y a des contraintes de clé primaire ralentit parfois le traitement.
Formats de date pris en charge
Pour la liste des formats de date pris en charge lors du chargement d'un format de date dans un champ de type date, consultez Formats de date pris en charge pour l'importation dans Marketing Cloud Engagement. Lorsque vous importez des dates dans des listes ou une extension de données, assurez-vous que le format de date dans le fichier correspond au format de date utilisé par votre ImportDefinition.
Création d'une activité d'importation
Importez un fichier en utilisant une activité d’importation dans Email Studio. Si le fichier que vous souhaitez importer est crypté ou compressé, créez une activité de transfert de fichiers correspondante. Vous pouvez importer vers une liste d'abonnés ou une extension de données existante.
- Cliquez sur Interactions.
- Cliquez sur Importer.
- Cliquez sur Créer.
-
Saisissez les informations dans la section Propriétés.
Le nom et la description identifient l’activité dans l’application. Les abonnés ne peuvent pas afficher le nom ou la description. La clé identifie l'activité de façon unique lorsque vous utilisez l'API.
-
Dans la section Source, sélectionnez l’emplacement du fichier et définissez le modèle de dénomination de fichier. Si vous sélectionnez Objets et rapports Salesforce, complétez les étapes ci-dessous.
- Pour Type de source des données Salesforce, sélectionnez Objet ou Rapport, puis choisissez l'objet ou le rapport à utiliser.
- Choisissez si vous souhaitez importer toutes les données ou uniquement les données modifiées après la date saisie.
- Sélectionnez le type de fichier à importer.
- Choisissez si vous souhaitez importer les informations dans une liste d'abonnés ou une extension de données. Vous pouvez ignorer les lignes contenant des données erronées ou interpréter les guillemets doubles comme délimiteur de texte.
Par défaut, l'activité d'importation ignore les lignes contenant des données incorrectes et importe le reste du fichier.
-
Sélectionnez votre type de mise à jour.
L'option Ajouter et mettre à jour crée un enregistrement pour chaque nouvelle valeur de clé primaire, et met à jour les valeurs de clé primaire existantes avec les nouvelles informations. L'option Ajouter uniquement crée uniquement des enregistrements et ignore les enregistrements existants. L'option Mettre à jour uniquement met à jour les enregistrements existants en fonction de la clé primaire et ignore les nouveaux enregistrements.
- Choisissez un format de données qui correspond à la région dans laquelle vous effectuez l’importation.
- Indiquez si l'importation doit être ignorée si la dernière importation a été effectuée pendant une période spécifiée.
-
Indiquez si une importation échoue si le fichier est plus ancien qu’une période spécifiée.
Le système examine la date de modification du fichier indiquée par le serveur FTP dans l'emplacement de transfert de fichiers. Si la différence d'heures entre la date de modification et l'heure système actuelle est supérieure aux heures spécifiées, l'importation n’a pas lieu. Vous pouvez spécifier un tampon système pour déterminer cette valeur plus facilement. La valeur d'heures spécifiée est ajoutée à la limite d'heures spécifiée précédemment.
-
Identifiez la destination de chaque colonne du fichier d'importation. Vous pouvez spécifier des en-têtes de colonnes ou un nombre ordinal, ou mapper chaque valeur manuellement en utilisant un exemple de fichier.
Lorsque vous importez des dates dans des listes ou une extension de données, le format de date dans le fichier doit être le même que celui indiqué sur la définition de l'importation. Si les formats sont différents, la validation échoue.
-
Saisissez les informations dans la section Paramètres d'achèvement de l'importation.
Le champ Emplacement de livraison détermine l'emplacement dans lequel le fichier est livré avec des informations et des exceptions de réalisation, le cas échéant. En-tête de colonne indique si le système interprète la première ligne du fichier d’importation comme ligne d’en-tête ou ligne de données. Pour recevoir la notification lorsque l’importation est terminée, saisissez une adresse e-mail dans le champ Envoyer un e-mail de notification à.
- Enregistrez l'activité.
Affichage de l’historique des fichiers importés
Consultez l'historique des fichiers importés ou dont l’importation a été tentée par l'activité d'importation dans Email Studio.
- Cliquez sur Interactions.
- Cliquez sur Importer.
- Sélectionnez une importation.
-
Cliquez sur Historique de fichier.
Ces informations sont affichées pour chaque instance :
- Date de début
- Nom du fichier
- Statut
- Description
Modèles de nommage de fichier
Consultez les exemples ci-dessous pour comprendre comment les modèles de nommage de fichier sont créés dans Email Studio.
| Modèle de nommage de fichier | Le système recherche | Exemple |
|---|---|---|
| subscribers.csv | un fichier nommé subscribers.csv | subscribers.csv |
| subscribers%%Month%%.csv | un nom de fichier dans lequel les deux derniers caractères correspondent à un mois à deux chiffres | subscriber12.csv |
| subscribers%%Year%%%%Month%%%%Day%%.csv | un nom de fichiers dont le format est une année à quatre chiffres, un mois à deux chiffres et un jour à deux chiffres | subscriber20101206.csv |
Chaînes de personnalisation
Les chaînes de personnalisation sont sensibles à la casse.
Pour éviter les erreurs d'activité, utilisez les chaînes de personnalisation minute et seconde uniquement si elles doivent différencier les fichiers générés par différentes exécutions d'automatisation. Pour plus d'informations, consultez Échec des activités d'importation et de transfert de fichiers avec « Fichier introuvable ».
Les chaînes de personnalisation disponibles pour les fichiers de nommage sont les suivantes :
%%Year%%
%%Month%%
%%Day%%
%%Hour%%
%%Minute%%
%%Second%%
