Проверка формата рекламы на уровне медиафайла

Результаты проверки медиафайла креатива компании

Поддерживаемые места размещения видеорекламы

Поддерживаемые конечные точки

Проверка размещения рекламы для существующих изображений и видео

Чтобы посмотреть результаты проверки для существующего изображения или видео, отправьте запрос 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 в запрос GET к границе контекста {business-id}/creatives.

Пример запроса

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

Проверка места размещения рекламы в конечных точках загрузки

Добавляя креативы в папку, вы также можете выполнить проверку места размещения во время загрузки. Для этого задайте массив мест размещения рекламы в необязательно параметре validation_ad_placements запроса POST на загрузку изображения или видео.

Список поддерживаемых типов мест размещения см. в столбце Место размещения в разделе Поддерживаемые места размещения видеорекламы. 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 по умолчанию проведет проверку всех мест размещения рекламы.