Convalida formato pubblicitario a livello di contenuto multimediale

Risultati di convalida del contenuto multimediale della creatività business

Posizionamenti delle inserzioni video supportati

Endpoint supportati

Convalida del posizionamento dell'inserzione su immagini o video esistenti

Per vedere i risultati di convalida per un'immagine o un video esistente, invia una richiesta GET al segmento {business-image-id}/ad_placement_validation_results o {business-video-id}/ad_placement_validation_results.

Esempio di risposta (immagine)

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

Esempio di risposta (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
    }
  ]
}

Convalida del posizionamento dell'inserzione su tutte le creatività business

Puoi anche eseguire la convalida comodamente su tutte le creatività all'interno di un'azienda aggiungendo il campo ad_placement_validation_results su una richiesta GET al segmento {business-id}/creatives.

Esempio di richiesta

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

Validazione del posizionamento delle inserzioni negli endpoint di caricamento

Quando si aggiungono creatività a una cartella, è anche possibile eseguire la validazione del posizionamento delle inserzioni durante il caricamento della creatività fornendo un array di posizionamenti delle inserzioni attraverso il parametro opzionale validation_ad_placements nella richiesta POST di caricamento di immagini/video.

I tipi di posizionamento supportati sono disponibili nella colonna Posizionamento in Posizionamenti delle inserzioni video supportati. L'API esegue validazioni sulla base dei posizionamenti delle inserzioni forniti, rifiuta il caricamento se la validazione non va a buon fine su uno di essi e restituisce i risultati della validazione nella risposta.

Una chiamata di esempio potrebbe comprendere il parametro nel modo seguente:

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

I risultati della convalida vengono restituiti in una risposta di esempio simile a questa:

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

Risultati condizionali

• Se la convalida non ha esito positivo (come nell'esempio precedente), nella risposta vengono restituiti solo validation_results.
• Se tutte le validazioni vengono completate con successo, i validation_results vengono aggiunti alla normale risposta di caricamento.
• Se esegui solo validazioni sulla base del contenuto multimediale caricato (e non continui mai il caricamento), puoi includere il parametro validation_only. Se impostato su true, tale parametro comporta il rifiuto di tutti i caricamenti da parte dell'API e restituisce esclusivamente i risultati di convalida.
• Se validation_only è contrassegnato come true, ma non sono forniti posizionamenti delle inserzioni in validation_ad_placements, l'API per impostazione predefinita esegue la validazione per tutti i posizionamenti delle inserzioni.