Validasi Format Iklan Level Media

Hasil Validasi Media Materi Iklan Bisnis

Penempatan Iklan Video yang Didukung

Endpoint yang Didukung

Validasi Penempatan Iklan pada Gambar atau Video yang Ada

Untuk melihat hasil validasi untuk gambar atau video yang ada, kirim permintaan GET ke edge {business-image-id}/ad_placement_validation_results atau {business-video-id}/ad_placement_validation_results.

Contoh Tanggapan (Gambar)

{
  "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."
      ]
    },
...
  ]
}

Contoh Tanggapan (Video)

{
  "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
    }
  ]
}

Validasi Penempatan Iklan di semua Materi Iklan Bisnis

Anda juga dapat dengan mudah menjalankan validasi terhadap semua materi iklan dalam bisnis dengan menambahkan kolom ad_placement_validation_results pada permintaan GET ke edge {business-id}/creatives.

Contoh Permintaan

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

Validasi Penempatan Iklan di Endpoint Unggahan

Saat menambahkan materi iklan ke folder, Anda juga dapat menjalankan validasi penempatan iklan saat mengunggah materi iklan dengan menyediakan array penempatan iklan melalui parameter validation_ad_placements opsional pada permintaan POST unggah gambar/video.

Jenis penempatan yang didukung dapat ditemukan di kolom Penempatan di Penempatan Iklan Video yang Didukung. API menjalankan validasi terhadap penempatan iklan yang diberikan, menolak unggahan jika validasi gagal pada salah satunya, dan menampilkan hasil validasi dalam tanggapan.

Contoh panggilan dapat menyertakan parameter seperti ini:

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

Hasil validasi ditampilkan dalam contoh tanggapan seperti ini:

"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.
    },
]

Hasil Bersyarat

• Jika validasi gagal (seperti pada contoh di atas), hanya validation_results yang ditampilkan dalam tanggapan.
• Jika lulus semua validasi, validation_results ditambahkan ke tanggapan unggahan normal.
• Jika Anda hanya menjalankan validasi terhadap media yang diunggah (dan tidak pernah melanjutkan unggahan), Anda dapat menyertakan parameter validation_only. Jika diatur ke true, parameter tersebut menyebabkan API selalu menolak unggahan dan hanya menampilkan hasil validasi.
• Jika validation_only ditandai true, tetapi tidak ada penempatan iklan yang diberikan melalui validation_ad_placements, API secara default akan menjalankan validasi untuk semua penempatan iklan.