影音素材層級廣告格式驗證

商用廣告創意影音素材驗證結果

支援的影片廣告版位

支援的端點

驗證現有圖像或影片的廣告版位

若要查看現有圖像或影片的驗證結果，請傳送 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
    }
  ]
}

驗證所有商用廣告創意的廣告版位

您也可以將 GET 要求的 ad_placement_validation_results 欄位新增至 {business-id}/creatives 關係連線，輕鬆對企業內的所有廣告創意執行驗證作業。

要求範例

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

上傳端點的廣告版位驗證

將廣告創意新增至資料夾時，您也可以在上傳廣告創意期間執行廣告版位驗證，方法是透過圖像／影片 POST 上傳要求的 validation_ad_placements 選用參數提供廣告版位鎮列。

您可以在「支援的影片廣告版位」一節中的「版位」欄找到支援的廣告版位類型。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 預設會為所有廣告版位執行驗證作業。