メディアレベル広告フォーマットの検証

ビジネスクリエイティブメディア検証の結果

配置	ラベル
`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`	おすすめの動画(モバイル)

サポートされるエンドポイント

既存の画像または動画での広告配置の検証

既存の画像または動画の検証結果を見るには、{business-image-id}/ad_placement_validation_resultsまたは{business-video-id}/ad_placement_validation_resultsのエッジにGETリクエストを送信します。

応答の例(画像)

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

全ビジネスクリエイティブでの広告配置の検証

ビジネス内の全クリエイティブに対して検証を実行するという便利な機能もあります。そのためには、{business-id}/creativesエッジへのGETリクエストにad_placement_validation_resultsフィールドを追加します。

リクエストの例

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はデフォルトですべての広告配置の検証を行います。