引言

在設有金融服務廣告法規的國家／地區，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 為必填欄位，其他所有欄位均為選填欄位。

增幅載入情境範例

初始資料集包含 3 個牌照：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 的系統中。