ในหลายๆ กรณี ธุรกิจอาจต้องเข้าถึงชุดข้อมูลพิกเซลของธุรกิจหนึ่งในอีกธุรกิจหนึ่ง (โดยทั่วไปจะเป็นเอเจนซี่) เพื่อจัดการโฆษณา วิเคราะห์ประสิทธิภาพ หรืออัพโหลดเหตุการณ์ เป็นต้น
รายการต่อไปนี้คือการผสานการทำงาน API ที่จำเป็นต่อการสร้างความสัมพันธ์ระหว่างพิกเซลและธุรกิจเอเจนซี่ หากธุรกิจที่เป็นผู้รับ (เอเจนซี่) ก็จัดการโฆษณาให้กับลูกค้าและต้องการใช้พิกเซลนั้นสำหรับบัญชีโฆษณาเช่นกัน ให้ดูขั้นตอนที่ 3
แอพควรมีฟีเจอร์สิทธิ์การเข้าถึงมาตรฐานสำหรับการจัดการโฆษณา (สิทธิ์การเข้าถึงขั้นสูง) แอพควรมีสิทธิ์การอนุญาตต่อไปนี้
business_management
ads_management
หรือ ads_read
และ manage_pages
ขั้นตอนนี้ต้องใช้โทเค็นการเข้าถึงของผู้ใช้ที่ได้รับสิทธิ์การอนุญาตของแอพข้างต้นจากผู้ดูแลธุรกิจที่เป็นเจ้าของพิกเซล
POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]
ตัวเลือกและพารามิเตอร์สำหรับคำขอนี้มีดังนี้
ชื่อ | คำอธิบาย |
---|---|
ประเภท: ตัวเลข | จำเป็นต้องระบุ ID ธุรกิจเอเจนซี่ที่ได้รับสิทธิ์การเข้าถึงพิกเซล |
type: รายการ:สตริง | จำเป็นต้องระบุ ตัวอย่าง: ['ANALYZE', 'UPLOAD', 'ADVERTISE'] งานที่อนุญาตสำหรับเอเจนซี่บนพิกเซล ค่าที่เป็นไปได้: ANALYZE: ดู วิเคราะห์ และโฆษณา UPLOAD: อัปโหลด ADVERTISE: เชื่อมต่อบัญชีโฆษณาไปยังชุดข้อมูล Facebook นี้ ใช้ชุดข้อมูลนี้สำหรับการโฆษณา EDIT: จัดการชุดข้อมูล แก้ไขการตั้งค่า วิเคราะห์ และโฆษณา (สิทธิ์การเข้าถึง EDIT ถูกจำกัดอยู่ในขณะนี้ ติดต่อตัวแทน Meta ของคุณเพื่อระบุแอพของคุณในรายชื่อที่อนุญาต) |
เราจัดการคำขอตามสถานะความสัมพันธ์กับธุรกิจอื่น ดังนี้
หากแชร์พิกเซลกับธุรกิจได้สำเร็จ ระบบจะส่งการตอบกลับต่อไปนี้คืนกลับมา
{ success: true, }
หากคำขออยู่ระหว่างรอการยอมรับข้อตกลงการแชร์ คำขอ API จะส่งคืนการตอบกลับต่อไปนี้มาพร้อมกับ pending_request_id
เมื่อธุรกิจผู้รับยอมรับคำขอ ระบบจะแชร์พิกเซลกับธุรกิจผู้รับโดยอัตโนมัติ ดูขั้นตอนที่ 2 เพื่อยอมรับ/ปฏิเสธคำขอ
{ "success": true, "pending_request_id": "{request_id}" }
โปรดทราบว่าจำนวนธุรกิจที่จะแชร์พิกเซลด้วยนั้นมีได้จำกัด
หลังจากเริ่มต้นคำขอการแชร์พิกเซลแล้ว ธุรกิจเอเจนซี่อาจได้รับคำขอข้อตกลงการแชร์ซึ่งรอดำเนินการ หากเอเจนซี่ยังไม่มีความสัมพันธ์กับธุรกิจที่เป็นเจ้าของพิกเซล ผู้ดูแลธุรกิจที่เป็นผู้รับจะเห็นและยอมรับคำขอนี้ได้ในตัวจัดการธุรกิจ
หากต้องการอนุมัติหรือปฏิเสธคำขอเกี่ยวกับความสัมพันธ์โดยใช้ API ให้ดึงข้อมูล request_id
มาจากการตอบกลับที่แจ้งข้อผิดพลาดในขั้นตอนที ่1
API ต้องใช้โทเค็นการเข้าถึงของผู้ใช้จากผู้ดูแลธุรกิจที่เป็นผู้รับซึ่งมี business_mangement
หรือ ads_management permission
สำหรับแอพ
POST <request_id>?request_status="approve"
เมื่อดำเนินการสำเร็จ API จะส่งคืนการตอบกลับนี้
{ success: bool }
ตัวเลือกและพารามิเตอร์สำหรับคำขอนี้มีดังนี้
ชื่อ | คำอธิบาย |
---|---|
ประเภท: สตริง | จำเป็นต้องระบุ สถานะว่าธุรกิจที่ได้รับคำขอแชร์พิกเซลอนุมัติหรือปฏิเสธคำขอหรือไม่ ค่าที่เป็นไปได้: |
หากเอเจนซี่จัดการโฆษณาสำหรับลูกค้าและต้องการอนุญาตให้บัญชีโฆษณาของลูกค้าซึ่งจัดสรรไว้โดยเฉพาะนั้นใช้ชุดข้อมูลพิกเซลได้ ให้ใช้ API
เมื่อแชร์พิกเซลให้กับธุรกิจโดยใช้สิทธิ์การอนุญาต ADVERTISE/ANALYZE ธุรกิจจะอนุญาตให้บัญชีโฆษณาภายในธุรกิจใช้ชุดข้อมูลสำหรับการโฆษณาได้
API ต้องใช้โทเค็นการเข้าถึงของผู้ใช้ที่มีสิทธิ์การอนุญาต business_management
, ads_management
หรือ ads_read
จากผู้ดูแลธุรกิจ
Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
ชื่อ | คำอธิบาย |
---|---|
ประเภท: ตัวเลข | จำเป็นต้องระบุ ธุรกิจที่จัดการโฆษณาและมีสิทธิ์เข้าถึงพิกเซลและบัญชีโฆษณา ผู้ใช้ที่เป็นเจ้าของโทเค็นการเข้าถึงที่ถูกใช้ต้องมีสิทธิ์การเข้าถึงระดับผู้ดูแลในธุรกิจนี้ |
ประเภท: ตัวเลข | จำเป็นต้องระบุ บัญชีโฆษณาที่จะอนุญาตบนพิกเซล |
หากไม่จำเป็นต้องใช้การเชื่อมต่อระหว่างพิกเซลและธุรกิจเอเจนซี่อีกต่อไปแล้ว ให้ใช้ API ต่อไปนี้เพื่อลบการเชื่อมต่อ
Delete <adspixel>/agencies?business=<agency_business_id>
API ต้องใช้โทเค็นการเข้าถึงผู้ใช้ระดับผู้ดูแลจากธุรกิจที่เป็นเจ้าของพิกเซล
เมื่อดำเนินการสำเร็จ API จะส่งคืนการตอบกลับนี้
{ success: true }