วิธีใช้ Facebook (Meta) Ad Library API

Facebook/Meta Ad Library API ที่เรากล่าวถึงในชื่อ Facebook Ad Library API คืออินเทอร์เฟซสาธารณะที่ให้นักพัฒนาสามารถเข้าถึงโฆษณาที่เผยแพร่บน Facebook, Instagram และแพลตฟอร์มอื่นๆ ที่ Meta เป็นเจ้าของ (เช่น Whatsapp และ Threads) ผ่าน API นี้ คุณสามารถค้นหาโฆษณาตามคำสำคัญ, ID เพจ, ประเทศ หรือประเภทโฆษณา และดึงข้อมูลเมตาต่างๆ เช่น ชิ้นงานโฆษณา, ช่วงการใช้จ่าย, การแสดงผล, แพลตฟอร์มผู้เผยแพร่ และอื่นๆ อีกมากมาย

API นี้มีประโยชน์อย่างยิ่งสำหรับการวิจัยด้านความโปร่งใส, การตรวจสอบการตลาด, การวิเคราะห์คู่แข่ง, การวิเคราะห์ชิ้นงานโฆษณา หรือการสร้างเครื่องมือที่เกี่ยวข้องกับข้อมูลโฆษณาบนโซเชียลมีเดีย ไม่ว่าคุณต้องการจะติดตามโฆษณาที่กำลังทำงานอยู่, ศึกษาโฆษณาที่เกี่ยวข้องกับการเมืองหรือประเด็นทางสังคม (SIEP ads) หรือวิเคราะห์กลยุทธ์ทางการตลาด Facebook Ad Library API มอบช่องทางที่ทรงพลังในการเข้าถึงข้อมูลโฆษณา

ทำไมถึงใช้ Facebook Ad Library API และคุณสามารถทำอะไรได้บ้าง?

ความสามารถหลักบางประการของ Facebook Ad Library API:

1. ค้นหาด้วยคำสำคัญ, ID เพจ, ประเทศ, ประเภทโฆษณา — คุณสามารถจำกัดขอบเขตของโฆษณาตามเนื้อหา, ผู้ลงโฆษณา, สถานที่เผยแพร่ และประเภทของแคมเปญ
2. กรองตามสถานะ: ใช้งานอยู่/ไม่ใช้งาน, ช่วงการใช้จ่าย, การแสดงผล — มีประโยชน์เมื่อคุณต้องการเฉพาะโฆษณาที่กำลังทำงานอยู่ หรือโฆษณาที่ใช้งบประมาณสูง/ต่ำกว่าเกณฑ์ที่กำหนด
3. ดึงข้อมูลเมตาของโฆษณา — รวมถึงฟิลด์ต่างๆ เช่น page_name, ad_snapshot_url, spend, impressions, publisher_platforms (Facebook/Instagram) และอื่นๆ
4. รองรับการครอบคลุมข้อมูลในระยะยาวและกว้างขวาง — เช่น ทั่วโลกสำหรับโฆษณา SIEP และสำหรับหลายภูมิภาคสำหรับโฆษณาทั่วไป (ขึ้นอยู่กับนโยบายภูมิภาคของ Meta ณ ปี 2025)
5. เข้าถึงข้อมูลสาธารณะได้ฟรี — ไม่มีค่าใช้จ่ายล่วงหน้าสำหรับการดึงข้อมูลโฆษณาสาธารณะ ตราบใดที่คุณมีการตั้งค่าการเข้าถึงที่เหมาะสม

สรุปคือ — API มอบวิธีการที่มีโครงสร้างและสามารถตั้งโปรแกรมได้ เพื่อสำรวจและรวบรวมข้อมูลโฆษณาในวงกว้าง

คู่มือทีละขั้นตอน: วิธีเริ่มต้นใช้งาน Facebook Ad Library API

ขั้นตอนที่ 1: ยืนยันบัญชี Facebook/Meta และตัวตนของคุณ

• เข้าสู่ระบบ/สร้างบัญชี Facebook ของคุณ (ส่วนตัวหรือธุรกิจ)
• ตรวจสอบให้แน่ใจว่าบัญชีของคุณได้รับการยืนยันแล้ว (บางครั้ง Meta กำหนดให้มีการยืนยันตัวตนเพื่อเข้าถึง API) (การยืนยันบัญชี)
• ขั้นตอนนี้สำคัญโดยเฉพาะอย่างยิ่งหากคุณวางแผนที่จะขอสิทธิ์เข้าถึงข้อมูล Ad Library ผ่านแอปพลิเคชัน

ขั้นตอนที่ 2: ลงทะเบียนแอป Meta Developer

• ไปที่ Meta for Developers → “เริ่มต้นใช้งาน” และเข้าสู่ระบบแพลตฟอร์ม (คลิกที่นี่)

• สร้างแอปใหม่: เลือก “อื่นๆ” หรือประเภททั่วไป หากคุณไม่ได้โฆษณา

• เลือกที่คุณต้องการเข้าถึง Marketing APIs / Ad-Library

• ในตอนแรก แอปจะอยู่ในโหมดการพัฒนา — ซึ่งเพียงพอสำหรับการทดสอบเบื้องต้นและการใช้งานขนาดเล็ก

ขั้นตอนที่ 3: สร้างโทเค็นการเข้าถึง

• ใช้ Graph API Explorer หรือเครื่องมือของ Meta เพื่อสร้างโทเค็นการเข้าถึงของผู้ใช้
• ตรวจสอบให้แน่ใจว่าโทเค็นมีสิทธิ์ที่จำเป็น (เช่น ads_read, อาจเป็น ads_archive หรืออื่นๆ ขึ้นอยู่กับข้อกำหนดของ Meta) (Facebook for Developers)

หมายเหตุ: โทเค็นการเข้าถึงจะหมดอายุ; คุณอาจต้องขยายเวลาหรือสร้างโทเค็นที่มีอายุการใช้งานยาวนานขึ้นอยู่กับการใช้งานของคุณ

ขั้นตอนที่ 4: ทำการเรียกใช้ API ครั้งแรกของคุณ

คุณสามารถคิวรีปลายทาง /ads_archive (รากของ Ad Library API) ได้ ใช้เวอร์ชัน API ล่าสุด (เช่น v23.0 หรือใหม่กว่า) (Facebook for Developers)

ตัวอย่าง: การใช้ curl

curl -G \
  -d "search_terms=skincare" \
  -d "ad_reached_countries=['US']" \
  -d "ad_active_status=ACTIVE" \
  -d "fields=page_name,ad_snapshot_url,spend,impressions,publisher_platforms" \
  -d "access_token=YOUR_ACCESS_TOKEN" \
  "https://graph.facebook.com/v23.0/ads_archive"

ตัวอย่าง: การใช้ JavaScript (fetch)

const response = await fetch(
  `https://graph.facebook.com/v23.0/ads_archive?` +
  `search_terms=skincare&ad_reached_countries=['US']&ad_active_status=ACTIVE` +
  `&fields=page_name,spend,impressions,publisher_platforms` +
  `&access_token=YOUR_ACCESS_TOKEN`
);
const data = await response.json();
console.log(data);

การตอบกลับแบบ JSON จะประกอบด้วยอาร์เรย์ของอ็อบเจกต์โฆษณา โดยแต่ละอ็อบเจกต์จะมีข้อมูลเมตาเช่น page_name, ad_snapshot_url, ช่วงการใช้จ่าย, ช่วงการแสดงผล, แพลตฟอร์มผู้เผยแพร่ และอาจมีฟิลด์อื่นๆ เพิ่มเติม

ขั้นตอนที่ 5: การจัดการการแบ่งหน้า (Pagination) และผลลัพธ์ขนาดใหญ่

เนื่องจาก Ad Library อาจส่งคืนผลลัพธ์จำนวนมาก API จึงใช้การแบ่งหน้า (pagination) เตรียมพร้อมที่จะวนซ้ำผ่านหน้าถัดไป — ตรวจสอบการตอบกลับสำหรับ paging หรือโทเค็นเคอร์เซอร์ และวนซ้ำตามนั้น นักพัฒนามักจะสร้างลูปในโค้ดเพื่อรวบรวมชุดผลลัพธ์ขนาดใหญ่

ขั้นตอนที่ 6: กรณีการใช้งาน — คุณสามารถทำอะไรได้บ้างกับข้อมูลนี้?

นี่คือกรณีการใช้งานทั่วไป:

1. การวิเคราะห์คู่แข่ง — ดึงโฆษณาจากเพจ Facebook ของคู่แข่ง (ผ่าน ID เพจ) เพื่อศึกษาชิ้นงานโฆษณา, ประมาณการการใช้จ่าย หรือการเข้าถึงกลุ่มเป้าหมาย
2. การติดตามและวิจัยแนวโน้ม — ติดตามประเภทของโฆษณาที่กำลังทำงานอยู่ตามคำสำคัญ, ภูมิภาค, ประเภทสื่อ หรือประเภทโฆษณา (เช่น การเมือง, ที่อยู่อาศัย, ประเด็นทางสังคม)
3. แดชบอร์ดข้อมูลเชิงลึกทางการตลาด — รวบรวมข้อมูล (ช่วงการใช้จ่าย, การแสดงผล, ความถี่โฆษณา) และแสดงภาพข้อมูลตามช่วงเวลาหรือข้ามภูมิภาค
4. การวิเคราะห์/แรงบันดาลใจจากชิ้นงานโฆษณา — ดึงและจัดเก็บชิ้นงานโฆษณา (URL รูปภาพ/วิดีโอ) สำหรับแรงบันดาลใจในการพัฒนาผลิตภัณฑ์ หรือการตรวจสอบการปฏิบัติตามข้อกำหนด
5. การวิจัยเชิงวิชาการ/ความโปร่งใส — ใช้ข้อมูลโฆษณาสำหรับการศึกษาเกี่ยวกับการโฆษณาทางการเมือง, แคมเปญประเด็นทางสังคม หรือแนวโน้มตลาด

กรณีการใช้งานเหล่านี้เน้นย้ำถึงคุณค่าของการเข้าถึงข้อมูลโฆษณาในรูปแบบที่มีโครงสร้างและสามารถตั้งโปรแกรมได้

การทดสอบ Facebook Ad Library API ด้วย Apidog

ใช้ Apidog เป็นสนามทดสอบสำหรับ Facebook Ad Library API นี่คือวิธีการเริ่มต้นทดสอบ API ของคุณใน Apidog:

1. ใน Apidog สร้าง API endpoint ใหม่: ตั้งค่าเมธอดเป็น GET, URL เป็น https://graph.facebook.com/v23.0/ads_archive

2. ภายใต้พารามิเตอร์คิวรี เพิ่มพารามิเตอร์เช่น search_terms, ad_reached_countries, fields และ access_token

3. กด “Send” — Apidog จะดึงข้อมูลและแสดงการตอบกลับแบบ JSON ในรูปแบบที่มีโครงสร้าง

4. คุณสามารถทดลองใช้พารามิเตอร์หลายชุด, ทดสอบการแบ่งหน้า และแม้แต่บันทึกตัวอย่างการตอบกลับสำหรับเอกสารประกอบหรือการวิเคราะห์

วิธีการนี้มีประโยชน์อย่างยิ่งสำหรับการสำรวจข้อมูลโฆษณาอย่างรวดเร็ว, การทดสอบการค้นหา และการสร้างการเชื่อมโยงโดยไม่ต้องเขียนโค้ดทั้งหมด

คำถามที่พบบ่อย

คำถามที่ 1. ฉันจำเป็นต้องมีบัญชีโฆษณาพิเศษหรือบัญชีธุรกิจเพื่อใช้ Facebook Ad Library API หรือไม่?
ไม่ — บัญชี Meta ที่ได้รับการยืนยันมักจะเพียงพอ อย่างไรก็ตาม คุณต้องลงทะเบียน Meta Developer App และรับโทเค็นการเข้าถึงที่มีสิทธิ์ที่เหมาะสม (เช่น ads_read, ads_archive) ผู้ใช้บางรายจำเป็นต้องดำเนินการยืนยันตัวตนเพื่อเข้าถึงได้อย่างเต็มที่

คำถามที่ 2. ฉันสามารถรับข้อมูลสำหรับโฆษณาใดก็ได้ (ไม่ใช่แค่โฆษณาทางการเมืองหรือประเด็นทางสังคม) ใช่หรือไม่?
ใช่ — API รองรับโฆษณาทั่วไป (ไม่เฉพาะ SIEP) คุณสามารถใช้ ad_type=all (หรือละเว้นตัวกรอง) ขึ้นอยู่กับภูมิภาคและความพร้อมของโฆษณา

คำถามที่ 3. ฉันสามารถดึงโฆษณาได้กี่รายการในการเรียกใช้ครั้งเดียว?
โดยค่าเริ่มต้น API จะส่งคืนโฆษณาจำนวนจำกัดต่อการเรียกใช้หนึ่งครั้ง (การแบ่งหน้า) หากต้องการดึงข้อมูลเพิ่มเติม คุณต้องวนซ้ำผ่านหน้าต่างๆ โดยใช้เคอร์เซอร์การแบ่งหน้าที่ระบุในการตอบกลับ

คำถามที่ 4. ฉันสามารถเข้าถึงชิ้นงานโฆษณา (รูปภาพ, วิดีโอ) ผ่าน API ได้หรือไม่?
คุณจะได้รับ ad_snapshot_url หรือฟิลด์ที่คล้ายกันที่เชื่อมโยงไปยังตัวอย่างชิ้นงานโฆษณา อย่างไรก็ตาม Meta ไม่ได้ให้ไฟล์สื่อโดยตรงเสมอไป — การดึงรูปภาพหรือวิดีโอจริงอาจต้องมีขั้นตอนเพิ่มเติม

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

บทสรุป

Facebook (Meta) Ad Library API เป็นประตูสู่ข้อมูลโฆษณาที่มีประสิทธิภาพและมีโครงสร้าง ซึ่งช่วยให้นักพัฒนา, นักการตลาด, นักวิจัย และนักวิเคราะห์สามารถค้นหา, รวบรวม และวิเคราะห์แคมเปญโฆษณาบนแพลตฟอร์มของ Meta ได้ด้วยโปรแกรม การใช้งาน API นี้ช่วยให้คุณสามารถสร้างแดชบอร์ด, ทำการวิเคราะห์คู่แข่ง, ทำการวิจัยด้านความโปร่งใส หรือรวบรวมชิ้นงานโฆษณาในวงกว้าง

ด้วยการตั้งค่า Meta developer app, การได้รับโทเค็นการเข้าถึงที่เหมาะสม และการส่งคำขอไปยังปลายทาง /ads_archive — โดยอาจทดสอบผ่านเครื่องมือเช่น Apidog — คุณสามารถปลดล็อกข้อมูล Ad Library จำนวนมากได้ แม้จะมีข้อจำกัด (สิทธิ์, ขีดจำกัดอัตรา, การแบ่งหน้า, การดึงสื่อ) แต่ประโยชน์ที่ได้รับมักจะคุ้มค่ากับความพยายาม

สำหรับทุกคนที่ต้องการข้อมูลโฆษณาสาธารณะจาก Facebook/Meta — Ad Library API เป็นตัวเลือกที่มีคุณค่า, เป็นทางการ และยืดหยุ่น