Dynamische Medien

Mit dynamischen Medien können Werbetreibende Video-Assets aus ihrem Katalog in ihren Advantage+ Catalog Ads ausliefern.

Bevor du loslegst

Voraussetzungen:

• Ein Produktkatalog mit bestehenden Produkten
• Ein Video für jeden Produktartikel in einem herunterladbaren Video-URL-Format

Weitere Informationen zu ihrer Funktionsweise findest du in der Dokumentation zu Advantage+ Catalog Ads.

Einschränkungen

• Wir empfehlen eine Mindestzahl von 20 Produkten, aber es gibt kein erforderliches Minimum.
• Jedes Video sollte nicht größer als 200 MB sein. Es gibt keine Längenbeschränkungen.
• Videos müssen in einem der folgenden Formate vorliegen: 3g2, 3gp, 3gpp, asf, avi, dat, divx, dv, f4v, flv, gif, m2ts, m4v, mkv, mod, mov, mp4, mpe, mpeg, mpeg4, mpg, mts, nsv, ogm, ogv, qt, tod, ts, vob oder wmv.
• Bei video_fetch_status wird möglicherweise NO_STATUS angezeigt, bis das Video in einer Anzeige verwendet wird oder ein anderes Event getriggert wird, das das Video benötigt.

Videos zu deinem Katalog hinzufügen

Es gibt 3 Möglichkeiten, Videos zu Produkten in deinem Katalog hinzuzufügen: Katalog-Feed-Datei, Catalog Batch API und manueller Upload via Commerce Manager.

Videos mit einer Katalog-Feed-Datei hinzufügen

Schritt 1: Bereite deine Katalog-Feed-Datei vor

Du kannst eine der folgenden Methoden verwenden, um deine Katalog-Feed-Datei zu implementieren.

• Methode 1: Hauptfeed ändern

  • Füge deiner vorhandenen Katalog-Feed-Datei eine Spalte video[0].url hinzu, fülle die Video-URL nur für die ausgewählten Produkte aus und lasse sie für andere Produktzeilen leer.
  • Weitere Videos für dasselbe Produkt können mit zusätzlichen Spalten hinzugefügt werden: video[1].url, video[2].url, video[3].url etc.
  • Du kannst den Videos Tags hinzufügen, indem du die Tags in separaten Spalten angibst. Beispiel: video[0].tag[0], video[0].tag[1], video[1].tag[0] etc.
• Methode 2: Ergänzender Feed
  Erstelle eine ergänzende Katalog-Feed-Datei, um einen bestehenden Feed-Upload zu ergänzen. Dieser ergänzende Feed kann ausschließlich Videos zu bereits bestehenden Produktartikeln hinzufügen oder ersetzen. Füge eine Spalte video[0].url und eine Spalte „ID“ hinzu, um das Video mit der Produktartikel-ID zu verknüpfen.

Optional:
Anstatt der video[0].url-Spalte kannst du eine Spalte namens video erstellen und dem Video Tags hinzufügen. Die Spalte video kann mehrere Video-URLs pro Produkt und mehrere JSON-codierte Tags pro URL enthalten. Wenn du eine Tag-Spalte für den Produktpalettenfilter verwenden möchtest, musst du diese Spalte auch in die Feed-Datei aufnehmen.

Für einen XML-Feed können Video-URLs mithilfe von <video>-Tags hinzugefügt werden, wie zum Beispiel:

<video><url>https://{URL1}</url><tag>video_product_set1</tag><tag>video_product_set2 </tag></video><video><url>https://{URL2}</url><tag>video_product_set1</tag></video>

Videodaten aus der Product Item API abrufen

Mit den Feldern videos, videos_metadata und video_fetch_status in den Katalog-APIs kannst du Details zu Katalog-Produktvideos abrufen.

curl -i GET \ "http://graph.facebook.com/v25.0/<PRODUCT_ITEM_ID>?fields=videos,videos_metadata,video_fetch_status"

Weitere Details zu Videoinformationen findest du unter Product Item.

Videos mit der Catalog Batch API hinzufügen

Aktualisierungen von Produktartikeln werden über den /{product_catalog_id}/items_batch-Endpunkt unterstützt. Du kannst einen POST-API-Aufruf mit dem video-Feld tätigen, welches ein Array von URLs darstellt.

curl \
  -d @body.json \
  -H "Content-Type: application/json"

> cat body.json
{
  "access_token": "<ACCESS_TOKEN>",
  "item_type": "PRODUCT_ITEM",
  "requests": [
    {
      "method": "CREATE",
      "data": {
        "id": "retailer-2",
        "availability": "in stock",
        "brand": "BrandName",
        "google_product_category": "t-shirts",
        "description": "product description",
        "image_link": "http://www.images.example.com/t-shirts/1.png",
        "title": "product name",
        "price": "10.00 USD",
        "shipping": [
          {
            "shipping_country": "US",
            "shipping_region": "CA",
            "shipping_service": "service",
            "shipping_price_value": "10",
            "shipping_price_currency": "USD"
          }
        ],
        "condition": "new",
        "link": "http://www.images.example.com/t-shirts/1.png",
        "item_group_id": "product-group-1",
        "video": [
          {"url": "http://www.jaspersmarket-example1.com/video-file.avi", "tag": ["Optional Tag1", "Optional Tag2"]}, 
          {"url": "http://www.jaspersmarket-example2.com/video-file.avi", "tag": ["Optional Tag1", "Optional Tag2"]}
        ]
      }
    },
    {
      "method": "UPDATE",
      "data": {
        "availability": "out of stock",
        "id": "retailer-3",
        "video": [
          {
            "url": "https://yourvideo.com/demo.mp4?q=1411"
          },
          {
            "url": "https://yourvideo.com/demo.mp4?q=1421"
          }
        ]
      }
    }
  ]
}

Siehe dieses Beispiel im Graph API Explorer.

Anzeigen mit dynamischen Medien erstellen

Beim Erstellen von Anzeigen gibt es 3 Methoden, die Videos aus dem Katalog verwenden:

• Carousel/Collection dynamischer Medien (empfohlen)
• Video anzeigen, wenn verfügbar (nur für einzelnes Videoformat verfügbar)
• Einzelnes Bild mit Option für dynamische Medien

Hinweis: Die Auswahl des dynamischen Medientyps mit der API ähnelt der Auswahl der Dynamische Medien-Optionen im Werbeanzeigenmanager. Mit den Änderungen im September 2025 werden Advantage+ Catalog Ads standardmäßig die Option für dynamische Medien verwenden.

Anzeigen mit dynamischem Medientyp

Beim Erstellen eines Anzeigengestaltungsobjekts mit dem act_<AD_ACCOUNT_ID>/adcreatives-Endpunkt:

• Ab September 2025 liefern Advantage+ Catalog Ads standardmäßig Katalog-Produktvideos aus. Du kannst media_type_automation auf OPT_out festlegen, um zu verhindern, dass Katalog-Produktvideos in Werbeanzeigen angezeigt werden.
• Der media_type_automation-Schlüssel funktioniert mit den Formaten Carousel, Collection und Single Image.

curl -X POST \ -F 'name=Dynamic Media Ad Creative' \ -F 'object_story_spec={ ... }' \ -F 'degrees_of_freedom_spec={ "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }' \ -F 'product_set_id=<PRODUCT_SET_ID>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

Analog dazu gilt: Wenn du ein Advantage+ Catalog Ad-Objekt mit dem act_<AD_ACCOUNT_ID>/ads-Endpunkt erstellst, liefert die Werbeanzeige standardmäßig verfügbare Katalog-Produktvideos aus. Du kannst den media_type_automation-Schlüssel auf OPT_out festlegen, um zu verhindern, dass Katalog-Produktvideos in Werbeanzeigen angezeigt werden.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { ... }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

Anzeigen mit dynamischen Medien (mit Collection-Format)

• Dynamische Medien ersetzen nur Hero-Medien. Produkt-Thumbnails vor dem Klicken und in Instant Experiences sind immer Bilder.
• Wenn du dich für dynamische Medien entschieden hast und das Produktvideo verfügbar ist, ersetzen wir die dynamischen Video-Hero-Medien durch ein Produktvideo. Ab September 2025 verwenden Advantage+ Catalog Ads im Collection-Format standardmäßig dynamische Medien und liefern Katalog-Produktvideos aus. Du kannst media_type_automation auf OPT_OUT festlegen, um zu verhindern, dass Katalog-Produktvideos in Werbeanzeigen angezeigt werden.
• Dynamische Medien ersetzen dynamische Video-Hero-Medien nur, wenn die Option aktiviert ist. Momentan werden statische Hero Images und -Videos nicht durch Produktvideos ersetzt, das heißt, Das Bild-Slideshow-Erlebnis wird durch ein Produktvideo ersetzt.

Beispielhafte Anzeigengestaltung für Collection mit dynamischen Medien

curl -X POST \ -F 'name=Dynamic Media Ad Creative' \ -F 'object_story_spec={ "template_data": { ... "format_option": "collection_video", "link": "https://fb.com/canvas_doc/<CANVAS_ID>", "message": "Your Collection Ad", ... } }' \ -F 'degrees_of_freedom_spec={ "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }' \ -F 'product_set_id=<PRODUCT_SET_ID>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

Dynamische Medienanzeigen (Videos anzeigen, wenn verfügbar)

Ändere in object_story_specformat_option in single_video. Dies ist nur für Einzelbild-/Videoformate verfügbar.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { ... "format_option": "single_video", ... } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

Anzeigen mit dynamischen Medien (Einzelbild mit aktivierter Option für dynamische Medien)

In object_story_spec werden für format_option mit single_image dynamische Medien angezeigt, wenn media_type_automation aktiviert ist.

Ab September 2025 verwenden Advantage+ Catalog Ads mit format_option gleich single_image standardmäßig dynamische Medien und zeigen verfügbare Katalog-Produktvideos in Werbeanzeigen an. Du kannst media_type_automation auf OPT_OUT festlegen, um zu verhindern, dass Katalog-Produktvideos in Werbeanzeigen angezeigt werden.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { "format_option": "single_image" } }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

Optional: Opt-in oder Opt-out für automatischen Videozuschnitt

Mit dem Feld video_crop_style kannst du den automatischen Videozuschnitt steuern. Zulässige Werte sind AUTO oder NONE.

Um den automatischen Videozuschnitt zu deaktivieren, lege video_crop_style auf NONE fest oder entferne die Anpassungen aus den media_type_automation-Einstellungen.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { ... }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "customizations": { "video_crop_style": "NONE" }, "enroll_status": "OPT_IN" } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

Der automatische Zuschnitt wird nur auf Videos angewendet, die die Größenanforderungen für die Platzierung nicht erfüllen, und dient hauptsächlich dazu, das Video in den Viewport des Players einzupassen.

Wenn ein Video existiert, dessen Seitenverhältnis mit der Platzierung der Werbeanzeige übereinstimmt, wird dieses Video zurückgegeben. Wenn alle Seitenverhältnisse eines bestimmten Produktvideos angegeben werden, wird kein automatischer Zuschnitt ausgeführt. Andernfalls wählt die Werbeanzeige ein Video des Artikels aus und überprüft die Einstellung für den automatischen Zuschnitt: AUTO gibt das automatisch zugeschnittene Video zurück, und NONE gibt das Originalvideo zurück.

Einblicke für dynamische Medien

Kennzahlen für Videointeraktionen aus dem Werbeanzeigenmanager können ebenfalls mit der API abgefragt werden. Das folgende Diagramm zeigt einen Vergleich.

Beispielanfrage

curl GET \ -d 'access_token=<ACCESS_TOKEN>' \ -d 'fields=impressions,video_continuous_2_sec_watched_actions,actions,video_thruplay_watched_actions' \ https://graph.facebook.com/v25.0/<AD_ID>/insights

Weitere Informationen findest du in der Dokumentation zur Insights API.