حجم الإعلان

عرض حجم الإعلان في حسابك الإعلاني

لمعرفة حجم الإعلان في حسابك الإعلاني:

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/ads_volume"

الاستجابة

{"data":[{"ads_running_or_in_review_count":2}]}

للحصول على معلومات حول إدارة حجم الإعلان، يمكنك الرجوع إلى حول إدارة حجم الإعلان.

عرض الحالة "قيد التشغيل" أو "قيد المراجعة"

لمعرفة ما إذا كان الإعلان بالحالة "قيد التشغيل" أم "قيد المراجعة"، يتم التحقق من effective_status والحالة configured_status وحالة الحساب الإعلاني:

• إذا كان الإعلان بالحالة effective_status بالعدد 1 - active، فسيتم اعتباره متوفرًا بالحالة قيد التشغيل أو قيد المراجعة.
• إذا كان أحد الإعلان متوفرًا بالحالة configured_status بالعدد active والحالة effective_status بالعدد 9 - pending review أو 17 - pending processing، فسيتم تحديد الحالة قيد التشغيل أو قيد المراجعة.
• يمكن أن يكون الإعلان متوفرًا بالحالة قيد التشغيل أو قيد المراجعة إذا كان حساب الإعلان متوفرًا بالحالة 1 - active أو 8 - pending settlement أو 9 - in grace period فقط.

يمكننا أيضًا تحديد ما إذا كان الإعلان متوفرًا بالحالة قيد التشغيل أو قيد المراجعة بناءً على الجدول الزمني للمجموعة الإعلانية:

• إذا كان وقت البدء يسبق الوقت الحالي وكان الوقت الحالي يسبق وقت الانتهاء، فيمكننا اعتبار الإعلان متوفرًا بالحالة قيد التشغيل أو قيد المراجعة.
• أما إذا كان وقت البدء يسبق الوقت الحالي ولم يتم تعيين وقت انتهاء للمجموعة الإعلانية، فيمكننا اعتبارها أيضًا متوفرة بالحالة قيد التشغيل أو قيد المراجعة.

على سبيل المثال، في حالة جدولة المجموعة الإعلانية لتشغيلها في المستقبل، لا تتوفر الإعلانات بالحالة قيد التشغيل أو قيد المراجعة. ومع ذلك، في حالة جدولة المجموعة الإعلانية لتشغيلها من الآن ولمدة 3 أشهر تبدأ من الآن، يمكننا اعتبار أن الإعلانات متوفرة بالحالة قيد التشغيل أو قيد المراجعة.

إذا كنت تستخدم ميزات خاصة لجدولة عرض الإعلانات مثل ميزة تقسيم اليوم، فيمكننا اعتبار أن الإعلان متوفر بالحالة قيد التشغيل أو قيد المراجعة طوال اليوم وليس فقط خلال جزء من اليوم عندما يبدأ تشغيل الإعلان.

التقسيم حسب العوامل

يمكنك استخدام الحقل show_breakdown_by_actor لتقسيم تقييدات الإعلانات حسب actor_id معين:

curl -G \
  -d "show_breakdown_by_actor=true" \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/ads_volume"

الاستجابة

{
  "data": [
    {
      "ads_running_or_in_review_count": 0,
      "current_account_ads_running_or_in_review_count": 0,
      "actor_id": "<ACTOR_ID_1>",
      "recommendations": [
      ]
    },
    {
      "ads_running_or_in_review_count": 2,
      "current_account_ads_running_or_in_review_count": 2,
      "actor_id": "<ACTOR_ID_2>",
      "recommendations": [
      ]
    }
  ],
}

يمكنك استخدام page_id للحصول على تقييدات الإعلانات الخاصة بصفحة معينة:

curl -G \
  -d "page_id=<PAGE_ID>" \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/ads_volume"

الاستجابة

{
  "data": [
    {
      "ads_running_or_in_review_count": 2,
      "current_account_ads_running_or_in_review_count": 2,
      "actor_id": "<ACTOR_ID>",
      "recommendations": [
      ]
    }
  ],
}

الحقول المدعومة

المعلمات