Ogni entità che desideri importare deve seguire la stessa struttura di dati indicata nella documentazione dell'API:

Se utilizzi uno dei nostri plugin o integrazioni per collegare il tuo sito web a Brevo, consulta la documentazione specifica del tuo plugin o integrazione nella nostra sezione dedicata Plugin e integrazioni.

La CDP di Brevo consente di importare dati strutturati da server FTP (con file CSV o JSON/JSONL) per importazioni automatizzate una tantum o ricorrenti. Durante l'importazione dei dati sulla CDP di Brevo tramite server FTP, i file devono rispettare un formato specifico per essere importati correttamente.

Di seguito sono riportati i nostri requisiti generali e specifici per i file, insieme ai consigli per i tuoi file FTP:

📑 Requisiti generali dei file

Tutti i file contenenti i tuoi dati devono seguire i seguenti requisiti prima di essere importati nella CDP di Brevo:

• Salva il tuo file in uno dei formati seguenti:
  

  .CSV

  .JSON/.JSONL

  .ZIP/.GZIP

  Controlla i nostri requisiti specifici per i tuoi file CSV e JSON/JSONL.

• Crea un file per entità. Un'entità è l'ambito dei dati che stai importando, ad esempio contatti, ordini o prodotti. 
• Salva il tuo file con la codifica UTF-8 o BOM UTF-8. Questi tipi di codifica dei file consentono di leggere il contenuto del tuo file quando contiene caratteri speciali.
• Ogni record in un'entità deve avere almeno il valore della chiave primaria di origine inserito.
  Una chiave di origine è una colonna del tuo file che funge da identificatore univoco (ID) per i record di una determinata entità. Ad esempio, per l'entità Contacts (Contatti) , l'ID potrebbe essere contact_id o contact_email e per l'entità Orders (Ordini) , l'ID potrebbe essere order_id. È inoltre possibile combinare colonne diverse che formeranno un ID univoco per ogni record, ad esempio order_id E product_id per l'entità Order items (Articoli degli ordini). 

📄 Requisiti specifici dei file 

I file CSV e JSON richiedono elementi aggiuntivi per essere compatibili con la CDP di Brevo. Apri la scheda corrispondente al file che desideri importare nella CDP di Brevo per ulteriori informazioni: 

[
  {
  "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
         }
        }
   ]
}

{
  "campo": 1,
  "oggetto": {
    "object_field": 1
   }
 }
 {
   "campo": 2,
   "oggetto": {
     "object_field": 2 
 }
}

✅ Consigli

• Per impostazione predefinita, i dati nuovi e aggiornati vengono importati ogni ora per garantire dati pertinenti e aggiornati.  
• È possibile utilizzare la seguente convenzione di denominazione: <entity>-<source>-<subsection>_<date>.csv
  • Gli elementi racchiusi da <> devono essere sostituiti con un valore reale e sono obbligatori. Ad esempio, <entity> sarà <contacts> per un file che contiene contatti.
  • <entity> è una delle entità aziendali descritte sopra.
  • <source> è il nome del sistema da cui provengono i dati (ad es. prestashop, pos, ecc.).
  • <subsection> è un parametro opzionale da usare per fornire informazioni aggiuntive. Ad esempio, puoi avere due file di contatti per un'unica origine contacts_prestashop_customers e contacts_prestashop_subscribers.
  • <date> è la data in cui il file è stato creato. La data deve seguire il formato YYYYMMDD_H24MISS. Ad esempio, un file creato il 19/10/2024 alle 15:12:39 avrà il seguente suffisso _20241019_151239.csv.
• Il nome del file può essere esteso con informazioni aggiuntive all'inizio (prefisso) e direttamente prima dell'estensione .csv con la data (suffisso). I suffissi devono essere posizionati prima della data.

I database e i data warehouse, come PostgreSQL, MariaDB, MySQL o BigQuery, non richiedono elementi specifici per essere compatibili con la CDP di Brevo. Tuttavia, ti consigliamo vivamente di impostare l'importazione incrementale aggiungendo una colonna last_updated al tuo database o data warehouse. 

L'importazione incrementale consente di: 

• Aumentare le prestazioni.
• Mantenere i dati aggiornati poiché le importazioni incrementali recuperano nuovi record ogni ora, assicurando che i tuoi dati rimangano sempre aggiornati. Senza importazioni incrementali, puoi importare nuovi record solo una volta al giorno tramite un'importazione completa.
• Essere più ecologici.