미디어 레벨 광고 형식 검증

비즈니스 크리에이티브 미디어 검증 결과

지원되는 동영상 광고 노출 위치

지원되는 엔드포인트

기존 이미지 또는 동영상에 대한 광고 노출 위치 검증

기존 이미지 또는 동영상에 대한 검증 결과를 확인하려면 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
    }
  ]
}

모든 비즈니스 크리에이티브에 대한 광고 노출 위치 검증

ad_placement_validation_results 필드를 {business-id}/creatives 에지로 보내는 GET 요청에 추가하여 비즈니스 내 모든 크리에이티브에 대해 편리하게 검증을 실행할 수도 있습니다.

요청 예시

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가 기본적으로 모든 광고 노출 위치에 대해 검증을 실행합니다.