Validación del formato de anuncio con contenido multimedia.

Resultados de la validación de contenido multimedia del negocio

Ubicaciones de anuncios con video admitidas

Puntos de conexión admitidos

Validación de ubicación de anuncios en imágenes o videos existentes

Para ver resultados de validación de una imagen o un video existente, envía una solicitud GET al perímetro {business-image-id}/ad_placement_validation_results o {business-video-id}/ad_placement_validation_results.

Ejemplo de respuesta (imagen)

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

Ejemplo de respuesta (video)

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

Validación de la ubicación de anuncios en todo el contenido del negocio

También puedes ejecutar la validación de forma conveniente en todo el contenido de un negocio agregando el campo ad_placement_validation_results en una solicitud GET al perímetro {business-id}/creatives.

Ejemplo de solicitud

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

Validación de la ubicación de anuncios en los puntos de conexión de subida

Cuando agregas contenido a una carpeta, también puedes ejecutar la validación de la ubicación de anuncios al subir el contenido. Para ello, debes proporcionar una matriz de ubicaciones de anuncios mediante el parámetro validation_ad_placements opcional en la solicitud POST para subir imágenes o videos.

Los tipos de ubicación admitidos se pueden encontrar en la columna Ubicación de Ubicaciones de anuncios con video admitidas. La API ejecuta validaciones de las ubicaciones de anuncios proporcionadas, evita que se suban los anuncios que no pasan la validación y devuelve los resultados en la respuesta.

Un ejemplo de llamada podría incluir el parámetro como se muestra a continuación:

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

Los resultados de la validación se devuelven en un ejemplo de respuesta como el siguiente:

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

Resultados condicionales

• Si la validación falla (como en el ejemplo anterior), solo se devuelven validation_results en la respuesta.
• Si toda la validación es correcta, se agregan los validation_results en la respuesta de subida normal.
• Si solo ejecutas validaciones del contenido multimedia que subiste (y nunca conservas la subida), puedes incluir un parámetro validation_only. Si se fija en “true”, ese parámetro hace que la API siempre rechace subidas y solo devuelva los resultados de validación.
• Si validation_only está marcado como true, pero no se proporcionan ubicaciones de anuncios a través de validation_ad_placements, de manera predeterminada, la API ejecuta la validación de todas las ubicaciones.