Meta Ads: Ad preview
meta_ad_previewVorschau einer Meta-Anzeige so, wie sie in den Platzierungen erscheint —
zum Prüfen vor dem Start oder um sie einem Kunden zur Freigabe zu zeigen.
Je Format kommt previews[].preview_url (Metas Vorschauseite für genau diese
Platzierung; die Links laufen nach einiger Zeit ab, dann neu abrufen).
Die Links öffnen ohne Facebook-Login und ohne Zugriff aufs Werbekonto
(anders als preview_link aus meta_list_ads) — sie eignen sich also zum
Weitergeben an Kunden oder Kolleginnen zur Freigabe; Video-Anzeigen
spielen dort komplett mit Ton. Dazu die Creative-Inhalte (Text, Titel,
CTA, Ziel-URL, UTM) und — soweit Meta eines liefert — das Vorschaubild
(Titelbild des Videos bzw. Anzeigenbild) als Bild, damit du Motiv,
eingeblendeten Text und Ausschnitt selbst prüfen kannst.
Bei Video-Anzeigen kommt zusätzlich ein Storyboard: frames Bilder in
gleichen Abständen aus dem Video geschnitten, in zeitlicher Reihenfolge,
mit Zeitpunkt (storyboard_times_s, storyboard_source="video") — damit
prüfst du Szenen, eingeblendete Texte und Safe Zones über die ganze Länge.
Ton ist nicht enthalten; video_url ist ein direkter, zeitlich begrenzter
Link aufs MP4. Findet das Tool keine Video-Datei (weder über Meta noch in
der Vorschauseite), gibt es stattdessen Metas eigene Standbilder
(storyboard_source="meta_thumbnails": nicht gleichmäßig verteilt, nicht
chronologisch, können sich wiederholen). Ist die Datei gefunden, lässt
sich aber nicht laden oder lesen, fehlt das Storyboard; storyboard_error
nennt dann den Grund.
images nennt die Reihenfolge der mitgelieferten Bilder (thumbnail,
storyboard_1@0.3s, …). Bei Metas Standbildern bleibt die Nummer eines
nicht ladbaren Bilds als Lücke sichtbar; beim Video-Storyboard werden die
gelieferten Bilder fortlaufend gezählt, maßgeblich ist der Zeitpunkt im
Namen (@…s), und storyboard_times_s listet genau die gelieferten Zeitpunkte.
ad_id: aus meta_list_ads; muss zum Werbekonto des Workspace gehören, sonst
{'error': 'foreign_object'}.
formats: Metas ad_format-Namen, 1–8 (Default INSTAGRAM_REELS,
INSTAGRAM_STORY, FACEBOOK_REELS_MOBILE, MOBILE_FEED_STANDARD). Weitere
z. B. INSTAGRAM_STANDARD (Instagram-Feed), FACEBOOK_STORY_MOBILE,
DESKTOP_FEED_STANDARD. Kennt Meta ein Format nicht, steht der Fehler
beim jeweiligen Eintrag; die übrigen Vorschauen kommen trotzdem.
frames: Anzahl Storyboard-Bilder bei Videos, 0–10 (Default 6; 0 = nur das
Titelbild, spart Kontext und lädt das Video nicht).
workspace: Slug des Kunden-Workspace (optional bei nur einem Workspace).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_id | Yes | ||
| frames | No | ||
| formats | No | ||
| workspace | No |