Webhooks สำหรับบัญชีโฆษณา

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

คุณจะต้องทำตามขั้นตอนต่อไปนี้เพื่อตั้งค่า Webhooks สำหรับบัญชีโฆษณา

1. ตั้งค่าตำแหน่งข้อมูลของคุณและกำหนดค่า Webhooks
2. ให้แอพของคุณสมัครรับข้อมูลบัญชีโฆษณา

ตั้งค่าตำแหน่งข้อมูลและ Webhooks

ทำตามคู่มือการเริ่มต้นใช้งาน Webhooks ของเราเพื่อสร้างตำแหน่งข้อมูลและกำหนดค่า Webhooks ของคุณ เมื่อกำหนดค่า Webhooks คุณจะต้องเลือก Ad Account

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

ให้แอพของคุณสมัครรับข้อมูล

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

หากต้องการให้แอพของคุณสมัครรับข้อมูล ให้แอพของคุณส่งคำขอ POST พร้อมด้วย subscribed_apps สำหรับบัญชีโฆษณา ดังนี้

curl -i -X POST \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps?app_id=<APP_ID>"

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

{"success": "true"}

หากต้องการดูว่ามีแอพใดบ้างที่สมัครรับข้อมูลบัญชีโฆษณาของคุณ ให้ส่งคำขอ GET ดังนี้

curl -i -X GET \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<VERSION>/act_<AD_ACCOUNT_ID>/subscribed_apps"

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

{
  "data": [
  { 
    "name": "<APP_NAME>", 
    "id": "<APP_ID>" 
  } ]
}

หากต้องการลบแอพออกจากการสมัครรับข้อมูล ให้ส่งคำขอ DELETE ดังนี้

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

{"success": "true"}

สมัครรับข้อมูลด้วย Graph API Explorer

คุณสามารถให้แอพสมัครรับข้อมูลโดยใช้ Graph API Explorer ได้เช่นกัน

ให้แทนที่การสืบค้น me?fields=id,name ด้วย act_AD_ACCOUNT_ID/subscribed_apps ซึ่งจะเป็นการให้แอพของคุณสมัครรับข้อมูลเพื่อส่งคำขอ POST ใน Graph Explorer หรือคุณจะให้อีกแอพหนึ่งสมัครรับข้อมูลโดยระบุ subscribed_apps เป็นพารามิเตอร์อินพุตที่มี ID แอพก็ได้

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

[
  {
    "object": "ad_account",
    "entry": [
      {
        "id": "0",
        "time": 1568132516,
        "changes": [
          {
            "field": "with_issues_ad_objects",
            "value": {
              "id": "111111111111",
              "level": "AD",
              "error_code": "567",
              "error_summary": "error summary",
              "error_message": "error message"
            }
          }
        ]
      }
    ]
  }
]