Cada entidad que desee importar debe seguir la misma estructura de datos que se indica en la documentación de la API:

Si utiliza uno de nuestros plugins o integraciones para conectar su sitio web a Brevo, consulte la documentación específica de su plugin o integración en nuestra sección dedicada Plugins e Integraciones.

La CDP de Brevo le permite importar datos estructurados desde servidores FTP (con archivos CSV o JSON/JSONL) para importaciones automatizadas puntuales o recurrentes. Al importar sus datos a la CDP de Brevo a través de servidores FTP, sus archivos deben seguir un formato específico para poder importarlos correctamente.

Consulte a continuación nuestros requisitos generales y específicos de archivos, junto con las recomendaciones para sus archivos FTP:

📑 Requisitos generales de archivos

Todos los archivos que contienen sus datos deben cumplir los siguientes requisitos antes de importarlos en el CDP de Brevo:

• Guarde su archivo en uno de los siguientes formatos:
  

  .CSV

  .JSON/.JSONL

  .ZIP/.GZIP

  Consulte nuestros requisitos específicos de archivo para sus archivos CSV y JSON/JSONL.

• Cree un archivo por entidad. Una entidad es el alcance de los datos que está importando, como contactos, pedidos o productos, por ejemplo. 
• Guarde su archivo con codificación UTF-8 o UTF-8 BOM. Estos tipos de codificación de archivos permiten leer el contenido de su archivo cuando incluye caracteres especiales.
• Cada registro en una entidad debe tener al menos el valor de la clave primaria de origen completado.
  Una clave de origen es una columna de su archivo que actúa como un identificador único (ID) para los registros de una entidad dada. Por ejemplo, para la entidad Contacts (Contactos),el ID podría ser contact_id o contact_email, y para la entidad Orders (Pedidos), el ID podría ser order_id. También puede combinar diferentes columnas para formar un identificador único para cada registro, como order_id y product_id para la entidad Order items (Artículos de pedidos). 

📄 Requisitos específicos del archivo 

Los archivos CSV y JSON necesitan elementos adicionales para ser compatibles con la CDP de Brevo. Abra la pestaña correspondiente al archivo que desea importar a la CDP de Brevo para obtener más información: 

[
  {
  "campo": 1,
  "objeto": {
    "object_field": 1
     }
   },
  {
  "campo": 2,
  "objeto": {
    "object_field": 2
     }
   }
]

 {
   "registros": [
       {"campo": 1,
        "objeto": {
           "object_field": 1
         }
       },
       {"campo": 2,
        "objeto": {
           "object_field": 2
         }
        }
   ]
}

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

✅ Recomendaciones

• De forma predeterminada, los datos nuevos y actualizados se importan cada hora para garantizar datos relevantes y actualizados.  
• Puede utilizar la siguiente convención de nomenclatura: <entity>-<source>-<subsection>_<date>.csv:
  • Los elementos rodeados por <> deben ser reemplazados por un valor real y son obligatorios. Por ejemplo, <entity> será <contacts> para un archivo que contenga contactos.
  • <entity> es una de las entidades business descritas anteriormente.
  • <source> es el nombre del sistema de donde provienen los datos (por ejemplo, prestashop, pos, etc.).
  • <subsection> es un parámetro opcional que se utiliza para ofrecer información adicional. Por ejemplo, puede tener dos archivos de Contactos para una sola fuente contacts_prestashop_customers y contacts_prestashop_subscribers.
  • <date> es la fecha en la que se creó el archivo. La fecha debe seguir el formato YYYYMMDD_H24MISS. Por ejemplo, un archivo creado el 19 de octubre de 2024 a las 15:12:39 tendrá el siguiente sufijo _20241019_151239.csv.
• El nombre del archivo puede ampliarse con información adicional al principio (prefijo) y justo antes de la fecha .csv extensión (sufijo). Los sufijos deben colocarse antes de la fecha.

Las bases de datos y los almacenes de datos, como PostgreSQL, MariaDB, MySQL o BigQuery, no requieren elementos específicos para ser compatibles con el CDP de Brevo. Sin embargo, recomendamos encarecidamente configurar la importación incremental añadiendo una columna last_updated a su base de datos o almacén de datos. 

La importación incremental le permite: 

• Aumente el rendimiento.
• Mantenga los datos actualizados, ya que las importaciones incrementales obtienen nuevos registros cada hora, asegurando que sus datos se mantengan actualizados. Sin importaciones incrementales, solo puede importar nuevos registros una vez al día a través de una importación completa.
• Sea más respetuoso con el medio ambiente.