Giới thiệu

Tại các quốc gia có quy định về quảng cáo dịch vụ tài chính, Meta có thể yêu cầu nhà quảng cáo xác minh danh tính và giấy phép tài chính của họ. Cơ quan quản lý sẽ cung cấp cho Meta một tập dữ liệu gồm các giấy phép tài chính mà Meta sử dụng để xác thực giấy phép do nhà quảng cáo gửi. Tài liệu này trình bày cách cơ quan quản lý chia sẻ dữ liệu giấy phép với Meta một cách an toàn và các quy cách kỹ thuật để tích hợp.

Tổng quan

Quy trình tích hợp như sau:

1. Meta cung cấp thông tin đăng nhập SFTP - Meta gửi các chi tiết đăng nhập đến địa chỉ email đã được xác nhận của cơ quan quản lý.
2. Cơ quan quản lý tải 2 file lên - config.json (siêu dữ liệu) và file CSV (dữ liệu giấy phép) được tải lên máy chủ SFTP an toàn của Meta. Hướng dẫn tải file lên.
3. Meta nhập dữ liệu - Hệ thống xử lý file theo định kỳ.
4. Cơ quan quản lý thường xuyên tải lên - Cơ quan quản lý có trách nhiệm thường xuyên tải lên các file được cập nhật hàng tuần.

File config.json là gì?

File config.json là bản kê khai chứa siêu dữ liệu cần thiết cho quá trình xử lý, đồng thời phải có trong mỗi lần tải lên.

Các trường

Ví dụ

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

Dữ liệu giấy phép (CSV)

Dữ liệu giấy phép được cung cấp dưới dạng file CSV. File có thể dùng tên bất kỳ. Có 2 kiểu tải dữ liệu:

• Tải đầy đủ - Chứa toàn bộ tập dữ liệu gồm mọi giấy phép.
• Tải tăng dần - Chỉ chứa những thay đổi (delta) kể từ lần tải lên gần nhất.

Quy tắc chung

• Tiêu đề cột phải ở hàng đầu tiên.
• Mọi tiêu đề cột đều phải là duy nhất.
• Phải có mọi cột bắt buộc.
• Mỗi hàng phải có một Credential_Id duy nhất.
• Lỗi ở cấp độ hàng không chặn toàn bộ file. Hệ thống vẫn nhập các hàng hợp lệ. Ví dụ: Nếu 50/100.000 hàng có lỗi thì hệ thống vẫn xử lý bình thường đối với 99.950 hàng còn lại.

Lược đồ tải đầy đủ (Phiên bản 1)

Nhằm ngăn chặn hành vi mạo danh, gian lận và lạm dụng trên các nền tảng quảng cáo của Meta, bước kiểm tra kết nối là rất cần thiết. Để thực hiện quy trình kiểm tra này, dữ liệu giấy phép tài chính được tải lên phải cung cấp ít nhất một trong những thông tin sau đây cho từng giấy phép: số điện thoại, địa chỉ email hoặc URL trang web. Điều này nhằm đảm bảo rằng nhà quảng cáo đang sử dụng giấy phép gắn liền với thực thể đó trong quá trình xác minh.

Lược đồ tăng dần (Phiên bản 1)

Lược đồ tăng dần sử dụng cùng các cột như lược đồ tải đầy đủ, cộng thêm một cột bắt buộc khác:

Quy tắc vận hành

• THÊM MỚI/CẬP NHẬT - Thêm giấy phép mới hoặc cập nhật giấy phép hiện có. Tuân theo cùng quy tắc về trường bắt buộc/không bắt buộc như lược đồ tải đầy đủ.
• XÓA - Gỡ giấy phép. Chỉ nhất định phải có Credential_Id, còn những trường khác là không bắt buộc.

Ví dụ về trường hợp tải tăng dần

Tập dữ liệu ban đầu chứa 3 giấy phép: A, B, C.

Sau đó, các thay đổi sau đây sẽ diễn ra:

• Cập nhật giấy phép B.
• Xóa giấy phép C.
• Thêm giấy phép D.

File CSV tăng dần sẽ chứa:

Hệ thống không bao gồm giấy phép A vì giấy phép này không có gì thay đổi.

Dấu thời gian của tập dữ liệu đã nhập mới đây nhất có sẵn thông qua thư mục ingestion_history/ trên SFTP (xem bên dưới).

Quy trình thu thập và tải lên SFTP

Cách tải lên

1. Đăng nhập vào máy chủ SFTP bằng thông tin đăng nhập mà Meta cung cấp.
2. Tải cả config.json lẫn file dữ liệu CSV lên thư mục mặc định của bạn.
3. Chờ hệ thống xử lý. Bạn có thể xác thực file vài lần một ngày bằng chế độ validation trong config.json, nhưng chỉ có thể nhập dữ liệu một lần mỗi ngày.

Những gì sẽ xảy ra sau quá trình tải lên

• Sau khi xử lý, hệ thống sẽ tự động chuyển cả 2 file sang thư mục validation_history/ hoặc ingestion_history/, tùy vào chế độ đã thiết lập trong config.json. Nếu file CSV đã tải lên chứa bất kỳ lỗi nào ở cấp độ hàng (chẳng hạn như thiếu giá trị bắt buộc hoặc giá trị không hợp lệ), hệ thống sẽ tạo một file CSV riêng để nêu chi tiết những lỗi đó. Trước khi tiến hành quy trình nhập, hãy sử dụng chế độ validation để xác nhận rằng hệ thống sẽ xử lý file của bạn một cách chính xác.
• Đối với mỗi lượt chạy, hệ thống sẽ tạo một thư mục có mốc thời gian (ví dụ: 2026-03-11T12-23-56Z/) chứa chính xác các file đã dùng trong thư mục lịch sử.
• Nếu file vẫn nằm trong thư mục mặc định (không phải trong ingestion_history/ hoặc validation_history/) thì có nghĩa là hệ thống chưa xử lý file đó.
• Lưu giữ: Máy chủ SFTP chỉ lưu giữ file trong 30 ngày.

Ví dụ: Trước và sau khi nhập

Dưới đây là hình ảnh minh họa cấu trúc file trước và sau lần nhập mới vào ngày 11/03/2026 liên quan đến data1.csv và config.json ở chế độ ingestion.

Trước khi nhập

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

Sau khi nhập

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

Để kích hoạt một lượt nhập khác, hãy tải lại file mới lên thư mục mặc định của bạn.

Lưu ý quan trọng

• Thời gian xử lý: Sau khi nhập, hệ thống có thể cần tối đa 1 ngày để hiển thị dữ liệu trong hệ thống của Meta.