廣告帳號的 Webhooks

廣告帳號的 Webhooks 可讓您接收特定廣告變更的即時通知。

若要為廣告帳號設定 Webhooks，須執行以下步驟：

設定端點，然後配置 Webhooks。
在廣告帳號下訂閱應用程式。

設定端點和 Webhooks

請依照 Webhooks 新手指南的說明建立端點，並配置 Webhooks。配置 Webhooks 時，請務必選擇 Ad Account。

目前，您可以接收 WITH_ISSUES 和 IN_PROCESS 廣告目標狀態變更的即時通知。訂閱下方一或多個欄位：

欄位	說明
`with_issues_ad_objects`	當廣告帳號下的行銷活動、廣告組合或廣告收到 `WITH_ISSUES` 狀態時，會通知您。
`in_process_ad_objects`	當行銷活動、廣告組合或廣告結束 `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"}

使用圖形 API 測試工具訂閱

您也可以使用圖形 API 測試工具訂閱應用程式。

將 me?fields=id,name 查詢取代為 act_AD_ACCOUNT_ID/subscribed_apps。其將訂閱您在圖形測試工具中用來傳送 POST 要求的應用程式。或者您可以透過指定 subscribed_apps 作為包含應用程式編號的輸入參數，以訂閱其他應用程式。

應用程式必須具有編輯廣告帳號的權限才能訂閱。

[
  {
    "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"
            }
          }
        ]
      }
    ]
  }
]