Validation du format publicitaire au niveau du contenu multimédia

Résultats de la validation du contenu publicitaire professionnel multimédia

Placements de publicités vidéo pris en charge

Points de terminaison pris en charge

Validation du placement publicitaire pour des images ou des vidéos existantes

Pour voir les résultats de la validation pour une image ou une vidéo existante, envoyez une requête GET à l’arête {business-image-id}/ad_placement_validation_results ou {business-video-id}/ad_placement_validation_results.

Exemple de réponse (image)

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

Exemple de réponse (vidéo)

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

Validation du placement pour tous les contenus publicitaires professionnels

Pour plus de commodité, vous pouvez aussi procéder à la validation de tous les contenus publicitaires d’une entreprise en ajoutant le champ ad_placement_validation_results à une requête GET adressée à l’arête {business-id}/creatives.

Exemple de demande

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

Validation du placement publicitaire aux points de terminaison d’importation

Lorsque vous ajoutez des contenus publicitaires à un dossier, vous pouvez également valider le placement publicitaire lors de la transmission du contenu publicitaire en fournissant un tableau de placements publicitaires à l'aide du validation_ad_placements paramètre optionnel sur la demande d’importation d'image ou de vidéo POST.

Les types de placement pris en charge sont indiqués dans la colonne Placement du tableau Placements publicitaires vidéo pris en charge. Les API effectuent des validations par rapport aux placements publicitaires fournis, rejettent l’importation si la validation échoue pour l'un d'eux et retournent les résultats de validation dans la réponse.

Par exemple, un appel pourrait inclure le paramètre comme suit :

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

Les résultats de la validation sont renvoyés dans une réponse ressemblant à ceci :

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

Résultats conditionnels

• Si la validation échoue, comme dans l’exemple ci-dessus, seuls les validation_results sont renvoyés dans la réponse.
• Si toutes les validations sont réussies, les validation_results sont ajoutés à la réponse d’importation normale.
• Si vous souhaitez uniquement valider le contenu multimédia importé (sans jamais effectuer l’importation), vous pouvez inclure un paramètre validation_only. Définissez ce paramètre sur true pour que l’API refuse toutes les importations et renvoie uniquement les résultats de la validation.
• Si validation_only est signalé true, mais aucune publication publicitaire n'est fournie via validation_ad_placements, l'API utilise par défaut la validation pour tous les placements publicitaires.