简介

在设有金融服务广告监管法规的国家/地区，Meta 可能会要求广告主验证身份和金融许可证。监管机构将向 Meta 提供金融许可证数据集，Meta 将依托该数据集验证广告主提交的许可证信息。本文档介绍了监管机构如何安全地与 Meta 分享许可证数据，以及集成所需的各项技术规范。

概览

集成的运作方式如下：

1. Meta 提供 SFTP 凭证 - Meta 将登录信息发送至监管机构的已验证邮箱。
2. 监管机构上传两个文件 - 一个 config.json（元数据）和一个 CSV 文件（许可证数据）将上传至 Meta 的安全 SFTP 服务器。下文附有文件上传操作指示。
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 必须唯一。
• 行级错误不会阻断整份文件的处理，有效数据行仍可正常引入。例如，如果 100,000 行数据中有 50 行存在错误，其余 99,950 行将会正常处理。

全量上传架构 (V1)

为杜绝 Meta 广告平台上出现冒充、欺诈和违规行为，必须开展主体关联核验。每条上传的金融许可证数据必须至少提供以下一项信息以供核验：电话号码、邮箱或网站网址。此举可确保尝试投放广告的广告主所使用的许可证与资质核验登记实体相关联。

增量上传架构 (V1)

增量上传架构与全量上传架构采用相同栏，还额外附加一个必要栏：

操作规则

• UPSERT - 新增许可证或更新现有许可证。遵循与全量上传架构相同的必要/非必要字段规则。
• DELETE - 移除许可证。仅 Credential_Id 为必要字段，其他所有字段均为非必要字段。

增量上传场景示例

初始数据集包含三个许可证：A、B、C。

后续发生以下变更：

• 更新许可证 B 信息。
• 删除许可证 C。
• 新增许可证 D。

增量 CSV 文件将包含：

许可证 A 未包含在内，因为它没有任何变更。

上次引入数据集的时间戳可通过 SFTP 上的 ingestion_history/ 文件夹获取（参见下文）。

SFTP 上传和引入流程

如何上传

1. 使用 Meta 提供的凭证登录 SFTP 服务器。
2. 将 config.json 和您的 CSV 数据文件上传至您的默认目录。
3. 等待处理。您可通过配置 config.json 中的 validation 模式，每天多次验证文件，但数据引入每天仅执行一次。

上传后会怎样

• 处理完成后，这两个文件将自动移动至 validation_history/ 或 ingestion_history/ 目录，具体取决于 config.json 中配置的模式。如果上传的 CSV 文件包含任何行级错误，例如缺少必要值或包含无效值，系统将生成一个单独的 CSV 文件来详细列出这些错误。在执行引入操作前，请使用 validation 模式确认文件能得到正确处理。
• 每次运行都会创建一个带时间戳的文件夹（例如 2026-03-11T12-23-56Z/），其中包含记录目录中使用的确切文件。
• 如果您的文件仍位于默认目录中（而非 ingestion_history/ 或 validation_history/），则表示系统尚未启动处理。
• 留存：SFTP 服务器文件仅留存 30 天。

示例：引入前与引入后

以下为 2026 年 3 月 11 日新引入前后的文件目录结构，包含 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

如要触发其他引入，请再次上传新文件至默认目录。

重要提示

• 处理时间：数据引入后可能需要最多 1 天才能显示在 Meta 的系统中。