การมอบใบอนุญาตโฆษณาทางการเงิน

ข้อมูลเบื้องต้น

ในประเทศที่มีระเบียบข้อบังคับเกี่ยวกับการโฆษณาบริการทางการเงิน Meta อาจกำหนดให้ผู้ลงโฆษณาตรวจสอบยืนยันข้อมูลระบุตัวตนและใบอนุญาตทางการเงินของตน หน่วยงานกำกับดูแลจะให้ชุดข้อมูลใบอนุญาตทางการเงินแก่ Meta ซึ่ง Meta จะใช้ในการตรวจสอบความถูกต้องของใบอนุญาตที่ผู้ลงโฆษณาส่งเข้ามา เอกสารนี้จะอธิบายวิธีที่หน่วยงานกำกับดูแลแชร์ข้อมูลใบอนุญาตกับ Meta อย่างปลอดภัย รวมถึงข้อมูลจำเพาะทางเทคนิคสำหรับการผสานการทำงาน

ภาพรวม

การผสานการทำงานมีการทำงานดังต่อไปนี้

  1. Meta มอบข้อมูลประจำตัวของ SFTP - Meta ส่งรายละเอียดการเข้าสู่ระบบไปยังอีเมลที่ได้รับการยืนยันของหน่วยงานกำกับดูแล
  2. หน่วยงานกำกับดูแลอัพโหลดไฟล์ 2 รายการ - อัพโหลด config.json (เมตาดาต้า) และไฟล์ CSV (ข้อมูลใบอนุญาต) ไปยังเซิร์ฟเวอร์ SFTP ที่ปลอดภัยของ Meta คำแนะนำในการอัพโหลดไฟล์
  3. Meta นำเข้าข้อมูล - ไฟล์จะได้รับการประมวลผลเป็นระยะ
  4. หน่วยงานกำกับดูแลอัพโหลดเป็นประจำ - หน่วยงานกำกับดูแลมีหน้าที่อัพโหลดไฟล์ที่อัพเดตแล้วเป็นประจำทุกสัปดาห์

config.json คืออะไร

ไฟล์ config.json คือไฟล์กำกับที่มีเมตาดาต้าที่จำเป็นสำหรับการประมวลผล ต้องมีไฟล์นี้ในทุกการอัพโหลด

ช่อง

ช่องประเภทต้องระบุคำอธิบายค่าที่อนุญาต

version

สตริง

ใช่

เวอร์ชั่นสกีมาที่ใช้สำหรับไฟล์ CSV ใบอนุญาต

"v1"

load_type

สตริง

ใช่

ระบุว่าเป็นชุดข้อมูลแบบเต็มหรือการอัพเดตที่เพิ่มขึ้น (เดลต้าเท่านั้น)

"full", "incremental"

mode

สตริง

ใช่

  • การตรวจสอบความถูกต้อง: ไฟล์ CSV จะถูกตรวจสอบความถูกต้องและความสมบูรณ์ แต่ไม่ได้นำเข้าข้อมูล
  • การนำเข้า: ไฟล์ CSV จะถูกตรวจสอบความถูกต้อง (ใช้การตรวจสอบเดียวกันกับโหมดการตรวจสอบความถูกต้อง) จากนั้นจะนำเข้าไปยังไปป์ไลน์

"validation", "ingestion"

support_email_addresses

อาร์เรย์ของสตริง

ใช่

อีเมลที่ได้รับการติดตามซึ่ง Meta สามารถใช้ติดต่อเกี่ยวกับการนำเข้าข้อมูลได้

ตัวอย่าง

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

ข้อมูลใบอนุญาต (CSV)

ข้อมูลใบอนุญาตจะให้ไว้ในรูปแบบไฟล์ CSV โดยตั้งชื่อไฟล์อย่างไรก็ได้ มีโหลด 2 ประเภท ได้แก่

  • โหลดเต็ม - ประกอบด้วยชุดข้อมูลใบอนุญาตทั้งหมดอย่างสมบูรณ์
  • โหลดที่เพิ่มขึ้น - ประกอบด้วยการเปลี่ยนแปลง (เดลต้า) ตั้งแต่การอัพโหลดครั้งล่าสุดเท่านั้น

กฎทั่วไป

  • ส่วนหัวคอลัมน์ต้องอยู่ในแถวแรก
  • ส่วนหัวคอลัมน์ทั้งหมดต้องไม่ซ้ำกัน
  • ต้องมีคอลัมน์ที่จำเป็นทั้งหมด
  • แต่ละแถวต้องมี Credential_Id ที่ไม่ซ้ำกัน
  • ข้อผิดพลาดระดับแถวจะไม่บล็อกไฟล์ทั้งไฟล์ แถวที่ข้อมูลถูกต้องยังคงได้รับการนำเข้า เช่น หากมีแถว 50 จาก 100,000 แถวพบข้อผิดพลาด แถวที่เหลืออีก 99,950 แถวจะได้รับการประมวลผลตามปกติ

สกีมาโหลดเต็ม (V1)

คอลัมน์ต้องระบุประเภทคำอธิบายรูปแบบ/ค่าที่อนุญาตตัวอย่าง

Credential_Id

ใช่

สตริง

ตัวระบุที่ไม่ซ้ำกันสำหรับใบอนุญาต แสดงในโฆษณาบริการทางการเงินที่เผยแพร่

อักขระสูงสุด 200 ตัว

123456789

License_Status

ใช่

สตริง

สถานะของใบอนุญาต

ACTIVE, INACTIVE, LEGALLY_EXEMPT

ACTIVE

Licensee_Name

ใช่

สตริง

ชื่อที่ใช้จดทะเบียนใบอนุญาต

อักขระสูงสุด 200 ตัว

Jane Doe

Licensee_Type

ใช่

สตริง

ประเภทของหน่วยงานผู้ถือใบอนุญาต

INDIVIDUAL, FIRM, UNKNOWN*

INDIVIDUAL

License_Expiration_Date

ไม่ใช่

ตัวเลข

วันหมดอายุของใบอนุญาต

ประทับเวลา Unix

946684800

Address_Line_1

ไม่ใช่

สตริง

ที่อยู่หลัก

อักขระสูงสุด 200 ตัว

123 Main St

Address_Line_2

ไม่ใช่

สตริง

ที่อยู่รอง

อักขระสูงสุด 200 ตัว

Suite 100

City

ไม่ใช่

สตริง

เมือง ท้องถิ่น เมืองย่อย หรือเขตเทศบาล

อักขระสูงสุด 200 ตัว

San Francisco

State

ไม่ใช่

สตริง

รัฐ จังหวัด เขตปกครอง เทศมณฑล หรือภูมิภาค

อักขระสูงสุด 200 ตัว

CA

Country_Code

ไม่ใช่

สตริง

ประเทศของผู้รับใบอนุญาต

ISO 3166-1 alpha-2 (อักขระสูงสุด 2 ตัว)

US

Postal_Code

ไม่ใช่

สตริง

รหัสไปรษณีย์

อักขระสูงสุด 12 ตัว

94016

Phone_Numbers

ต้องระบุอย่างน้อย 1 อย่างจากรายการเหล่านี้: Phone_Numbers, Email_Addresses หรือ Website_URLs

สตริง

หมายเลขโทรศัพท์ที่ลงทะเบียนไว้กับใบอนุญาต

คั่นด้วยเครื่องหมายอัฒภาค, รูปแบบ E.164, อักขระสูงสุด 16 ตัวต่อหมายเลข (รวมเครื่องหมาย + ด้วย)

+15551234567;+15559876543

Email_Addresses

ต้องระบุอย่างน้อย 1 อย่างจากรายการเหล่านี้: Phone_Numbers, Email_Addresses หรือ Website_URLs

สตริง

อีเมลที่ลงทะเบียนไว้กับใบอนุญาต

คั่นด้วยเครื่องหมายอัฒภาค, อักขระสูงสุด 254 ตัวต่ออีเมล

jane.doe@gmail.com;info@firm.com

Website_URLs

ต้องระบุอย่างน้อย 1 อย่างจากรายการเหล่านี้: Phone_Numbers, Email_Addresses หรือ Website_URLs

สตริง

เว็บไซต์ที่ลงทะเบียนไว้กับใบอนุญาต ต้องขึ้นต้นด้วย "http://" หรือ "https://"

คั่นด้วยเครื่องหมายอัฒภาค, อักขระสูงสุด 2,000 ตัวต่อเว็บไซต์

https://www.example.com;https://www.example2.com

เพื่อป้องกันการแอบอ้าง การฉ้อโกง และการใช้งานในทางที่ผิดบนแพลตฟอร์มการโฆษณาของ Meta ระบบจึงจำเป็นต้องมีการตรวจสอบการเชื่อมต่อ ข้อมูลใบอนุญาตทางการเงินที่อัพโหลดจะต้องระบุข้อมูลต่อไปนี้อย่างน้อย 1 รายการต่อใบอนุญาตแต่ละใบ: หมายเลขโทรศัพท์ อีเมล หรือ URL เว็บไซต์ เพื่อดำเนินการตรวจสอบดังกล่าว วิธีนี้จะช่วยให้แน่ใจว่าผู้ลงโฆษณาที่กำลังพยายามโฆษณาได้ใช้ใบอนุญาตที่เชื่อมโยงกับหน่วยงานที่อยู่ในการตรวจสอบยืนยัน

สกีมาที่เพิ่มขึ้น (V1)

สกีมาที่เพิ่มขึ้นจะใช้คอลัมน์เดียวกันกับสกีมาโหลดเต็ม และมีคอลัมน์ที่จำเป็นเพิ่มเติมอีก 1 คอลัมน์

คอลัมน์ต้องระบุประเภทคำอธิบายค่าที่อนุญาต

Operation

ใช่

สตริง

การดำเนินการที่จะทำในแถวนี้

UPSERT, DELETE

กฎการดำเนินการ

  • UPSERT - เพิ่มใบอนุญาตรายการใหม่หรืออัพเดตใบอนุญาตที่มีอยู่ โดยเป็นไปตามกฎของช่องที่จำเป็น/ช่องที่ระบุหรือไม่ก็ได้แบบเดียวกับสกีมาโหลดเต็ม
  • DELETE - ลบใบอนุญาตออก เฉพาะ Credential_Id เท่านั้นที่จำเป็น ช่องอื่นๆ จะระบุหรือไม่ก็ได้

ตัวอย่างสถานการณ์โหลดที่เพิ่มขึ้น

ชุดข้อมูลเริ่มต้นประกอบด้วยใบอนุญาต 3 รายการ ได้แก่ A, B, C

หลังจากนั้นเกิดการเปลี่ยนแปลงดังต่อไปนี้

  • ใบอนุญาต B ได้รับการอัพเดต
  • ใบอนุญาต C ถูกลบ
  • ใบอนุญาต D ได้รับการเพิ่มเข้ามา

CSV ที่เพิ่มขึ้นจะประกอบด้วยรายการดังนี้

Credential_Idการดำเนินการ...

B

UPSERT

(ช่องอื่นๆ)

C

DELETE

D

UPSERT

(ช่องอื่นๆ)

ใบอนุญาต A ไม่รวมอยู่ด้วยเนื่องจากไม่มีการเปลี่ยนแปลง

ประทับเวลาของชุดข้อมูลที่นำเข้าล่าสุดของคุณสามารถดูได้ผ่านโฟลเดอร์ ingestion_history/ บน SFTP (ดูด้านล่าง)

กระบวนการอัพโหลดและนำเข้า SFTP

วิธีอัพโหลด

  1. เข้าสู่ระบบเซิร์ฟเวอร์ SFTP โดยใช้ข้อมูลประจำตัวที่ Meta ให้มา
  2. อัพโหลดทั้ง config.json และไฟล์ข้อมูล CSV ไปยังไดเรกทอรีเริ่มต้นของคุณ
  3. รอการประมวลผล การตรวจสอบความถูกต้องของไฟล์สามารถทำได้หลายครั้งต่อวันโดยใช้โหมด validation ใน config.json แต่การนำเข้าข้อมูลจะทำได้วันละครั้งเท่านั้น

สิ่งที่จะเกิดขึ้นหลังจากอัพโหลด

  • หลังจากประมวลผลแล้ว ทั้งสองไฟล์จะถูกย้ายโดยอัตโนมัติไปยังไดเรกทอรี validation_history/ หรือ ingestion_history/ โดยขึ้นอยู่กับโหมดที่ตั้งค่าไว้ใน config.json หากไฟล์ CSV ที่อัพโหลดมีข้อผิดพลาดระดับแถว เช่น ค่าที่จำเป็นขาดหายไปหรือมีค่าที่ไม่ถูกต้อง ระบบจะสร้างไฟล์ CSV แยกต่างหากที่แสดงรายละเอียดข้อผิดพลาดเหล่านั้น ก่อนการนำเข้า ให้ใช้โหมด validation เพื่อยืนยันว่าไฟล์ของคุณจะได้รับการประมวลผลอย่างถูกต้อง
  • การเรียกใช้แต่ละครั้งจะสร้างโฟลเดอร์ที่ประทับเวลา (เช่น 2026-03-11T12-23-56Z/) ซึ่งจะมีไฟล์ที่ใช้ในไดเรกทอรีประวัติ
  • หากไฟล์ของคุณยังอยู่ในไดเรกทอรีเริ่มต้น (ไม่อยู่ใน ingestion_history/ หรือ validation_history/) แสดงว่ายังไม่มีการประมวลผลเกิดขึ้น
  • การเก็บรักษา: เซิร์ฟเวอร์ SFTP จะเก็บรักษาไฟล์ไว้เป็นเวลา 30 วันเท่านั้น

ตัวอย่าง: ก่อนและหลังการนำเข้า

ด้านล่างนี้แสดงให้เห็นโครงสร้างไฟล์ก่อนและหลังการนำเข้าใหม่ในวันที่ 11/03/26 ซึ่งเกี่ยวข้องกับ 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 หลังจากการนำเข้า