媒体层级的广告格式验证

商用素材验证结果

版位	标签
`FACEBOOK_STORY_MOBILE`	Facebook 快拍
`MOBILE_FULLWIDTH`	移动端（全屏宽度）
`MOBILE_INTERSTITIAL`	Audience Network 插屏
`MOBILE_MEDIUM_RECTANGLE`	Audience Network 中型矩形
`MOBILE_NATIVE`	Audience Network 原生
`INSTAGRAM_STANDARD`	Instagram 动态
`INSTAGRAM_STORY`	Instagram 快拍
`MESSENGER_MOBILE_INBOX_MEDIA`	Messenger 收件箱
`MESSENGER_MOBILE_STORY_MEDIA`	Messenger 快拍
`DESKTOP_FEED_STANDARD`	桌面端动态
`MOBILE_FEED_STANDARD`	移动端动态
`RIGHT_COLUMN_STANDARD`	桌面版右边栏

支持的视频广告版位

版位	标签
`FACEBOOK_STORY_MOBILE`	Facebook 快拍
`MOBILE_FULLWIDTH`	移动端（全屏宽度）
`AUDIENCE_NETWORK_INSTREAM_VIDEO`	Audience Network 视频插播位
`AUDIENCE_NETWORK_INSTREAM_VIDEO_MOBILE`	Audience Network 视频插播位（移动端）
`MOBILE_INTERSTITIAL`	Audience Network 插屏
`MOBILE_MEDIUM_RECTANGLE`	Audience Network 中矩形
`AUDIENCE_NETWORK_REWARDED_VIDEO`	Audience Network 激励视频
`INSTAGRAM_STANDARD`	Instagram 动态
`INSTAGRAM_STORY`	Instagram 快拍
`INSTREAM_VIDEO_DESKTOP`	Facebook 视频插播位（桌面端）
`INSTREAM_VIDEO_MOBILE`	Facebook 视频插播位（移动端）
`MESSENGER_MOBILE_INBOX_MEDIA`	Messenger 收件箱
`MESSENGER_MOBILE_STORY_MEDIA`	Messenger 快拍
`DESKTOP_FEED_STANDARD`	桌面端动态
`MOBILE_FEED_STANDARD`	移动端动态
`SUGGESTED_VIDEO_MOBILE`	推荐视频（移动端）

支持的端点

现有图片或视频的广告版位验证

要查看现有图片或视频的验证结果，请将 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 默认对所有广告版位执行验证。