أحداث 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

يمكنك أيضًا تسجيل اشترك التطبيق من خلال مستكشف Graph API.

استبدل الاستعلام me?fields=id,name بواسطة act_AD_ACCOUNT_ID/subscribed_apps. سيتم تسجيل اشتراك التطبيق الذي تستخدمه لإرسال طلب POST في مستكشف Graph. أو يمكنك تسجيل اشتراك تطبيق مختلف عن طريق تحديد 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"
            }
          }
        ]
      }
    ]
  }
]