การอัพเดตแคมเปญโฆษณา

หน้านี้จะแสดงขั้นตอนในการอัพเดตแคมเปญโฆษณาของพาร์ทเนอร์ภายใต้สัญญา (ผู้ขาย) ที่คุณเริ่มต้นใช้งานโฆษณาของพาร์ทเนอร์ภายใต้สัญญา

ก่อนที่คุณจะเริ่ม

ตรวจสอบให้แน่ใจว่าคุณได้ทำตามขั้นตอนเหล่านี้ก่อนที่คุณจะอัพเดตแคมเปญโฆษณาสำหรับพาร์ทเนอร์ของคุณ

1. สร้างผู้ใช้ระบบที่เป็นผู้ดูแล
2. กำหนดสิทธิ์การอนุญาตให้กับผู้ใช้ระบบที่เป็นผู้ดูแล
3. สร้างโทเค็นการเข้าถึงสำหรับผู้ใช้ระบบที่เป็นผู้ดูแล
4. ตรวจสอบคุณสมบัติของผู้ขาย
5. ให้ผู้ขายเริ่มต้นใช้งาน

สิทธิ์การอนุญาตที่จำเป็น

คุณจะต้องมีสิทธิ์การอนุญาตต่อไปนี้เพื่อเรียกใช้ API การอัพเดตโฆษณาของผู้ขาย

• ผู้ดูแลระบบธุรกิจของผู้ขาย

การกำหนดเป้าหมายตำแหน่งที่มีการกำกับดูแลของ DSA (สหภาพยุโรป)

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

การเรียก API การอัพเดตโฆษณาของผู้ขาย

คำขอ

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
       { 
         "method": "POST", 
         "relative_url": "act_<ACCOUNT_ID>/managed_partner_ads", 
         "name": "create1", 
         "body": "campaign_group_id=123456789&lifetime_budget=100000" 
       }, 
     ]' \
  "https://graph.facebook.com/v21.0"

เมื่อเรียกใช้ API นี้ ระบบจะส่งคืนการตอบกลับด้วย ASYNC_SESSION_ID ในทันที ซึ่งในระหว่างที่ระบบกำลังประมวลผลคำขอ คุณควรตรวจสอบ ASYNC_SESSION_ID เป็นระยะ จนกว่าจะถึงสถานะเทอร์มินัล [COMPLETED|FAILED]

พารามิเตอร์

การตอบกลับ

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

ใช้ ASYNC_SESSION_ID เพื่อรับ ID ที่สอดคล้องกันของผู้ขายที่เริ่มต้นใช้งานโฆษณาของพาร์ทเนอร์ภายใต้สัญญา

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

การตอบกลับเมื่อสำเร็จ

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

{
  "result": "{\"id\":\"<NEWLY_UPDATED_CAMPAIGN_ID>\",\"success\":true}",
  "id": "<ASYNC_SESSION_ID>"
}

การตอบกลับเมื่อล้มเหลว

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

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

ดูเพิ่มเติม

• วิธีตรวจสอบเซสชั่นแบบไม่ซิงค์ของการตอบกลับเป็นระยะ