Jede Entität, die Sie importieren möchten, muss dieselbe Datenstruktur aufweisen, wie in der API-Dokumentation angegeben ist:

Wenn Sie eines unserer Plug-Ins oder Integrationen verwenden, um Ihre Website mit Brevo zu verbinden, lesen Sie die Dokumentation zu Ihrem Plug-In oder Ihrer Integration in unserem speziellen Abschnitt Plug-Ins und Integrationen.

Mit der Brevo CDP können Sie strukturierte Daten von FTP-Servern (mit CSV- oder JSON/JSONL-Dateien) für einmalige oder wiederkehrende automatisierte Importe importieren. Wenn Sie Ihre Daten über FTP-Server in die Brevo CDP importieren, müssen Ihre Dateien einem bestimmten Format entsprechen, um korrekt importiert zu werden.

Überprüfen Sie unten unsere allgemeinen und spezifischen Dateianforderungen sowie Empfehlungen für Ihre FTP-Dateien:

📑 Allgemeine Dateianforderungen

Alle Dateien, die Ihre Daten enthalten, müssen die folgenden Anforderungen erfüllen, bevor sie in die Brevo CDP importiert werden:

• Speichern Sie Ihre Datei in einem der folgenden Formate:
  

  .CSV

  .JSON/.JSONL

  .ZIP/.GZIP

  Überprüfen Sie unsere spezifischen Dateianforderungen für Ihre CSV- und JSON/JSONL-Dateien.

• Erstellen Sie eine Datei pro Einheit. Eine Einheit ist der Umfang der Daten, die Sie importieren, z. B. Kontakte, Bestellungen oder Produkte. 
• Speichern Sie Ihre Datei mit UTF-8 oder UTF-8 BOM Kodierung. Diese Arten der Dateikodierung ermöglichen die Lesbarkeit der Inhalte in Ihrer Datei, wenn diese Sonderzeichen enthält.
• Jeder Datensatz in einer Entität muss mindestens den Wert des Quellprimärschlüssels enthalten.
  Ein Quellschlüssel ist eine Spalte aus Ihrer Datei, die als eindeutiger Bezeichner (ID) für die Datensätze einer bestimmten Entität fungiert. Zum Beispiel könnte die ID für die Entität Contacts (Kontakte) contact_id oder contact_email sein, und für die Entität Orders (Bestellungen) könnte die ID order_id sein. Sie können auch verschiedene Spalten kombinieren, die eine eindeutige ID für jeden Datensatz bilden, wie z. B. order_id UND product_id für die Entität Order items (Bestellung von Artikeln). 

📄 Spezifische Dateianforderungen 

Die CSV- und JSON-Dateien benötigen zusätzliche Elemente, um mit dem Brevo CDP kompatibel zu sein. Öffnen Sie den Tab, der der Datei entspricht, die Sie in das Brevo CDP importieren möchten, um mehr zu erfahren: 

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

 {
   "records": [
       {"Feld": 1,
        "Objekt": {
           "object_field": 1
         }
       },
       {"Feld": 2,
        "Objekt": {
           "object_field": 2
         }
        }
   ]
}

{
  "Feld": 1,
  "Objekt": {
    "object_field": 1
   }
 }
 {
   "Feld": 2,
   "Objekt": {
     "object_field": 2 
 }
}

✅ Empfehlungen

• Standardmäßig werden neue und aktualisierte Daten jede Stunde importiert, um relevante und aktuelle Daten zu gewährleisten.  
• Sie können die folgende Namenskonvention verwenden: <entity>-<source>-<subsection>_<date>.csv:
  • Elemente, die von <> umgeben sind, müssen durch einen realen Wert ersetzt werden und sind erforderlich. Beispielsweise wird <entity> für eine Datei mit Kontakten zu <contacts>.
  • <entity> ist eine der oben beschriebenen Geschäftsentitäten.
  • <source> ist der Name des Systems, aus dem die Daten stammen (z. B. Prestashop, POS usw.).
  • <subsection> ist ein optionaler Parameter, der verwendet wird, um zusätzliche Informationen bereitzustellen. Zum Beispiel können Sie zwei Kontakte-Dateien für eine einzige Quelle haben: contacts_prestashop_customers und contacts_prestashop_subscribers.
  • <date> ist das Datum, an dem die Datei erstellt wurde. Das Datum muss dem Format YYYYMMDD_H24MISS entsprechen. Zum Beispiel hat eine Datei, die am 19.10.2024 um 15:12:39 erstellt wurde, den folgenden Suffix _20241019_151239.csv.
• Der Dateiname kann mit zusätzlichen Informationen am Anfang (Präfix) und direkt vor der Erweiterung .csv erweitert werden (Suffix). Suffixe sollten vor dem Datum stehen.

Datenbanken und Datawarehouses wie PostgreSQL, MariaDB, MySQL oder BigQuery benötigen keine spezifischen Elemente, um mit dem Brevo CDP kompatibel zu sein. Wir empfehlen Ihnen jedoch dringend, einen inkrementellen Import einzurichten, indem Sie Ihrer Datenbank oder Ihrem Datawarehouse eine Spalte last_updated hinzufügen. 

Der inkrementelle Import ermöglicht es Ihnen: 

• Steigern Sie die Leistung.
• Halten Sie Ihre Daten aktuell, indem inkrementelle Importe stündlich neue Datensätze abrufen und so sicherstellen, dass Ihre Daten stets aktuell bleiben. Ohne inkrementelle Importe können Sie neue Datensätze nur einmal täglich über einen Vollimport importieren.
• Seien Sie umweltfreundlicher.