Show Menu
SUJETS×

Importer des données

Collecter des données

Vous pouvez collecter des données depuis un fichier pour les traiter et/ou les importer dans la base de données Adobe Campaign.
  • The Load file activity allows you to import data in one structured form to use this data in Adobe Campaign. Les données importées le sont temporairement et nécessitent l'utilisation d'une autre activité pour les intégrer définitivement dans la base de données Adobe Campaign.
    For more on how to use this activity, refer to this section .
  • The Transfer file activity allows you to receive or send files, test whether there are files present, or list files in Adobe Campaign. You can use this activity before a Load file in case you need to retrieve the file from an external source.
    For more on how to use this activity, refer to this section .

Bonnes pratiques d'import

Pour garantir la cohérence des données au sein de la base de données et éviter les erreurs fréquentes lors de la mise à jour de la base de données ou de l'export de données, faites preuve de précaution et suivez les quelques règles simples détaillées ci-dessous.

Utiliser les modèles d'import

La plupart des d’importation doivent contenir suivants : Load file , Reconciliation , Segmentation , Deduplication , Update data .
L'utilisation de modèles d'import facilite la préparation d'imports similaires et garantit la cohérence des données au sein de la base de données.
In many projects, imports are built without Deduplication activity because the files used in the project do not have duplicates. Des doublons apparaissent parfois suite à l'import d'autres fichiers. La déduplication est alors difficile. C'est pourquoi l'ajout d'une étape de déduplication est une précaution utile pour tous les workflows d'import.
Ne partez pas de l'hypothèse selon laquelle les données entrantes sont cohérentes et justes ou que le département informatique ou le responsable Adobe Campaign s'en occupera. Gardez la normalisation des données à l'esprit tout au long du projet. Veillez à dédupliquer, à réconcilier et à maintenir la cohérence des données lors des imports.
Un exemple de modèle de workflow générique conçu pour importer des données est disponible dans la section Exemple : modèle de workflow d'import .
Vous pouvez également utiliser des modèles d'import . Il existe des modèles de workflow définis par un administrateur qui, lorsqu'ils sont activés, permettent uniquement de spécifier le fichier contenant les données à importer.
Rubriques connexes :

Utiliser des formats de fichiers plats

Le format le plus efficace pour les imports est le fichier plat. Les fichiers plats peuvent être importés en masse au niveau de la base de données.
Par exemple :
  • Séparateur : onglet ou point virgule
  • Première ligne avec en-têtes
  • Pas de délimiteur de chaîne
  • Format de date : AAAA/MM/JJ HH:mm:SS
Voici un exemple de fichier à importer :
lastname;firstname;birthdate;email;crmID
Smith;Hayden;23/05/1989;hayden.smith@example.com;124365
Mars;Daniel;17/11/1987;dannymars@example.com;123545
Smith;Clara;08/02/1989;hayden.smith@example.com;124567
Durance;Allison;15/12/1978;allison.durance@example.com;120987

Utiliser la compression

Lorsque cela est possible, utilisez des fichiers compressés pour les imports et les exports. GZIP est pris en charge par défaut. You can add pre-processing when importing files or post-processing when extracting data, respectively in the Load file and Extract file workflow activities.
Rubriques connexes :

Importer en mode Delta

Les imports standard doivent être effectués en mode delta. Cela signifie qu'au lieu d'envoyer le tableau entier à chaque fois, seules les données modifiées ou nouvelles sont envoyée à Adobe Campaign.
Les imports complets sont réservés au chargement initial.

Maintenir la cohérence

Pour maintenir la cohérence des données dans la base de données Adobe Campaign, veuillez appliquer les principes suivants :
  • Si les données importées correspondent à une table de référence dans Adobe Campaign, elles doivent être réconciliées avec ce tableau dans le workflow. Les enregistrements sans correspondance doivent être rejetés.
  • Assurez-vous que les données importées soient toujours « normalisées » (email, numéro de téléphone, adresse postale) et que cette normalisation soit fiable et ne risque pas de changer pas au fil des années. Si ce n'est pas le cas, des doublons risquent d'apparaître dans la base de données, et dans la mesure où Adobe Campaign ne fournit pas d'outils de « correspondance approximative », leur suppression sera très difficile.
  • Les données transactionnelles doivent être dotées d'une clé de réconciliation et être réconciliées avec les données existantes afin d'éviter la création de doublons.
  • Les fichiers liés doivent être importés dans l'ordre . Si l'import est composé de fichiers multiples et interdépendants, le workflow doit vérifier que les fichiers sont importés dans l'ordre. Si un fichier échoue, les autres fichiers ne sont pas importés.
  • Dédupliquez , réconciliez et maintenez la cohérence lorsque vous importez des données.

Gérer des données cryptées

Dans certains cas, les données que vous souhaitez importer peuvent être cryptées, par exemple si elles contiennent des données d’identification personnelle.
Pour pouvoir importer ou exporter des fichiers cryptés, vous devez d’abord contacter l’Assistance clientèle d’Adobe pour obtenir votre instance avec les commandes de cryptage/décryptage nécessaires.
Pour ce faire, envoyez une requête indiquant :
  • Le libellé qui s’affichera dans l’interface de Campaign pour utiliser la commande. Par exemple, « Crypter le fichier ».
  • La commande à installer sur votre instance. Par exemple, pour décrypter un fichier à l’aide de PGP, la commande sera :
    <path-to_pgp_if-not_global_or_server/>pgp.exe --decrypt --input nl6/var/vp/import/filename.pgp --passphrase "your password" --recipient recipient @email.com --verbose --output nl6/var/vp/import/filename
    
    
Une fois la requête traitée, les commandes de chiffrement/déchiffrement seront disponibles dans le Pre-processing stage] champ à partir du Load file et de l' de Extract file . Vous pouvez les utiliser pour décrypter ou crypter les fichiers à importer ou exporter.
Rubriques connexes :

Création de modèles de processus pour importer des données

L'utilisation d'un modèle d'import est une bonne pratique si vous devez importer régulièrement des fichiers de structure identique.
Cet exemple montre comment pré-paramétrer un workflow qui pourra être réutilisé pour importer des profils en provenance d'un CRM dans la base de données Adobe Campaign.
  1. Créez un modèle de processus à partir de Resources > Templates > Workflow templates .
  2. Ajoutez les activités suivantes :
    • Load file : Définissez la structure attendue du fichier contenant les données à importer.
      Il n'est possible d'importer que les données d'un seul fichier. If the workflow has multiple Load file activities, the same file will be used each time.
    • Reconciliation : Rapprochez les données importées des données de base de données.
    • Segmentation  : créez des filtres pour traiter les enregistrements différemment selon qu'ils aient pu ou non être réconciliés.
    • Deduplication : Dédupliquez les données du fichier entrant avant de les insérer dans la base de données.
    • Update data : Mettez à jour la base de données avec le importé.
  3. Configurez le : Load file
    • Définissez la structure attendue en téléchargeant un fichier exemple. Le fichier exemple ne doit contenir que quelques lignes mais toutes les colonnes nécessaires pour l'import. Vérifiez et éditez le format du fichier pour vous assurer que le type de chaque colonne est paramétré correctement : texte, date, nombre entier, etc. Par exemple :
      lastname;firstname;birthdate;email;crmID
      Smith;Hayden;23/05/1989;hayden.smith@mailtest.com;123456
      
      
    • Dans la File to load section, sélectionnez Upload a new file from the local machine et laissez le champ vide. A chaque fois qu'un nouveau workflow sera créé à partir de ce modèle, vous pourrez préciser ici le fichier souhaité (tant qu'il correspond à la structure définie).
      Toutes les options sont utilisables, mais il faut modifier le modèle en conséquence. Par exemple, si vous sélectionnez Use the file specified in the inbound transition , vous pouvez ajouter un Transfer file avant de récupérer le fichier à importer à partir d’un serveur FTP/SFTP.
      Si vous souhaitez que les utilisateurs puissent télécharger un fichier contenant des erreurs survenues au cours d’une importation, cochez l’ Keep the rejects in a file option et spécifiez le File name .
  4. Configurez le Reconciliation . Dans ce contexte, le but de cette activité est d'identifier les données entrantes.
    • In the Relations tab, select Create element and define a link between the imported data and the recipients targeting dimension (see Targeting dimensions and resources ). Dans cet exemple, le champ personnalisé Identifiant dans le CRM permet de créer la condition de jointure. Utilisez le champ ou la combinaison de champs nécessaire tant que l'identification des enregistrements uniques reste possible.
    • Dans l’ Identification onglet, laissez l’ Identify the document from the working data option désactivée.
  5. Configurez l'activité Segmentation pour récupérer les destinataires réconciliés dans une transition, ainsi que les destinataires qui n'ont pas pu être réconciliés mais qui disposent de suffisamment de données dans une autre transition.
    La transition des destinataires réconciliés peut alors être utilisée pour mettre à jour la base de données. La transition des destinataires inconnus peut servir à créer de nouvelles entrées de destinataires dans la base de données si un ensemble d'informations minimum est disponible dans le fichier.
    Les destinataires ne pouvant pas être réconciliés et ne disposant pas de suffisamment de données sont sélectionnés dans une transition sortante complémentaire et peuvent être exportés dans un fichier séparé ou tout simplement ignorés.
    • Dans l’ General onglet de la , définissez la Resource type valeur Temporary resource et sélectionnez Reconciliation comme jeu ciblé.
    • In the Advanced options tab, check the Generate complement option to be able to see if any record cannot be inserted in the database. Le cas échéant, vous pourrez alors appliquer d'autres traitements aux données complémentaires : export de fichier, mise à jour de liste, etc.
    • Dans le premier segment de l'onglet Segments , ajoutez une condition de filtrage sur la population entrante pour sélectionner uniquement les enregistrements pour lesquels l'identifiant dans le CRM du profil est différent de 0. De cette manière, les données du fichier réconciliées avec les profils de la base de données sont sélectionnées dans ce sous-ensemble.
    • Ajoutez un second segment pour sélectionner les enregistrements non réconciliés disposant de suffisamment de données pour être intégrés dans la base de données Par exemple : adresse email, prénom et nom de famille. La valeur de l'identifiant dans le CRM des profils des enregistrements qui ne sont pas réconciliés est égale à 0.
    • All records that are not selected in the first two subsets are selected in the Complement .
  6. Configure the Update data activity located after the first outbound transition of the Segmentation activity configured previously.
    • Select Update as Operation type since the inbound transition only contains recipients already present in the database.
    • Dans l’ Identification onglet, sélectionnez Using reconciliation criteria et définissez une clé entre le Dimension to update - de dans ce cas - et le lien créé dans le Reconciliation . Dans cet exemple, le champ personnalisé Identifiant dans le CRM est utilisé.
    • In the Fields to update tab, indicate the fields from the Profiles dimension to update with the value of the corresponding column from the file. Si les noms des colonnes du fichier sont identiques ou presque identiques aux noms des champs de la dimension des destinataires, utilisez le bouton baguette magique pour réconcilier les différents champs automatiquement.
      Si vous envisagez d'envoyer des courriers à ces profils, veillez à inclure une adresse postale, car cette information est indispensable pour l'opérateur de services postaux. Also make sure that the Address specified box in your profiles' information is checked. Pour mettre à jour cette option dans un workflow, ajoutez simplement un élément aux champs à mettre à jour. Spécifiez 1 comme Source et sélectionnez le champ postalAddress/@addrDefined comme Destination . For more on direct mail and the use of the Address specified option, see this document .
  7. Configure the Deduplication activity located after the transition containing unreconciled profiles:
    • In the Properties tab, set the Resource type to the temporary resource generated from the Reconciliation activity of the workflow.
    • Dans cet exemple, le champ email est utilisé pour trouver les profils uniques. Vous pouvez utiliser n'importe quel champ dont vous êtes sûr qu'il est rempli et qu'il fait partie d'une combinaison unique.
    • Choose a Deduplication method . Dans ce cas, l'application décide automatiquement quels enregistrements conserver en cas de doublons.
  8. Configurez le Update data situé après le Deduplication configuré précédemment.
    • Select Insert only as Operation type since the inbound transition only contains profiles not present in the database.
    • Dans l’ Identification onglet, sélectionnez Using reconciliation criteria et définissez une clé entre le Dimension to update - de dans ce cas - et le lien créé dans le Reconciliation . Dans cet exemple, le champ personnalisé Identifiant dans le CRM est utilisé.
    • In the Fields to update tab, indicate the fields from the Profiles dimension to update with the value of the corresponding column from the file. Si les noms des colonnes du fichier sont identiques ou presque identiques aux noms des champs de la dimension des destinataires, utilisez le bouton baguette magique pour réconcilier les différents champs automatiquement.
      Si vous envisagez d'envoyer des courriers à ces profils, veillez à inclure une adresse postale, car cette information est indispensable pour l'opérateur de services postaux. Also make sure that the Address specified box in your profiles' information is checked. Pour mettre à jour cette option dans un workflow, ajoutez simplement un élément aux champs à mettre à jour. Spécifiez 1 comme Source et sélectionnez le champ # comme Destination . For more on direct mail and the use of the Address specified option, see this document .
  9. After the third transition of the Segmentation activity, add a Extract file activity and a Transfer file activity if you want to keep track of data not inserted in the database. Paramétrez ces activités afin d'exporter la colonne dont vous avez besoin et de transférer le fichier sur un serveur FTP ou SFTP, où vous pourrez le récupérer.
  10. Add an End activity and save the workflow template.
Le modèle est à présent utilisable et disponible pour chaque nouveau workflow. All is needed is then to specify the file containing the data to import in the Load file activity.