Cada entidade que você deseja importar deve seguir a mesma estrutura de dados indicada na documentação da API:

Se você usar um de nossos plug-ins ou integrações para conectar seu site à Brevo, consulte a documentação específica do plug-in ou da integração em nossa seção dedicada Plug-ins e integrações.

A Brevo CDP permite importar dados estruturados de servidores FTP (com arquivos CSV ou JSON/JSONL) para importações automatizadas únicas ou recorrentes. Ao importar seus dados para a Brevo CDP por meio de servidores FTP, seus arquivos precisam seguir um formato específico.

Verifique abaixo nossos requisitos gerais e específicos de arquivos, juntamente com recomendações para seus arquivos FTP:

📑 Requisitos gerais de arquivo

Todos os arquivos que contêm seus dados devem seguir os seguintes requisitos antes de serem importados para o Brevo CDP:

• Salve o arquivo em um dos seguintes formatos:
  

  .CSV

  .JSON/.JSONL

  .ZIP/.GZIP

  Verifique nossos requisitos específicos de arquivo para seus arquivos CSV e JSON/JSONL.

• Crie um arquivo por entidade. Uma entidade é o escopo dos dados que você está importando, por exemplo, contatos, pedidos ou produtos. 
• Salve seu arquivo com codificação UTF-8 ou UTF-8 BOM. Esses tipos de codificação de arquivos permitem a leitura do conteúdo do seu arquivo quando ele contém caracteres especiais.
• Cada registro em uma entidade deve ter pelo menos o valor da chave primária de origem preenchido.
  Uma chave de origem é uma coluna do seu arquivo que funciona como um identificador único (ID) para os registros de uma determinada entidade. Por exemplo, para a entidade Contacts (Contatos), o ID pode ser contact_id ou contact_email e, para a entidade Orders (Pedidos), o ID pode ser order_id. Você também pode combinar diferentes colunas que formarão um ID exclusivo para cada registro, como order_id E product_id para a entidade de Order items (Itens do pedido). 

📄 Requisitos específicos de arquivo 

Os arquivos CSV e JSON precisam de elementos adicionais para serem compatíveis com a Brevo CDP. Abra a guia correspondente ao arquivo que você quer importar para a Brevo CDP para saber mais: 

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

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

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

✅ Recomendações

• Por padrão, dados novos e atualizados são importados a cada hora para garantir dados relevantes e atualizados.  
• Você pode usar a seguinte convenção de nomenclatura: <entity>-<source>-<subsection>_<date>.csv:
  • Os elementos cercados por <> devem ser substituídos por um valor real e são obrigatórios. Por exemplo, <entity> será <contacts> para um arquivo que contenha contatos.
  • <entity> é uma das entidades empresariais descritas acima.
  • <source> é o nome do sistema de onde provêm os dados (por exemplo, prestashop, pos etc.).
  • <subsection> é um parâmetro opcional usado para fornecer informações adicionais. Por exemplo, você pode ter dois arquivos de contatos para uma única fonte contacts_prestashop_customers e contacts_prestashop_subscribers.
  • <date> é a data em que o arquivo foi criado. A data deve seguir o formato YYYYMMDD_H24MISS. Por exemplo, um arquivo criado em 19/10/2024 às 15:12:39 terá o seguinte sufixo _20241019_151239.csv.
• O nome do arquivo pode ser ampliado com informações adicionais no início (prefixo) e imediatamente antes da extensão .csv com a data (sufixo). Os sufixos devem ser colocados antes da data.

Bancos de dados e data warehouses, como PostgreSQL, MariaDB, MySQL ou BigQuery, não exigem elementos específicos para serem compatíveis com a Brevo CDP. No entanto, recomendamos configurar a importação incremental adicionando uma coluna last_updated ao seu banco de dados ou data warehouse. 

A importação incremental permite que você: 

• Melhore os desempenhos.
• Mantenha os dados atualizados, pois as importações incrementais buscam novos registros a cada hora, garantindo que os dados permaneçam atualizados. Sem importações incrementais, é possível importar novos registros apenas uma vez por dia por meio de uma importação completa.
• Seja mais sustentável.