Einleitung

In Ländern mit Vorschriften zu Werbung für Finanzprodukte und -dienstleistungen verlangt Meta möglicherweise, dass Werbetreibende ihre Identität sowie ihre Erlaubnis zur Erbringung von Finanzdienstleistungen verifizieren. Die Aufsichtsbehörden stellen Meta einen Datensatz für die Erlaubnis zur Verfügung, anhand derer Meta die von den Werbetreibenden eingereichte Erlaubnis überprüft. In diesem Dokument wird erläutert, wie Aufsichtsbehörden Daten zur Erlaubnis sicher mit Meta teilen können. Außerdem werden die technischen Spezifikationen zur Integration beschrieben.

Übersicht

Die Integration funktioniert wie folgt:

1. Meta stellt SFTP-Zugangsdaten bereit – Meta sendet die Zugangsdaten an die bestätigte E-Mail-Adresse der Aufsichtsbehörde.
2. Die Aufsichtsbehörde lädt zwei Dateien hoch – eine config.json-Datei (Metadaten) und eine CSV-Datei (Daten zur Erlaubnis) werden auf den sicheren SFTP-Server von Meta hochgeladen. Anleitung zum Hochladen von Dateien
3. Meta erfasst die Daten – Dateien werden in regelmäßigen Abständen verarbeitet.
4. Die Aufsichtsbehörde lädt regelmäßig Dateien hoch – Aufsichtsbehörden sind dafür verantwortlich, wöchentlich aktualisierte Dateien hochzuladen.

Was ist config.json?

Die config.json-Datei ist ein Manifest, das Metadaten zur Verarbeitung enthält. Die Datei muss bei jedem Upload enthalten sein.

Felder

Beispiel

{
  "version": "v1",
  "load_type": "full",
  "mode": "ingestion",
  "support_email_addresses": [
    "support@domain.com",
    "support2@domain.com"
  ]
}

Daten zur Erlaubnis (CSV)

Die Daten zur Erlaubnis werden als CSV-Datei bereitgestellt. Die Datei kann beliebig benannt werden. Es gibt zwei Arten, sie zu laden:

• Vollständiges Laden – Enthält den kompletten Datensatz aller Daten zur Erlaubnis.
• Inkrementelles Laden – Enthält nur die Änderungen (Deltas) seit dem letzten Upload.

Allgemeine Regeln

• Spaltenüberschriften müssen in der ersten Zeile stehen.
• Alle Spaltenüberschriften müssen eindeutig sein.
• Alle erforderlichen Spalten müssen vorhanden sein.
• Jede Zeile benötigt eine individuelle Credential_Id.
• Fehler auf Zeilenebene blockieren nicht die gesamte Datei. Gültige Zeilen werden weiterhin erfasst. Wenn beispielsweise 50 von 100.000 Zeilen Fehler aufweisen, werden die verbleibenden 99.950 Zeilen normal verarbeitet.

Schema bei vollständigem Laden (V1)

Um Nachahmung, Betrug und Missbrauch auf den Werbeplattformen von Meta zu verhindern, ist eine Verbindungsprüfung erforderlich. Die hochgeladenen Daten zur Erlaubnis der Finanzaufsicht müssen für jede Erlaubnis mindestens eine der folgenden Angaben enthalten, damit die Überprüfung durchgeführt werden kann: Telefonnummer, E-Mail-Adresse oder Website-URL. So wird sichergestellt, dass der*die Werbetreibende, der*die Werbung schalten möchte, eine Erlaubnis verwendet, die mit der zu verifizierenden Entität verbunden ist.

Schema bei inkrementellem Laden (V1)

Das Schema bei inkrementellem Laden umfasst dieselben Spalten wie das bei vollständigem Laden. Außerdem ist eine zusätzliche Spalte erforderlich:

Vorgangsregeln

• UPSERT – Fügt eine neue Erlaubnis hinzu oder aktualisiert eine vorhandene. Hier gelten dieselben Regeln für erforderliche/optionale Felder wie im Schema bei vollständigem Laden.
• DELETE – Entfernt eine Erlaubnis. Nur Credential_Id ist erforderlich, alle anderen Felder sind optional.

Beispiel für ein inkrementelles Ladeszenario

Ein Ausgangsdatensatz enthält drei Erlaubnisse: A, B, C.

Folgende Änderungen werden anschließend durchgeführt:

• Erlaubnis B wird aktualisiert.
• Erlaubnis C wird gelöscht.
• Erlaubnis D wird hinzugefügt.

Die inkrementelle CSV-Datei würde Folgendes enthalten:

Erlaubnis A ist nicht enthalten, da sie keine Änderungen hatte.

Der Zeitstempel deines zuletzt erfassten Datensatzes ist über den Ordner ingestion_history/ auf dem SFTP-Server verfügbar (siehe unten).

SFTP-Upload und Erfassungsvorgang

Upload

1. Logge dich mit den von Meta bereitgestellten Anmeldedaten bei dem SFTP-Server ein.
2. Lade sowohl config.json als auch deine CSV-Datendatei in dein Standardverzeichnis hoch.
3. Warte, bis die Verarbeitung abgeschlossen ist. Dateien können mehrmals täglich im validation-Modus in config.json validiert werden. Daten können jedoch nur einmal pro Tag erfasst werden.

Nach dem Upload

• Nach der Verarbeitung werden beide Dateien automatisch in ein validation_history/- oder ingestion_history/-Verzeichnis verschoben, je nachdem, welcher Modus in config.json eingestellt ist. Wenn die hochgeladene CSV-Datei Fehler auf Zeilenebene enthält, z. B. fehlende erforderliche Werte oder ungültige Werte, wird eine separate CSV-Datei generiert, in der diese Fehler aufgeführt sind. Nutze vor der Erfassung den validation-Modus, um sicherzustellen, dass deine Dateien korrekt verarbeitet werden.
• Bei jedem Durchlauf wird ein mit einem Zeitstempel versehener Ordner (z. B. 2026-03-11T12-23-56Z/) erstellt, der genau die Dateien enthält, die im Verzeichnisverlauf verwendet werden.
• Wenn sich deine Dateien noch im Standardverzeichnis befinden (nicht in ingestion_history/ oder validation_history/), heißt das, dass sie noch nicht verarbeitet wurden.
• Speicherdauer: Der SFTP-Server speichert Dateien nur 30 Tage lang.

Beispiel: Vor und nach der Erfassung

Unten siehst du die Dateistruktur vor und nach einer neuen Erfassung am 11.03.2026 mit data1.csv und config.json im Modus ingestion.

Vor der Erfassung

config.json
data1.csv
ingestion_history/
  └── 2026-03-06T04-20-17Z/
       ├── config.json
       ├── license_data.csv
       ├── csv_errors.csv
validation_history/
  └── 2026-03-11T05-18-14Z/
       ├── config.json
       ├── data1.csv
       ├── csv_errors.csv
  └── 2026-03-06T01-15-24Z/
       ├── config.json
       ├── license_data.csv
       ├── csv_errors.csv

Nach der Erfassung

ingestion_history/
  └── 2026-03-11T12-23-56Z/
       ├── config.json
       ├── data1.csv
  └── 2026-03-06T04-20-17Z/
       ├── config.json
       ├── license_data.csv
       ├── csv_errors.csv
validation_history/
  └── 2026-03-11T05-18-14Z/
       ├── config.json
       ├── data1.csv
       ├── csv_errors.csv
  └── 2026-03-06T01-15-24Z/
       ├── config.json
       ├── license_data.csv
       ├── csv_errors.csv

Um eine erneute Erfassung auszulösen, lade einfach wieder neue Dateien in dein Standardverzeichnis hoch.

Wichtige Hinweise

• Verarbeitungszeit: Nach dem Erfassen kann es bis zu einem Tag dauern, bis die Daten in Metas System angezeigt werden.