Anzeigenformatvalidierung auf Medien-Level

Ergebnis der Medienvalidierung für Business Creatives

Unterstützte Video Ad-Platzierungen

Unterstützte Endpunkte

Validierung der Anzeigenplatzierung für vorhandene Bilder oder Videos

Sende eine GET-Anfrage an die {business-image-id}/ad_placement_validation_results- oder {business-video-id}/ad_placement_validation_results-Edge, um die Validierungsergebnisse für ein vorhandenes Bild oder Video anzuzeigen.

Beispielantwort (Bild)

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

Beispielantwort (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
    }
  ]
}

Validierung der Anzeigenplatzierung für alle Business Creatives

Du kannst auch ganz bequem eine Validierung aller Anzeigengestaltungen innerhalb eines Business durchführen, indem du das ad_placement_validation_results-Feld in einer GET-Abfrage zur {business-id}/creatives-Edge hinzufügst.

Beispielanforderung

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

Validierung der Anzeigenplatzierung an Upload-Endpunkten

Wenn du die Anzeigengestaltung zu einem Ordner hinzufügst, kannst du auch die Validierung der Anzeigenplatzierung beim Upload der Anzeigengestaltung durch Bereitstellung eines Arrays von Anzeigenplatzierungen über den optionalen Parameter validation_ad_placements für die POST-Anforderung für den Bild-/Video-Upload durchführen.

Die unterstützten Platzierungstypen findest du in der Spalte Platzierung unter Unterstützte Platzierungen für Video Ads. Die API führt Validierungen für die bereitgestellten Anzeigenplatzierungen durch, lehtn den Upload ab, wenn die Validierung für eine Platzierung fehlschlägt, und gibt die Validierungsergebnisse in der Antwort zurück.

Ein Beispielaufruf könnte den Parameter wie folgt enthalten:

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

Die Ergebnisse der Validierung werden in einer Beispielantwort wie dieser zurückgegeben:

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

Von bestimmten Fällen abhängige Ergebnisse

• Wenn die Validierung fehlschlägt (wie in obigem Beispiel), werden in der Antwort nur validation_results zurückgegeben.
• Sind alle Validierungen erfolgreich, werden die validation_results an die normalen Upload-Antwort angehängt.
• Wenn du nur Validierungen für die Upload-Medien durchführst (und den Upload nie beständig durchführst), kannst du einen validation_only-Parameter angeben. Ist dieser auf „true“ festgelegt, bewirkt der Parameter, dass die API Uploads immer ablehnt und nur die Ergebnisse der Validierung zurückgibt.
• Wenn validation_only als true gekennzeichnet ist, aber über validation_ad_placements keine Platzierungen bereitgestellt werden, führt die API standardmäßig die Validierung für alle Anzeigenplatzierungen aus.