Webhooks untuk Akun Iklan

Webhooks untuk Akun Iklan memungkinkan Anda untuk mendapatkan notifikasi realtime untuk perubahan iklan tertentu.

Untuk menyiapkan Webhooks untuk Akun Iklan, langkah-langkah berikut diperlukan:

1. Menyiapkan endpoint Anda dan mengonfigurasi Webhooks.
2. Mulai berlangganan aplikasi Anda dalam akun iklan Anda.

Menyiapkan Endpoint dan Webhooks

Ikuti panduan Memulai Webhooks kami untuk membuat endpoint dan mengonfigurasi Webhooks Anda. Saat mengonfigurasi webhooks Anda, pastikan untuk memilih Ad Account.

Saat ini, Anda bisa mendapatkan notifikasi realtime untuk perubahan status objek iklan untuk WITH_ISSUES dan IN_PROCESS. Berlangganan satu atau beberapa kolom di bawah ini:

Membuat Aplikasi Anda Berlangganan

Anda harus membuat aplikasi Anda berlangganan notifikasi webhook untuk akun iklan Anda. Aplikasi Anda harus memiliki izin edit ke akun iklan untuk menyelesaikan langkah ini. Aplikasi ini juga harus memiliki izin ads_management.

Untuk membuat aplikasi Anda berlangganan, kirimkan permintaan POSTsubscribed_apps untuk akun iklan tersebut:

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

Setelah berhasil, Anda akan melihat tanggapan ini:

{"success": "true"}

Untuk melihat aplikasi mana yang berlangganan untuk akun iklan Anda, kirimkan permintaan GET:

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

Setelah berhasil, Anda akan melihat tanggapan ini:

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

Untuk menghapus langganan sebuah aplikasi, kirimkan permintaan DELETE:

Setelah berhasil, Anda akan melihat tanggapan ini:

{"success": "true"}

Berlangganan dengan Graph API Explorer

Anda juga dapat membuat aplikasi berlangganan dengan Graph API Explorer.

Ganti kueri me?fields=id,name dengan act_AD_ACCOUNT_ID/subscribed_apps. Dengan ini, aplikasi yang Anda gunakan akan berlangganan untuk mengirim permintaan POST di Graph Explorer. Atau Anda dapat membuat aplikasi lain berlangganan dengan menambahkan subscribed_apps sebagai parameter input dengan ID aplikasi tersebut.

Aplikasi Anda harus memiliki izin untuk mengedit akun iklan agar berhasil berlangganan.

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