การแชร์พิกเซลของ Meta กับธุรกิจต่างๆ

ในหลายๆ กรณี ธุรกิจอาจต้องเข้าถึงชุดข้อมูลพิกเซลของธุรกิจหนึ่งในอีกธุรกิจหนึ่ง (โดยทั่วไปจะเป็นเอเจนซี่) เพื่อจัดการโฆษณา วิเคราะห์ประสิทธิภาพ หรืออัพโหลดเหตุการณ์ เป็นต้น

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

ข้อกำหนดเบื้องต้น: ข้อกำหนดของแอพ

แอพควรมีฟีเจอร์สิทธิ์การเข้าถึงมาตรฐานสำหรับการจัดการโฆษณา (สิทธิ์การเข้าถึงขั้นสูง) แอพควรมีสิทธิ์การอนุญาตต่อไปนี้

  • business_management
  • ads_management หรือ ads_read และ manage_pages

ขั้นตอนที่ 1: การเริ่มต้นการแชร์พิกเซลกับธุรกิจเอเจนซี่

ขั้นตอนนี้ต้องใช้โทเค็นการเข้าถึงของผู้ใช้ที่ได้รับสิทธิ์การอนุญาตของแอพข้างต้นจากผู้ดูแลธุรกิจที่เป็นเจ้าของพิกเซล

POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]

ตัวเลือกและพารามิเตอร์สำหรับคำขอนี้มีดังนี้

ชื่อ คำอธิบาย

business

ประเภท: ตัวเลข

จำเป็นต้องระบุ

ID ธุรกิจเอเจนซี่ที่ได้รับสิทธิ์การเข้าถึงพิกเซล

permitted_tasks

type: รายการ:สตริง

จำเป็นต้องระบุ

ตัวอย่าง: ['ANALYZE', 'UPLOAD', 'ADVERTISE']

งานที่อนุญาตสำหรับเอเจนซี่บนพิกเซล

ค่าที่เป็นไปได้: ANALYZE, UPLOAD, ADVERTISE, EDIT

ANALYZE: ดู วิเคราะห์ และโฆษณา

UPLOAD: อัปโหลด

ADVERTISE: เชื่อมต่อบัญชีโฆษณาไปยังชุดข้อมูล Facebook นี้ ใช้ชุดข้อมูลนี้สำหรับการโฆษณา

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

เราจัดการคำขอตามสถานะความสัมพันธ์กับธุรกิจอื่น ดังนี้

  • ธุรกิจที่มีความสัมพันธ์ที่ได้รับอนุมัติแล้วที่มีอยู่. เราแชร์พิกเซลกับธุรกิจเหล่านั้นโดยตรง
  • ธุรกิจที่มีความสัมพันธ์ที่อยู่ระหว่างดำเนินการที่มีอยู่ เราเพิ่มพิกเซลไปยังคำขอเพื่อที่เราจะแชร์พิกเซลได้เมื่อธุรกิจผู้รับอนุมัติคำขอแล้ว
  • ธุรกิจที่ไม่มีความสัมพันธ์ใด เราสร้างข้อตกลงในการแชร์โดยแนบพิกเซลเอาไว้ด้วยเพื่อให้ระบบแชร์พิกเซลนั้นกับธุรกิจได้เลยเมื่อธุรกิจผู้รับอนุมัติคำขอนี้แล้ว

หากแชร์พิกเซลกับธุรกิจได้สำเร็จ ระบบจะส่งการตอบกลับต่อไปนี้คืนกลับมา

{  
    success: true,
}
    

หากคำขออยู่ระหว่างรอการยอมรับข้อตกลงการแชร์ คำขอ API จะส่งคืนการตอบกลับต่อไปนี้มาพร้อมกับ pending_request_id เมื่อธุรกิจผู้รับยอมรับคำขอ ระบบจะแชร์พิกเซลกับธุรกิจผู้รับโดยอัตโนมัติ ดูขั้นตอนที่ 2 เพื่อยอมรับ/ปฏิเสธคำขอ


{
  "success": true,
  "pending_request_id": "{request_id}"
}
      

โปรดทราบว่าจำนวนธุรกิจที่จะแชร์พิกเซลด้วยนั้นมีได้จำกัด

ขั้นตอนที่ 2: ยอมรับคำขอที่รอดำเนินการ (หากจำเป็น)

หลังจากเริ่มต้นคำขอการแชร์พิกเซลแล้ว ธุรกิจเอเจนซี่อาจได้รับคำขอข้อตกลงการแชร์ซึ่งรอดำเนินการ หากเอเจนซี่ยังไม่มีความสัมพันธ์กับธุรกิจที่เป็นเจ้าของพิกเซล ผู้ดูแลธุรกิจที่เป็นผู้รับจะเห็นและยอมรับคำขอนี้ได้ในตัวจัดการธุรกิจ

หากต้องการอนุมัติหรือปฏิเสธคำขอเกี่ยวกับความสัมพันธ์โดยใช้ API ให้ดึงข้อมูล request_id มาจากการตอบกลับที่แจ้งข้อผิดพลาดในขั้นตอนที ่1

API ต้องใช้โทเค็นการเข้าถึงของผู้ใช้จากผู้ดูแลธุรกิจที่เป็นผู้รับซึ่งมี business_mangement หรือ ads_management permission สำหรับแอพ

POST <request_id>?request_status="approve"

เมื่อดำเนินการสำเร็จ API จะส่งคืนการตอบกลับนี้

{  
    success: bool
}

ตัวเลือกและพารามิเตอร์สำหรับคำขอนี้มีดังนี้

ชื่อ คำอธิบาย

request_status

ประเภท: สตริง

จำเป็นต้องระบุ

สถานะว่าธุรกิจที่ได้รับคำขอแชร์พิกเซลอนุมัติหรือปฏิเสธคำขอหรือไม่


ค่าที่เป็นไปได้: APPROVE, DECLINE

ขั้นตอนที่ 3: แชร์พิกเซลกับบัญชีโฆษณาของธุรกิจเอเจนซี่

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

เมื่อแชร์พิกเซลให้กับธุรกิจโดยใช้สิทธิ์การอนุญาต ADVERTISE/ANALYZE ธุรกิจจะอนุญาตให้บัญชีโฆษณาภายในธุรกิจใช้ชุดข้อมูลสำหรับการโฆษณาได้

API ต้องใช้โทเค็นการเข้าถึงของผู้ใช้ที่มีสิทธิ์การอนุญาต business_management, ads_management หรือ ads_read จากผู้ดูแลธุรกิจ

Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
ชื่อ คำอธิบาย

business_id

ประเภท: ตัวเลข

จำเป็นต้องระบุ

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

ad_account_id

ประเภท: ตัวเลข

จำเป็นต้องระบุ

บัญชีโฆษณาที่จะอนุญาตบนพิกเซล

ขั้นตอนที่ 4: ลบการเชื่อมต่อการแชร์พิกเซล

หากไม่จำเป็นต้องใช้การเชื่อมต่อระหว่างพิกเซลและธุรกิจเอเจนซี่อีกต่อไปแล้ว ให้ใช้ API ต่อไปนี้เพื่อลบการเชื่อมต่อ

Delete <adspixel>/agencies?business=<agency_business_id>

API ต้องใช้โทเค็นการเข้าถึงผู้ใช้ระดับผู้ดูแลจากธุรกิจที่เป็นเจ้าของพิกเซล

เมื่อดำเนินการสำเร็จ API จะส่งคืนการตอบกลับนี้

{  
    success: true
}