Pendahuluan

Di negara-negara yang memiliki peraturan mengenai iklan layanan keuangan, Meta mungkin mengharuskan pengiklan untuk memverifikasi identitas dan lisensi keuangan mereka. Regulator akan memberikan set data lisensi keuangan kepada Meta, yang akan digunakan oleh Meta untuk memvalidasi lisensi yang dikirimkan oleh pengiklan. Dokumen ini membahas cara regulator membagikan data lisensi secara aman kepada Meta dan spesifikasi teknis terkait integrasi.

Gambaran Umum

Berikut adalah cara kerja integrasi ini:

1. Meta menyediakan kredensial SFTP - Meta mengirimkan detail login ke alamat email regulator yang telah dikonfirmasi.
2. Regulator mengunggah dua file - config.json (metadata) dan file CSV (data lisensi) diunggah ke server SFTP Meta yang aman. Petunjuk pengunggahan file.
3. Meta mengelola data - File diproses secara berkala.
4. Regulator mengunggah secara berkala - Regulator bertanggung jawab mengunggah secara berkala file yang diperbarui setiap minggu.

Apa itu config.json?

File config.json adalah manifes yang berisi metadata yang diperlukan untuk pemrosesan. File ini harus disertakan pada setiap unggahan.

Kolom

Contoh

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

Data Lisensi (CSV)

Data lisensi disediakan dalam bentuk file CSV. Tidak ada ketentuan mengenai pemberian nama file. Ada dua jenis muatan:

• Muatan Penuh - Berisi set lengkap semua data lisensi.
• Muatan Inkremental - Hanya berisi perubahan (delta) sejak unggahan terakhir.

Aturan Umum

• Header kolom harus berada di baris pertama.
• Semua header kolom harus unik.
• Semua kolom wajib harus ada.
• Setiap baris harus memiliki Credential_Id yang unik.
• Kesalahan level baris tidak memblokir seluruh file. Pemrosesan tetap dilakukan untuk baris yang valid. Misalnya, jika 50 dari 100.000 baris memiliki kesalahan, 99.950 baris lainnya tetap diproses secara normal.

Skema Muatan Penuh (V1)

Pemeriksaan koneksi penting untuk mencegah penyamaran, penipuan, dan penyalahgunaan di platform iklan Meta. Data lisensi keuangan yang diunggah harus mencantumkan setidaknya salah satu informasi berikut untuk setiap lisensi: nomor telepon, alamat email, atau URL situs web untuk melakukan pemeriksaan ini. Hal ini memastikan bahwa pengiklan yang mencoba beriklan menggunakan lisensi yang terhubung dengan entitas dalam verifikasi.

Skema Inkremental (V1)

Skema inkremental menggunakan kolom yang sama dengan skema muatan penuh, tetapi disertai dengan satu kolom wajib tambahan:

Aturan Operasi

• UPSERT - Menambahkan lisensi baru atau memperbarui lisensi yang ada. Mengikuti aturan kolom wajib/opsional yang sama dengan skema muatan penuh.
• DELETE - Menghapus lisensi. Hanya kolom Credential_Id yang wajib diisi; semua kolom lainnya opsional.

Contoh Skenario Muatan Inkremental

Set data awal berisi tiga lisensi: A, B, C.

Perubahan berikut akan terjadi setelahnya:

• Lisensi B diperbarui.
• Lisensi C dihapus.
• Lisensi D ditambahkan.

CSV inkremental akan berisi:

Lisensi A tidak disertakan karena tidak memiliki perubahan.

Cap waktu untuk set data Anda yang terakhir kali diproses tersedia melalui folder ingestion_history/ di SFTP (lihat di bawah).

Proses Pengunggahan & Pemrosesan SFTP

Cara Mengunggah

1. Login ke server SFTP menggunakan kredensial yang disediakan Meta.
2. Unggah config.json dan file data CSV ke direktori default Anda.
3. Tunggu pemrosesan. File bisa divalidasi beberapa kali sehari menggunakan mode validation di config.json, tetapi data hanya bisa diproses sekali sehari.

Yang Terjadi setelah Pengunggahan

• Setelah diproses, kedua file otomatis dipindahkan ke direktori validation_history/ atau ingestion_history/, tergantung mode yang diatur di config.json. Jika file CSV yang diunggah berisi kesalahan level baris, seperti nilai yang wajib diisi tidak ada atau nilai tidak valid, file CSV terpisah yang berisi perincian kesalahan tersebut akan dibuat. Sebelum melakukan pemrosesan, gunakan mode validation untuk mengonfirmasi bahwa file Anda akan diproses dengan benar.
• Untuk setiap operasi yang dilakukan, folder disertai cap waktu akan dibuat (misalnya 2026-03-11T12-23-56Z/) yang berisi file-file yang benar-benar digunakan dalam direktori riwayat.
• Jika file Anda masih ada di direktori default (bukan di ingestion_history/ atau validation_history/), artinya pemrosesan belum dilakukan.
• Retensi: Server SFTP hanya menyimpan file selama 30 hari.

Contoh: Sebelum & Sesudah Pemrosesan

Berikut adalah ilustrasi struktur file sebelum dan sesudah pemrosesan baru pada 11/3/26 yang melibatkan data1.csv dan config.json dengan mode ingestion.

Sebelum Pemrosesan

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

Setelah Pemrosesan

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

Untuk memicu pemrosesan lainnya, unggah file baru ke direktori default Anda lagi.

Catatan Penting

• Waktu pemrosesan: Data mungkin perlu waktu hingga 1 hari untuk muncul di sistem Meta setelah pemrosesan.