影音素材級別的廣告格式驗證

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

支援的影片廣告版位

支援的端點

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

若要查看現有圖像或影片的驗證結果，請將 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 會驗證所提供的廣告版位；如有任何版位未能通過驗證，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 預設驗證所有廣告版位。