Chaque entité que vous souhaitez importer doit suivre la même structure de données que celle indiquée dans la documentation de l’API :

Si vous utilisez l’un de nos plugins ou l’une de nos intégrations pour connecter votre site web à Brevo, consultez la documentation spécifique à votre plugin ou intégration dans notre section dédiée Plugins et Intégrations.

Brevo CDP vous permet d’importer des données structurées à partir de serveurs FTP (avec des fichiers CSV ou JSON/JSONL) pour des importations automatisées ponctuelles ou récurrentes. Lors de l’importation de vos données dans Brevo CDP via des serveurs FTP, vos fichiers doivent respecter un format spécifique pour être importés correctement.

Veuillez consulter ci-dessous nos exigences générales et spécifiques à chaque type de fichier, ainsi que nos recommandations pour vos fichiers FTP :

📑 Exigences générales pour les fichiers

Tous les fichiers contenant vos données doivent respecter les exigences suivantes avant d’être importés dans Brevo CDP :

• Enregistrez votre fichier dans l’un des formats suivants :
  

  .CSV

  .JSON/.JSONL

  .ZIP/.GZIP

  Consultez nos exigences pour les fichiers spécifiques pour vos fichiers CSV et JSON/JSONL.

• Créez un fichier par entité. Une entité correspond aux types de données que vous importez, par exemple des contacts, des commandes ou des produits. 
• Enregistrez votre fichier avec l’encodage UTF-8 ou UTF-8 BOM. Ces types d’encodage permettent de lire le contenu de votre fichier lorsqu’il contient des caractères spéciaux.
• Pour chaque enregistrement d’une entité, la clé primaire source doit être renseignée.
  Une clé source est une colonne de votre fichier qui sert d’identifiant unique (ID) pour les enregistrements d’une entité donnée. Par exemple, pour l’entité Contacts, l’ID pourrait être contact_id ou contact_email, et pour l’entité Commandes, l’ID pourrait être order_id. Vous pouvez également combiner différentes colonnes qui formeront un identifiant unique pour chaque enregistrement, par exemple order_id ET product_id pour l’entité Articles de la commande. 

📄 Exigences spécifiques pour les fichiers 

Les fichiers CSV et JSON nécessitent des éléments supplémentaires pour être compatibles avec Brevo CDP. Ouvrez l’onglet correspondant au fichier que vous souhaitez importer dans Brevo CDP pour en savoir plus : 

[
  {
  "field": 1,
  "object": {
    "object_field": 1
     }
   },
  {
  "field": 2,
  "object": {
    "object_field": 2
     }
   }
]

 {
   "records": [
       {"field": 1,
        "object": {
           "object_field": 1
         }
       },
       {"field": 2,
        "object": {
           "object_field": 2
         }
        }
   ]
}

{
  "field": 1,
  "object": {
    "object_field": 1
   }
 }
 {
   "field": 2,
   "object": {
     "object_field": 2 
 }
}

✅ Recommandations

• Par défaut, les données nouvelles et actualisées sont importées toutes les heures pour garantir qu’elles sont pertinentes et à jour.
• Vous pouvez utiliser la convention de nommage suivante : <entity>-<source>-<subsection>_<date>.csv:
  • Les éléments entourés de <> doivent être remplacés par une valeur réelle et sont obligatoires. Par exemple, <entity> sera <contacts> pour un fichier contenant des contacts.
  • <entity> est l’une des entités de l’entreprise décrites ci-dessus.
  • <source> est le nom du système d’où proviennent les données (par exemple, PrestaShop, point de vente, etc.).
  • <subsection> est un paramètre facultatif utilisé pour fournir des informations supplémentaires. Par exemple, vous pouvez avoir deux fichiers de contacts pour une seule source : contacts_prestashop_customers et contacts_prestashop_subscribers.
  • <date> est la date à laquelle le fichier a été créé. Elle doit suivre le format AAAAMMJJ_H24MISS. Par exemple, un fichier créé le 19/10/2024 à 15 h 12 min 39 s aura le suffixe _20241019_151239.csv.
• Le nom du fichier peut être complété par des informations supplémentaires au début (préfixe) et juste avant la date et l’extension .csv (suffixe). Les suffixes doivent être placés avant la date.

Les bases et entrepôts de données, tels que PostgreSQL, MariaDB, MySQL ou BigQuery, ne nécessitent pas d’éléments spécifiques pour être compatibles avec Brevo CDP. Cependant, nous vous recommandons fortement de configurer l’importation incrémentielle en ajoutant une colonne last_updated à votre base ou entrepôt de données. 

L’importation incrémentielle vous permet : 

• D’augmenter les performances.
• De faire en sorte que vos données restent à jour, car les importations incrémentielles récupèrent de nouveaux enregistrements toutes les heures. Sans les importations incrémentielles, vous ne pouvez importer de nouveaux enregistrements qu’une fois par jour par le biais d’une importation complète.
• De respecter davantage l’environnement.