Validação de formato do anúncio em nível de mídia

Resultados da validação de mídia do criativo da empresa

Posicionamentos de anúncio de vídeo compatíveis

Pontos de extremidade compatíveis

Validação do posicionamento do anúncio em imagens ou vídeos existentes

Para ver os resultados da validação de uma imagem ou um vídeo, envie uma solicitação GET para a borda {business-image-id}/ad_placement_validation_results ou {business-video-id}/ad_placement_validation_results.

Exemplo de resposta (imagem)

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

Exemplo de resposta (vídeo)

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

Validação do posicionamento do anúncio em todos os criativos da empresa

É possível executar validações de forma conveniente em todos os criativos de uma empresa. Para isso, adicione o campo ad_placement_validation_results a uma solicitação GET na borda {business-id}/creatives.

Exemplo de solicitação

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

Validação do posicionamento do anúncio em pontos de extremidade de carregamento

Ao adicionar criativos a uma pasta, você também pode realizar a validação do posicionamento do anúncio ao carregar o criativo. Para isso, forneça uma matriz de posicionamentos de anúncio por meio do parâmetro opcional validation_ad_placements a uma solicitação POST de carregamento de imagem/vídeo.

Os tipos de posicionamento compatíveis podem ser encontrados na coluna Posicionamento em Posicionamentos de anúncio de vídeo compatíveis. A API executa as validações dos posicionamentos de anúncio fornecidos, rejeita o carregamento quando a validação não é bem-sucedida em algum deles e retorna os resultados da validação na resposta.

Uma chamada de exemplo poderia incluir parâmetros como estes:

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

Os resultados da validação são retornados em um exemplo de resposta como este:

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

Resultado condicional

• Se a validação falhar (como no exemplo acima), apenas validation_results serão retornados na resposta.
• Se a validação for bem-sucedida, os validation_results serão anexados à resposta normal de carregamento.
• Caso você execute validações apenas na mídia carregada (e nunca persistir no carregamento), será possível incluir um parâmetro validation_only. Se definido como verdadeiro, o parâmetro faz com que a API sempre rejeite os carregamentos e retorne apenas os resultados da validação.
• Caso validation_only esteja sinalizado como true, mas nenhum posicionamento de anúncio seja fornecido por meio de validation_ad_placements, a API executará a validação em todos os posicionamentos por padrão.