Validación del formato de anuncio del contenido multimedia

Resultados de validación de archivos multimedia del contenido del negocio

Ubicaciones de anuncios con vídeo admitidas

Extremos admitidos

Validación de ubicaciones de anuncios en imágenes o vídeos existentes

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

Respuesta de ejemplo (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."
      ]
    },
...
  ]
}

Respuesta de ejemplo (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
    }
  ]
}

Validación de ubicaciones de anuncios en todos los contenidos del negocio

También puedes ejecutar cómodamente la validación en todos los contenidos de un negocio. Para ello, añade el campo ad_placement_validation_results de una solicitud GET al perímetro {business-id}/creatives.

Solicitud de ejemplo

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

Validación de ubicaciones de anuncios en los extremos de subida

Al añadir contenidos a una carpeta, también puedes ejecutar la validación de ubicaciones de anuncios al subir el contenido. Para ello, proporciona un matriz de ubicaciones de anuncios a través del parámetro validation_ad_placements opcional en la solicitud POST de subida de la imagen o el vídeo.

Los tipos de ubicaciones admitidos se pueden encontrar en la columna Ubicación de Ubicaciones de anuncios con vídeo admitidas. La API ejecuta las validaciones en las ubicaciones de anuncios proporcionadas, rechaza la subida si la validación falla en cualquiera de ellas y devuelve los resultados de la validación en la respuesta.

Una llamada de ejemplo podría incluir el parámetro siguiente:

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

Los resultados de la validación se devuelven en una respuesta de ejemplo como la 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 se produce un error en la validación (como en el ejemplo anterior), solo se devuelve validation_results en la respuesta.
• Si se superan todas las validaciones, validation_results se anexa a la respuesta de subida normal.
• Si solo ejecutas las validaciones en el contenido multimedia subido (y nunca persisten a la subida), puedes incluir un parámetro validation_only. Si se establece en true, este parámetro hace que la API siempre rechace las subidas y solo devuelva los resultados de la validación.
• Si validation_only se establece en true pero no se proporciona ninguna ubicación de anuncio a través de validation_ad_placements, la API se establece por defecto para ejecutar la validación de todas las ubicaciones de anuncios.