التحقق من صحة التنسيق الإعلاني على مستوى الوسائط

نتائج التحقق من وسائط عناصر تصميمات نشاط تجاري

مواضع إعلان الفيديو المدعومة

نقاط النهاية المدعومة

التحقق من موضع الإعلان على مقاطع الفيديو أو الصور الموجودة

لمراجعة نتائج التحقق لفيديو موجود أو صورة موجودة، أرسل طلب GET إلى عنصر الربط {business-image-id}/ad_placement_validation_results أو {business-video-id}/ad_placement_validation_results.

مثال على الاستجابة (صورة)

{
  "data": [
    {
      "ad_placement": "FACEBOOK_STORY_MOBILE",
      "ad_placement_label": "Facebook Stories",
      "is_valid": false,
      "error_messages": [
        "Fb Story Ads Resolution Is Too Low: The width of photo and video has to be larger than 500px for ads in Facebook Stories."
      ]
    },
...
  ]
}

مثال على الاستجابة (فيديو)

{
  "data": [
    {
      "ad_placement": "INSTREAM_VIDEO_MOBILE",
      "ad_placement_label": "Facebook In-Stream Video (Mobile)",
      "is_valid": false,
      "error_messages": [
        "Ad Video Duration Is Too Short: Duration of the video used in the ad is too short."
      ]
    },
...
    {
      "ad_placement": "FACEBOOK_STORY_MOBILE",
      "ad_placement_label": "Facebook Stories",
      "is_valid": true
    }
  ]
}

التحقق من موضع الإعلان على كل عناصر تصميمات النشاط التجاري

يمكنك أيضًا تشغيل التحقق بسهولة لكل عناصر تصميمات النشاط التجاري بإضافة الحقل ad_placement_validation_results في طلب GET إلى عنصر الربط {business-id}/creatives.

مثال على الطلب

curl -i -X GET \
 "https://graph.facebook.com/{version}/{business-id}/creatives?fields=ad_placement_validation_results&access_token={access_token}"

التحقق من موضع الإعلان عند نقاط نهاية التحميل

عند إضافة التصميمات إلى مجلد، يمكنك أيضًا تشغيل عمليات التحقق من صحة موضع الإعلان عند تحميل التصميم من خلال توفير مصفوفة من مواضع الإعلانات من خلال المعلمة validation_ad_placements الاختيارية في طلب POST لتحميل صورة/فيديو.

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

قد يتضمن مثال الاستدعاء معلمة مثل هذا:

"validation_ad_placements"=["FACEBOOK_STORY_MOBILE", "MESSENGER_MOBILE_STORY_MEDIA"]

يتم إرجاع نتائج التحقق في مثال استجابة مثل هذا:

"validation_results" => [
    {
        "ad_placement" => "FACEBOOK_STORY_MOBILE"
        "ad_placement_label" => "Facebook Stories"
        "error_messages" => ["The width of the media in the ad is too low. Try to use a different media.""The height of the media in the ad is too low. Try to use a different media."],
        "is_valid" => false,
    },
    {
        "ad_placement" => "MESSENGER_MOBILE_STORY_MEDIA"
        "ad_placement_label" => "Messenger Stories",
        "error_messages" => [],
        "is_valid" => true.
    },
]

النتائج الشرطية

• إذا فشل التحقق (كما في المثال أعلاه)، فيتم إرجاع validation_results في الاستجابة فقط.
• إذا تم اجتياز كل عمليات التحقق، فيتم إلحاق validation_results باستجابة التحميل الطبيعية.
• إذا كنت تقوم بتشغيل عمليات التحقق فقط من الوسائط التي تم تحميلها (بدون استمرار التحميل)، فيمكنك تضمين المعلمة validation_only. إذا تم التعيين إلى القيمة "true"، فستتسبب تلك المعلمة في رفض API للتحميلات وإرجاع نتائج التحقق بمفردها.
• إذا تم تمييز validation_only على أنه true، ولم يتم توفير أي مواضع إعلانات من خلال validation_ad_placements، فسيتم تعيين API افتراضيًا لتشغيل عمليات التحقق لجميع مواضع الإعلانات.