簡介

在制定有金融服務廣告法規的國家／地區，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 系統中。