Sur cette page : découvrez comment utiliser l’activité de gestion des données Chargement de fichier pour cibler une audience de campagne orchestrée à partir d’un fichier CSV ou TXT externe au moment de l’exécution, sans ingérer le fichier dans Adobe Experience Platform.
L’activité Chargement de fichier est une activité Gestion des données. Utilisez-la pour travailler avec des profils et des données stockés dans un fichier externe. Il prend en charge le ciblage basé sur des fichiers dans les campagnes orchestrées lorsque votre liste de destinataires provient d’un système externe (par exemple, une exportation CRM ou un fichier de partenaire) et que vous souhaitez exécuter une campagne sans créer d’abord un pipeline d’ingestion Adobe Experience Platform complet.
Autorisations permissions
Pour utiliser l’activité Chargement de fichier dans une campagne orchestrée, les utilisateurs doivent disposer des autorisations appropriées. Les deux autorisations sont disponibles sous > Adobe Journey Optimizer > Campagnes orchestrées dans l’interface utilisateur des autorisations.
- Afficher le fichier dans les campagnes orchestrées — Accorde un accès en lecture seule. Les utilisateurs disposant de cette autorisation peuvent prévisualiser les résultats d’une campagne orchestrée contenant une activité Chargement de fichier, mais ne peuvent pas ajouter l’activité ni charger de fichier.
- Gérer le fichier dans les campagnes orchestrées — Obligatoire pour ajouter une activité Charger le fichier à la zone de travail de campagne et charger des fichiers. Attribuez cette autorisation à tout utilisateur devant créer ou configurer une activité Chargement de fichier.
Pour obtenir des instructions sur l’attribution des autorisations, voir Gérer les utilisateurs et les rôles.
Mécanismes de sécurisation et limitations limitations
Les restrictions suivantes s’appliquent à l’activité Chargement de fichier :
- Vous pouvez charger jusqu’à 50 Mo par fichier.
- Seuls les fichiers CSV et TXT à structure plate sont pris en charge.
- Les données chargées sont utilisées lors de l’exécution de la campagne et ne sont pas stockées sous la forme d’un jeu de données Adobe Experience Platform.
Pour connaître les limites des activités de canal et de zone de travail, voir Mécanismes de sécurisation et limitations.
Conditions préalables prerequisites
Avant de pouvoir ajouter une activité Chargement de fichier à une campagne orchestrée et la connecter à une activité de message, un administrateur doit effectuer la configuration unique suivante.
Créer une dimension cible de type fichier file-target-dimension
Un Dimension cible de profil de type Fichier permet aux campagnes orchestrées de résoudre les destinataires à partir d’un fichier chargé au lieu d’un schéma Adobe Experience Platform. Il définit l’espace de noms d’identité et le champ d’identifiant utilisés lorsque l’audience du fichier est traitée lors de l’exécution de la campagne.
Créez une dimension cible à partir de Administration > Configurations > Dimension Target Campaign. En savoir plus sur les dimensions cibles
Lors de la création de la dimension cible pour le ciblage basé sur des fichiers, veillez à :
- Définissez Source sur Fichier.
- Sélectionnez l’Espace de noms d’identité qui correspond à la colonne d’identifiant dans vos fichiers, par exemple E-mail.
- Saisissez le chemin d’accès au champ d’identité. Utilisez le champ de fichier contenant l’identifiant, par exemple
emailsi les fichiers chargés incluent une colonneemail.
Créer une configuration de canal pour la diffusion basée sur des fichiers file-channel-configuration
Créez une configuration de canal dédiée qui utilise la dimension cible de type fichier. Cette configuration est sélectionnée dans l’activité de message qui suit l’activité Chargement de fichier dans la zone de travail de votre campagne.
-
Accédez à Administration > Canaux > Configurations de canal et créez une configuration.
-
Sous Détails d’exécution, sélectionnez l’onglet Campagnes orchestrées et activez la configuration des campagnes orchestrées.
-
Dans le champ Dimension cible du profil , sélectionnez la dimension cible de type fichier créée à l’étape précédente.
-
Renseignez les champs de configuration de canal restants et enregistrez-les. En savoir plus sur les configurations de canal pour les campagnes orchestrées
Configurer l’activité Chargement de fichier load-file-configuration
Configurez l’activité en deux parties : définissez la structure de fichiers attendue avec un exemple de fichier, puis spécifiez le fichier à charger lors de l’exécution de la campagne.
-
Ajoutez une activité Chargement de fichier à la zone de travail de votre campagne orchestrée.
-
Saisissez un Libellé pour l’activité.
Définition du fichier d’exemple sample-file
Utilisez un exemple de fichier pour configurer Colonnes et Formatage. Les exemples de données ne sont pas importés en tant qu’audience de la campagne.
-
Dans la section Fichier d’exemple, sélectionnez le fichier local qui définit la structure attendue.
note NOTE L’exemple de fichier est utilisé pour configurer les colonnes et la mise en forme uniquement. Ses données ne sont pas importées en tant qu’audience de campagne. Le format doit correspondre aux fichiers que vous chargerez lors de l’exécution de la campagne. -
Dans la liste déroulante Type de fichier, indiquez si le fichier utilise des colonnes délimitées ou colonnes à largeur fixe.
-
Dans la section Colonnes, développez chaque colonne et configurez ses propriétés.
Après avoir sélectionné un type de données, des options supplémentaires s’affichent pour ce type. Développez les sections ci-dessous pour connaître les paramètres communs à toutes les colonnes et les options spécifiques à un type.
accordion Paramètres communs des colonnes -
Ignorer la colonne — Exclure la colonne de l’importation lorsqu’elle est sélectionnée.
-
Libellé — Nom d’affichage de la colonne (par exemple,
email). -
Nom interne — Nom système de la colonne, dérivé de l’en-tête du fichier (lecture seule).
-
Type de données — Type de données dans la colonne.
-
Allow NULLs — Indique comment gérer les valeurs vides dans la colonne :
- Adobe Campaign par défaut — Génère une erreur pour les champs numériques uniquement. Sinon insère une valeur NULL.
- Valeur vide autorisée — Autorise les valeurs vides. La valeur NULL est alors insérée.
- Toujours renseignée — Génère une erreur en cas de valeur vide.
-
Traitement des erreurs — Définit le comportement en cas d’erreur dans la colonne :
- Ignorer la valeur — La valeur est ignorée.
- Rejeter la ligne — La ligne entière n’est pas traitée.
- Utiliser une valeur par défaut en cas d’erreur — Remplace la valeur causant l’erreur par une valeur par défaut, définie dans le champ Valeur par défaut.
- Utiliser une valeur par défaut en cas d’absence de recodification — Remplace la valeur causant l’erreur par une valeur par défaut, définie dans le champ Valeur par défaut, sauf si une correspondance a été définie pour la valeur en erreur.
- Rejeter la ligne en cas d’absence de recodification — La ligne entière n’est pas traitée sauf si une correspondance a été définie pour la valeur en erreur.
-
Valeur par défaut — Valeur par défaut à utiliser lorsque Traitement d’erreur est défini pour utiliser une valeur par défaut.
-
Remappage des valeurs — Mappez des valeurs spécifiques aux nouvelles. Cliquez sur Ajouter un mappage pour définir chaque mappage (par exemple, remplacez
True/Falsepar1/0).
accordion Paramètres des colonnes de chaînes - Largeur — Nombre maximal de caractères.
- Transformation des données — Transformation de la casse appliquée aux valeurs de chaîne (par exemple, aucune ou majuscule/minuscule).
- Gestion des espaces — Comment gérer les espaces de début et de fin dans les valeurs de chaîne.
accordion Paramètres des colonnes de nombres entiers et flottants -
Format — Définit la façon dont les valeurs numériques du fichier sont lues :
- Autre — Définissez le séparateur des milliers et le séparateur décimal dans la section Séparateurs.
- 1,000.00 — Virgule comme séparateur de milliers et point comme séparateur décimal.
- 1 000,00 — Espace comme séparateur de milliers et virgule comme séparateur décimal.
-
Séparateurs (lorsque Format est Autre) :
- Séparateur des milliers — Caractère qui regroupe des milliers en valeurs numériques (laisser vide si non utilisé).
- Séparateur décimal — Caractère utilisé pour la partie décimale des valeurs numériques (par exemple,
,ou.).
accordion Paramètres des colonnes Date et heure Les options varient selon que Type de données est Date, Heure ou Date et heure.
Date
-
Format de date — Modèle correspondant à la façon dont les dates apparaissent dans le fichier (par exemple,
yyyy/mm/dd). -
Séparateurs :
- Année, mois, jour — Caractère entre les composants année, mois et jour (par exemple,
/).
- Année, mois, jour — Caractère entre les composants année, mois et jour (par exemple,
Heure
-
Format de l’heure — Modèle correspondant à la façon dont les heures apparaissent dans le fichier (par exemple,
13:30pour les heures et minutes de 24 heures). -
Séparateurs :
- Heure, minute, seconde — Caractère entre les composants heure, minute et seconde (par exemple,
:).
- Heure, minute, seconde — Caractère entre les composants heure, minute et seconde (par exemple,
Date et heure
- Format de date — Modèle correspondant à la façon dont la partie de date apparaît dans le fichier.
- Format de l’heure — Motif correspondant à l’affichage de la partie temporelle dans le fichier.
- Séparateurs — Caractères entre les composants date et heure.
-
-
Dans la section Formatage, spécifiez la structure du fichier pour que les lignes et les colonnes soient lues correctement lors de l’exécution de la campagne. Le fichier cible doit utiliser la même mise en forme que l’exemple de fichier.
- Utiliser la première ligne comme en-tête de colonne — Lorsqu’elle est sélectionnée, la première ligne du fichier est traitée comme des noms de colonne. Cette option est généralement activée lorsque vous configurez l’exemple d’un fichier qui inclut une ligne d’en-tête.
- Utiliser un numéro de ligne comme identificateur — Lorsqu’elle est sélectionnée, chaque ligne est identifiée par son numéro de ligne dans le fichier.
- Les enregistrements s’étendent sur plusieurs lignes : si vous sélectionnez un seul enregistrement, il peut s’étendre sur plusieurs lignes du fichier (par exemple, lorsque les champs contiennent des sauts de ligne).
- Lignes à ignorer — Nombre de lignes à ignorer au début du fichier avant la lecture des données (par exemple, lignes de commentaire ou de métadonnées).
- Fuseau horaire — Fuseau horaire appliqué lors de l’importation des valeurs de date et d’heure.
- Encodage — Encodage des caractères du fichier. Sélectionnez le codage correspondant à votre fichier source.
- Délimiteur de chaîne — Caractère utilisé pour entourer les valeurs de chaîne dans le fichier.
- Séparateur de colonnes — Caractère séparant les colonnes d’un fichier délimité.
-
Cliquez sur Confirmer pour valider la configuration de l’exemple de fichier.
Définition du fichier cible target-file
Indiquez le fichier à charger lors de l’exécution de la campagne et la manière dont chaque ligne est mise en correspondance avec des destinataires existants.
-
Dans la section Fichier cible, sélectionnez le fichier CSV ou TXT contenant l’audience à cibler.
note caution CAUTION Assurez-vous que le fichier cible suit le même format, la même structure de colonnes et le même nombre de colonnes que l’exemple de fichier. -
Dans la section Gestion des rejets , définissez le comportement de l’activité en cas d’erreur lors du traitement du fichier :
- Nombre d’erreurs autorisées — Nombre maximal d’erreurs autorisées avant l’échec de l’activité.
- Conserver les rejets dans un fichier — Lorsque cette option est activée, les lignes qui n’ont pas pu être chargées sont écrites dans un fichier de rejets sur le serveur pour révision après exécution.
-
Vous pouvez éventuellement activer l’option Supprimer le fichier après l’importation pour supprimer le fichier chargé du serveur après l’exécution de la campagne.
Une fois que Chargement de fichier a résolu l’audience, connectez la transition sortante aux activités en aval. Découvrez comment orchestrer des activités de campagne.