ภาพรวม

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

เนื่องจาก API นี้เป็นแบบใช้ HTTP จึงทำงานได้กับภาษาหรือซอฟต์แวร์ทั้งหมดที่รองรับ HTTP ซึ่งรวมถึง cURL และเว็บเบราว์เซอร์ใหม่ๆ แทบทุกรูปแบบ API การตลาดได้รับการพัฒนาต่อยอดมาจาก API กราฟของ Meta ดังนั้น คำขอแทบทั้งหมดจึงควรได้รับการส่งไปยัง URL โฮสต์ graph.facebook.com

แนวคิดพื้นฐาน

แนวคิดที่คุณควรเข้าใจเพื่อใช้ API การตลาด:

โครงสร้างแคมเปญโฆษณา

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

การอนุญาต

ในการเข้าถึงตำแหน่งข้อมูล API การตลาด แอพของคุณต้องล้างการอนุญาต API กราฟหลายชั้นก่อน

การยืนยันตัวตน

เรียนรู้วิธีรับและจัดเก็บโทเค็นการเข้าถึงที่คุณต้องใช้สำหรับการเรียก API ของคุณ

การจำกัดอัตรา

API การตลาดมีตรรกะการจำกัดอัตราเฉพาะและจะแยกออกจากการจำกัดอัตรา API กราฟทั้งหมด

การกำหนดเวอร์ชั่น

แพลตฟอร์มของ Meta มีรูปแบบการกำหนดเวอร์ชั่นหลักและแบบขยาย เรียนรู้เพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงและการเลิกใช้ที่กำลังจะเกิดขึ้นโดยการใช้ระบบการกำหนดเวอร์ชั่นและการย้ายของเรา โปรดดูตารางเวลาเวอร์ชั่นการย้าย และบันทึกการเปลี่ยนแปลง

การตรวจสอบแอพ

หากต้องการใช้ API การตลาด แอพของคุณจะต้องเข้ารับการตรวจสอบแอพ โดยมีข้อยกเว้นอยู่บ้างสำหรับ API ฝั่งเซิร์ฟเวอร์และคอนเวอร์ชั่นแบบออฟไลน์

สิทธิ์การอนุญาต

สิทธิ์การอนุญาตสำหรับโฆษณามีอยู่ 2 รายการหลักๆ ได้แก่ ads_management และ ads_read โดยแอพที่คุณกำลังใช้เพื่อทำการเรียกใช้ควรได้รับสิทธิ์การอนุญาต ทั้งนี้ คุณสามารถขอสิทธิ์การอนุญาตได้ในระหว่างกระบวนการตรวจสอบแอพ โปรดดูรายการสิทธิ์การอนุญาตที่มีสำหรับแอพทางธุรกิจ

รหัสข้อผิดพลาด

คุณอาจพบรหัสข้อผิดพลาดขณะที่ใช้ API ใช้สิ่งนี้เป็นข้อมูลอ้างอิงเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับรหัสข้อผิดพลาดแต่ละรายการ

หลังการประมวลผล

ทำความเข้าใจขั้นตอนหลังผ่านการประมวลผลหลังจากที่ Meta ได้รับคำขอ