Marketing API

Dynamische Medien

Dynamic Medien ermöglichen Werbetreibenden, Video-Assets aus ihrem Katalog in ihren Advantage+ Catalog Ads auszuliefern.

Bevor du beginnst

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

  • Aktuell unterstützt diese Funktion Videos für bis zu 30.000 Produkte pro Katalog.
  • 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.

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

Mithilfe der Katalog-Feed-Datei kannst du bis zu 30.000 Produkte mit produktspezifischen Video-URLs bereitstellen.

Schritt 1: Bereite deine Katalog-Feed-Datei vor

Du kannst einen 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.
  • Methode 2:
    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 ein Tag zum Video hinzufügen. Wenn du eine Tag-Spalte für den Produktpalettenfilter verwenden möchtest, musst du diese Spalte auch in die Feed-Datei aufnehmen.

Beispielformat einer Videospalte:
[{"url": "http://www.jaspersmarket.com/video-file.avi", tag: ["Optional Tag1", "Optional Tag2"]}]

Für einen XML-Feed können Video-URLs verwendet werden, indem man sie mit <video>-Tags markiert, wie zum Beispiel:

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

Videos mit der Catalog Batch API hinzufügen

Aktualisierungen von Produktartikeln werden über den /{product_catalog_id}/items_batch-Endpunkt unterstützt. Du kannst eine 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": "https://yourvideo.com/demo.mp4?q=1411"
          },
          {
            "url": "https://yourvideo.com/demo.mp4?q=1421"
          }
        ]
      }
    },
    {
      "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 zwei Methoden, bei denen Videos aus dem Katalog genutzt werden:

  • Dynamischer Medientyp (Carousel/Collection) (empfohlen)
  • Video anzeigen, wenn verfügbar (nur für einzelnes Videoformat verfügbar)

Hinweis: Die Auswahl des dynamischen Medientyps mit der API ähnelt der Auswahl der Dynamische Medien-Optionen im Werbeanzeigenmanager.

Anzeigen mit dynamischem Medientyp

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

  • Setze den media_type_automation-Schlüssel auf OPT_IN.
  • Dieser Schlüssel funktioniert mit den Formaten „Carousel“ und „Collection“.
curl \
-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/v18.0/act_<AD_ACCOUNT_ID>/adcreatives

Oder setze beim Erstellen eines Anzeigenobjekts mit dem act_<AD_ACCOUNT_ID>/ads-Endpunkt den media_type_automation-Schlüssel auf OPT_IN.

curl \
  -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/v19.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.
  • Dynamische Medien ersetzen dynamische Video-Hero-Medien nur, wenn du das aktiviert hast. 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 \
-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/v19.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 \
  -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/v19.0/act_<AD_ACCOUNT_ID>/ads