إصدار ‏API التسويق‏

عمليات التحقق من عرض الإعلان

الموضوعات ذات الصلة

عمليات التحقق من العرض عبارة عن مجموعة اختبارات يمكن أن تساعد في اكتشاف المشكلات المحتملة المتعلقة بعرض الإعلان.

التشغيل والقراءة

لتشغيل عمليات التحقق من عرض الإعلان ومعرفة نتائج التحقق الفاشلة، اقرأ الحقل failed_delivery_checks لأي إعلان. فعلى سبيل المثال، تشغيل عمليات التحقق من عرض الإعلان 6014290603725:

curl -G \
  -d 'fields=failed_delivery_checks' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>

إذا تم اجتياز جميع عمليات التحقق، فلن يمثل الحقل failed_delivery_checks جزءًا من الاستجابة.

على سبيل المثال، ستظهر الاستجابة لأي إعلان بعملية تحقّق invalid_custom_audiences فاشلة كما يلي:

{
 "failed_delivery_checks": [
    {
      "summary": "Custom Audience No Longer Shared", 
      "description": "This ad uses a custom audience that's no longer being shared with you. Please contact the person who set up the audience for more information.", 
      "check_name": "invalid_custom_audiences", 
    }
  ], 
  "id": "6014290603725"
}

الحقل failed_delivery_checks هو مصفوفة بلغة JSON تحتوي على كائنات بلغة JSON لعمليات التحقق الفاشلة. وتحتوي كل عملية تحقق فاشلة على الحقول التالية:

الاسم الوصف النوع

check_name

يمثل اسم عملية التحقق الفاشلة (راجع أنواع عمليات التحقق من العرض)

String (سلسلة)

الملخص

يمثل وصف الخطأ المكوّن من سطر واحد

String (سلسلة)

description

يمثل شرحًا أكثر تفصيلًا للخطأ

String (سلسلة)

أنواع عمليات التحقق من العرض

تتضمن عمليات التحقق من عرض الإعلان عمليات التحقق التالية:

check_name سبب الفشل

page_status

الصفحة غير منشورة - لا يمكن عرض هذا الإعلان لأن الصفحة المستهدفة غير منشورة.

mobile_eligible

غير مؤهل للهاتف المحمول - لن يكون هذا الإعلان مؤهلًا لمستخدمي الهاتف المحمول.

blocked_url

عنوان URL في قائمة الحظر - يعيد هذا الإعلان التوجيه إلى عنوان URL مريب.

invalid_custom_audiences

أحد الخيارات التالية:
1. التوقف عن مشاركة الجمهور المخصص - يستخدم هذا الإعلان جمهورًا مخصصًا لم تتم مشاركته معك بعد الآن. لذا يرجى الاتصال بالشخص الذي يقوم بإعداد الجمهور لمزيد من المعلومات. وإذا لم يعد للحساب إمكانية الوصول إلى بعض الجماهير التي يستخدمها الإعلان، فلا يمكن عرض الإعلان.
2. تضارب في إلغاء اشتراك الجمهور المخصص - يستخدم هذا الإعلان جماهير مختلفة بروابط إلغاء اشتراك مختلفة. ويمكنك استخدام الجماهير المخصصة المختلفة فقط بالإعلان نفسه إذا لم يتم استخدام روابط متضاربة.
3. الإعلان الذي يستخدم الجمهور المخصص المحذوف - يستخدم هذا الإعلان جمهورًا مخصصًا محذوفًا بواسطتك أو بواسطة الشخص المسؤول عن إعداده. ولا يمكن عرض أي إعلان يستخدم الجماهير المخصصة المحذوفة.
4. خطأ في الجمهور المخصص - توجد مشكلة في هذا الجمهور المخصص المرتبط بهذا الإعلان. ونعمل لإصلاح المشكلة. لذا يرجى المحاولة مرة أخرى لاحقًا.

logged_out_ads

أحد الخيارات التالية:
1. يُسمح فقط بإعلانات منشور الصفحة للإعلانات التي تم تسجيل الخروج منها.
2. لا تكون القصة المُستخدمة للإعلانات التي تم تسجيل الخروج منها عامة.