Введение

В странах, где действует законодательство в отношении рекламы финансовых услуг, Meta может требовать от рекламодателей подтверждать свою личность и финансовую лицензию. Регуляторы предоставляют Meta данные о финансовых лицензиях для проверки лицензий рекламодателей. В этом документе описывается, как регуляторы могут безопасно передавать Meta данные о лицензиях, а также приводятся технические требования для интеграции.

Обзор

Интеграция работает следующим образом:

1. Meta предоставляет учетные данные для входа в SFTP. Данные отправляются на подтвержденный электронный адрес регулятора.
2. Регулятор загружает два файла. Файл config.json (метаданные) и файл CSV (данные о лицензии) загружаются на защищенный сервер SFTP Meta. Инструкции по загрузке файлов.
3. Meta обрабатывает данные. Обработка файлов выполняется периодически.
4. Регуляторы загружают файлы согласно расписанию. Обновленные файлы загружаются еженедельно.

Что такое файл config.json?

Файл config.json — это манифест, содержащий метаданные, необходимые для обработки. Он должен быть включен в каждую загрузку.

Поля

Пример

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

Данные о лицензии (CSV)

Данные о лицензиях предоставляются в виде файла CSV. Файл может иметь любое имя. Существует два типа загрузки:

• Полная загрузка — содержит полный набор данных о лицензиях.
• Частичная загрузка — содержит только изменения с момента последней загрузки.

Общие правила

• Заголовки столбцов должны быть в первой строке.
• Все заголовки столбцов должны быть уникальными.
• Все обязательные столбцы должны быть заполнены.
• Для каждой строки должно быть задано уникальное значение столбца Credential_Id.
• Ошибки на уровне строк не блокируют весь файл. В этом случае будут обработаны действительные строки. Например, если 50 из 100 000 строк содержат ошибки, то оставшиеся 99 950 строк будут обработаны как обычно.

Схема полной загрузки (V1)

Проверка подключения позволяет предотвратить попытки выдать себя за другое лицо, мошенничество и другие нарушения на рекламных платформах Meta. Для проведения проверки в загруженных данных о финансовой лицензии должен быть хотя бы один из следующих пунктов: номера телефонов, электронные адреса или URL сайтов. Это гарантирует, что рекламодатель использует лицензию, связанную с организацией, проходящей подтверждение.

Схема частичной загрузки (V1)

В этой схеме используются те же столбцы, что и в схеме полной загрузки, и ещё один обязательный:

Правила для операций

• UPSERT — добавление новой лицензии или обновление существующей. Используются те же правила в отношении обязательных и необязательных полей, что и в схеме полной загрузки.
• DELETE — удаление лицензии. Обязательно только поле Credential_Id. Все остальные поля заполняются по желанию.

Пример сценария частичной загрузки данных

Исходный набор данных содержит три лицензии: A, B и C.

Затем происходят следующие изменения:

• Обновлена лицензия B.
• Удалена лицензия С.
• Добавлена лицензия D.

Файл CSV с частичными изменениями будет содержать следующие данные:

Лицензия А не включена, поскольку в ней не было изменений.

Метка времени последнего обработанного набора данных доступна в папке ingestion_history/ в SFTP (см. ниже).

Процесс загрузки и обработки файлов в SFTP

Как загрузить файл?

1. Войдите на сервер SFTP, используя предоставленные Meta учетные данные.
2. Загрузите файл config.json и файл CSV с данными в ваш каталог по умолчанию.
3. Обработка начнется через некоторое время. Файлы могут проходить проверку несколько раз в день, если задан режим validation в файле config.json, но данные обрабатываются только один раз в день.

Что происходит после загрузки?

• После обработки оба файла автоматически перемещаются в каталог validation_history/ или ingestion_history/, в зависимости от режима, заданного в файле config.json. Если загруженный файл CSV содержит ошибки на уровне строк, например недействительные значения или недостающие обязательные значения, генерируется отдельный файл CSV с информацией об этих ошибках. Перед обработкой задайте режим validation, чтобы убедиться, что ваши файлы будут обработаны правильно.
• При каждом запуске процесса создается папка с меткой времени (например, 2026-03-11T12-23-56Z/). Она содержит те файлы, которые используются в каталоге истории действий.
• Если ваши файлы остались в каталоге по умолчанию (не в ingestion_history/ или validation_history/), значит они ещё не обработаны.
• Хранение. Сервер SFTP хранит файлы только в течение 30 дней.

Пример: до и после обработки

Ниже показана структура файлов до и после обработки новых файлов 11 марта 2026 года — data1.csv и config.json с режимом ingestion.

До обработки

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

После обработки

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

Чтобы инициировать ещё одну операцию обработки, загрузите новые файлы в каталог по умолчанию.

Важные примечания

• Время обработки. Чтобы новые данные появились в системе Meta, после обработки может потребоваться до 1 дня.