การตรวจสอบความถูกต้องของรูปแบบโฆษณาที่ระดับสื่อ

ผลการตรวจสอบความถูกต้องของสื่อในชิ้นงานโฆษณาของธุรกิจ

ตำแหน่งการจัดวางโฆษณาแบบวิดีโอที่รองรับ

ตำแหน่งข้อมูลที่รองรับ

การตรวจสอบความถูกต้องของตำแหน่งการจัดวางโฆษณาในรูปภาพหรือวิดีโอที่มีอยู่

หากต้องการดูผลการตรวจสอบความถูกต้องสำหรับรูปภาพหรือวิดีโอที่มีอยู่ ให้ส่งคำขอ 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 จะใช้การตรวจสอบความถูกต้องสำหรับตำแหน่งการจัดวางโฆษณาทั้งหมดเป็นค่าเริ่มต้น