Webhooks cho tài khoản quảng cáo

Với Webhooks cho tài khoản quảng cáo, bạn có thể nhận thông báo theo thời gian thực cho một số thay đổi về quảng cáo.

Để thiết lập Webhooks cho tài khoản quảng cáo, bạn cần thực hiện các bước dưới đây:

1. Thiết lập điểm cuối của bạn và đặt cấu hình Webhooks.
2. Đăng ký ứng dụng thuộc tài khoản quảng cáo của bạn.

Thiết lập điểm cuối và Webhooks

Hãy làm theo hướng dẫn Bắt đầu về Webhooks của chúng tôi để tạo điểm cuối và đặt cấu hình Webhooks của bạn. Khi bạn đặt cấu hình webhook, hãy nhớ chọn Ad Account.

Hiện tại, bạn có thể nhận thông báo theo thời gian thực cho các thay đổi về đối tượng quảng cáo có trạng thái là WITH_ISSUES và IN_PROCESS. Hãy đăng ký một hoặc nhiều trường bên dưới:

Đăng ký ứng dụng của bạn

Bạn cần đăng ký ứng dụng của mình với thông báo webhook cho tài khoản quảng cáo. Ứng dụng của bạn phải có quyền chỉnh sửa đối với tài khoản quảng cáo để hoàn tất bước này. Ứng dụng đó cũng phải có quyền ads_management.

Để đăng ký ứng dụng, hãy đề nghị ứng dụng gửi yêu cầu POST đến subscribed_apps cho tài khoản quảng cáo:

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

Khi thành công, bạn sẽ thấy phản hồi sau đây:

{"success": "true"}

Để xem tài khoản quảng cáo của bạn đã đăng ký ứng dụng nào, hãy gửi yêu cầu GET:

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

Khi thành công, bạn sẽ thấy phản hồi sau đây:

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

Để hủy đăng ký ứng dụng, hãy gửi yêu cầu DELETE:

Khi thành công, bạn sẽ thấy phản hồi sau đây:

{"success": "true"}

Đăng ký thông qua Trình khám phá API Đồ thị

Bạn cũng có thể đăng ký ứng dụng thông qua Trình khám phá API Đồ thị.

Hãy thay thế truy vấn me?fields=id,name bằng act_AD_ACCOUNT_ID/subscribed_apps. Khi đó, ứng dụng mà bạn dùng để gửi yêu cầu POST sẽ được đăng ký trong Trình khám phá đồ thị. Hoặc bạn có thể đăng ký một ứng dụng khác bằng cách chỉ định subscribed_apps làm thông số đầu vào kèm ID ứng dụng.

Ứng dụng phải có quyền chỉnh sửa tài khoản quảng cáo thì mới có thể đăng ký.

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