Xác thực định dạng quảng cáo ở cấp file phương tiện

Kết quả xác thực file phương tiện nội dung của doanh nghiệp

Vị trí quảng cáo video được hỗ trợ

Điểm cuối được hỗ trợ

Xác thực vị trí quảng cáo trên hình ảnh hoặc video hiện có

Để xem kết quả xác thực cho hình ảnh hoặc video hiện có, hãy gửi yêu cầu GET đến cạnh {business-image-id}/ad_placement_validation_results hoặc {business-video-id}/ad_placement_validation_results.

Phản hồi mẫu (Hình ảnh)

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

Phản hồi mẫu (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
    }
  ]
}

Xác thực vị trí quảng cáo trên tất cả các nội dung của doanh nghiệp

Bạn cũng có thể chạy xác thực một cách thuận tiện trên tất cả nội dung trong doanh nghiệp bằng cách thêm trường ad_placement_validation_results trên yêu cầu GET vào cạnh {business-id}/creatives.

Yêu cầu mẫu

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

Xác thực vị trí quảng cáo tại điểm cuối tải lên

Khi thêm nội dung vào thư mục, bạn cũng có thể chạy xác thực vị trí quảng cáo khi tải nội dung lên bằng cách cung cấp mảng vị trí quảng cáo qua thông số validation_ad_placements không bắt buộc trên yêu cầu POST tải lên hình ảnh/video.

Bạn có thể tìm thấy các loại vị trí quảng cáo được hỗ trợ trong cột Vị trí quảng cáo trong phần Vị trí quảng cáo video được hỗ trợ. API chạy xác thực cho vị trí quảng cáo được cung cấp, từ chối tải lên nếu không xác thực được bất kỳ vị trí nào và trả về kết quả xác thực trong phản hồi.

Lệnh gọi mẫu có thể bao gồm thông số có dạng như sau:

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

Kết quả xác thực được trả về trong phản hồi mẫu có dạng như sau:

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

Kết quả có điều kiện

• Nếu xác thực không thành công (như trong ví dụ trên đây), chỉ validation_results được trả về trong phản hồi.
• Nếu tất cả hoạt động xác thực đều đạt, validation_results sẽ được thêm vào phản hồi tải lên thông thường.
• Nếu chỉ chạy xác thực cho file phương tiện được tải lên (và không tiếp tục tải lên), bạn có thể thêm thông số validation_only. Nếu đặt thành true, thông số đó sẽ khiến API luôn từ chối tải lên và chỉ trả về kết quả xác thực.
• Nếu validation_only được gắn cờ là true, nhưng không có vị trí quảng cáo nào được cung cấp qua validation_ad_placements, API sẽ mặc định chạy xác thực cho mọi vị trí quảng cáo.