Erste Schritte mit Advantage+ Catalog Ads

Mithilfe von Advantage+ Catalog Ads kannst du personalisierte Anzeigen erstellen, die sich an die geeigneten Zielgruppen für Produktgruppen richten.

Bevor du beginnst

Zum Erstellen einer Advantage+ Catalog Ads-Kampagne benötigst du Folgendes:

• Eine Facebook-Seite, die den Werbetreibenden repräsentiert, und optional ein Instagram-Konto, wenn diese Kampagne auf Instagram läuft
• Ein Werbekonto mit registrierten Zahlungsdaten.
• Einen Katalog, z. B. einen in deinem Business Manager-Konto verfügbaren Produktkatalog.

Optional kannst du eine dynamische Produktzielgruppe festlegen. Du musst jedoch in deinen Targeting-Einstellungen keine Ein- oder Ausschlüsse für Produktauswahlen einbeziehen.

Schritt 1: Eine Werbekampagne erstellen

In der Dokumentation Werbekampagne erfährst du, wie du eine Werbekampagne erstellst.

Auf dieser Ebene musst du dein Werbeziel im Feld objective festlegen. Für Advantage+ Catalog Ads werden die Ziele PRODUCT_CATALOG_SALES, CONVERSIONS, LINK_CLICKS oder APP_INSTALLS unterstützt. Wenn du im Feld objective das Ziel CONVERSIONS, LINK_CLICKS oder APP_INSTALLS angibst, ist das Feld promoted_object nicht erforderlich.

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Schritt 2: Anzeigengruppe erstellen

Bei Advantage+ Catalog Ads musst du für deine Anzeigengruppenebene die product_set_id unter promoted_object festlegen, um Produkte aus dieser Produktgruppe hervorzuheben.

Außerdem kannst du dein eigenes Conversion-Event für die Produktpalette definieren, indem du custom_event_type unter promoted_object festlegst, wenn das optimization_goalOFFSITE_CONVERSIONS ist. Dadurch richten sich deine Anzeigen an Personen, die das Event in deiner App oder auf deiner Website ausgeführt haben.

Wenn du es auf ADD_TO_CART festlegst, heißt das, dass „In den Einkaufswagen“ das Conversion-Event ist. Standardmäßig ist custom_event_type auf PURCHASE festgelegt. Unter Meta-Pixel-Conversion Tracking erfährst du mehr über Standard-Events und Werte für custom_event_type.

So optimierst du den Wert für Offsite Conversions, einschließlich Conversions von App-Events und Facebook-Pixel, und legst die Rechnungsstellung auf „Impressions“ fest:

• Lege das optimization_goal auf OFFSITE_CONVERSIONS fest
• Lege das billing_event auf IMPRESSIONS fest

Nähere Informationen zu gültigen Kombinationen aus optimization_goal und billing_event findest du unter Optimierungsziel und Rechnungs-Events.

Ein Beispiel für das Erstellen einer Anzeigengruppe, bei der die Rechnung nach IMPRESSIONS gestellt wird und deren Wert für OFFSITE_CONVERSIONS optimiert ist:

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ "geo_locations": {"countries":["US"]}, 
    "dynamic_audience_ids": ["<DYNAMIC_AUDIENCE_ID>"] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Die DYNAMIC_AUDIENCE_ID bezieht sich auf eine Produktzielgruppe. Optional kannst du die dynamic_audience_ids im Aufruf auslassen.

Bei E-Commerce-Anwendungsfällen kannst du die dynamic_audience_ids im Aufruf auslassen und stattdessen die Informationen der auf Verhalten basierenden Zielgruppenauswahl als Teil der Parameter product_audience_specs oder excluded_product_audience_specs senden. Diese Spezifikationen werden durch dieselben Parameter festgelegt, die du zum Erstellen einer Produktzielgruppe verwendest.

Parameter

Retargeting

In diesem Beispiel richten wir uns an Personen, die in den letzten 3 bis 5 Tagen Produkte angezeigt, diese jedoch nicht gekauft haben. Die Anzeigen werden im mobilen Feed und im Audience Network platziert. So erstellst du diese Zielgruppe:

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=LINK_CLICKS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "publisher_platforms": ["facebook","audience_network"], 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"ViewContent"}}}], 
        "exclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":259200,"rule":{"event":{"eq":"ViewContent"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":<PRODUCT_SET_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Cross-Sell oder Upsell

Beispiel für die Vermarktung von Produkten, die der Benutzer nicht angezeigt hat:

curl \
-F 'name=Case 1 Adset' \
-F 'bid_amount=3000' \
-F 'billing_event=IMPRESSIONS' \
-F 'status=ACTIVE' \
-F 'daily_budget=15000' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'targeting= { \
            "geo_locations": { \
            "countries":["US"], \
             }, \
            "interests":[ \
                {"id":6003397425735,"name":"Tennis"}, \
            ], \
        }' \
-F 'promoted_object={"product_set_id”:<PRODUCT_SET_ID>}' \
-F 'access_token=<ACCESS_TOKEN>’ \
https://graph.facebook.com/<API_VERSION>/act_<ACCOUNT_ID>/adsets

So führst du Cross-Selling zwischen Produktpaletten durch:

• Lege für die Produktzielgruppe Event-Regeln im Zusammenhang mit Produktpalette A fest.
• Zeige Produkte aus Produktpalette B in der Anzeige, indem du die product_set_id auf der Ebene der Anzeigengestaltung auf Produktpalette B festlegst.

Beispielsweise möchte ein Unternehmen den Verkauf von Handtaschen in PRODUCT_SET_1 steigern, indem es mit der Anzeige auf bestehende Nutzer*innen abzielt, die ein Interesse an Schuhen der PRODUCT_SET_2 gezeigt haben. Lege die product_set_id unter product_audience_specs auf die ID von PRODUCT_SET_2 oder Schuhe fest und die product_set_id unter promoted_object auf die ID von PRODUCT_SET_1 oder Handtaschen.

curl \
  -F 'name=My cross sell ad set' \
  -F 'bid_amount=3000' \
  -F 'billing_event=LINK_CLICKS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_2_ID>", 
        "inclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"ViewContent"}}}], 
        "exclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_2_ID>", 
        "inclusions": [{"retention_seconds":259200,"rule":{"event":{"eq":"ViewContent"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_1_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets  

Und lege die product_set_id in der Werbeanzeige auf die ID von PRODUCT_SET_1 fest.

  curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Broad Audience Targeting

Zusätzlich zum Retargeting und Cross-Selling an bestehende Kund*innen können Advantage+ Catalog Ads auch dazu verwendet werden, um auf Broad Audiences abzuzielen. Dabei werden Alter, Geschlecht und andere demografische Targeting-Faktoren relevanten Produkten aus deinem Produktkatalog zugeordnet. Indem Advantage+ Catalog Ads breit gefächerte Zielgruppen mit Geboten für Offsite Conversions kombinieren, ermöglichen sie es dir, die Reichweite deiner Anzeigen erheblich auszuweiten.

So zielst du auf Broad Audiences ab:

• Erstelle eine Zielgruppe anhand von demografischem Targeting, wie zum Beispiel Frauen in den USA über 18.
• Nimm customOptimize für OFFSITE_CONVERSIONS mit stärkeren Intent-Signalen auf, wie zum Beispiel Purchase oder InitiateCheckout.

In diesem Beispiel erstellen wir eine Anzeigengruppe, die sich an US-amerikanische Frauen im Alter von 30 bis 65 richtet. Wir schließen dabei Kund*innen aus, die in den letzten 10 Tagen etwas gekauft haben. Wir bieten 8 $ und verwenden OFFSITE_CONVERSIONS für PURCHASE-Events.

curl \
  -F 'name=Broad Audience Targeting' \
  -F 'bid_amount=800' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "age_max": 65, 
    "age_min": 30, 
    "geo_locations": {"countries":["US"]}, 
    "genders": [2], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":864000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>","custom_event_type":"PURCHASE"}' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Kategorien für Advantage+ Catalog Ads

Die Kategorien für Advantage+ Catalog Ads umfassen zwei neue Optionen zur Anzeigengestaltung auf der Advantage+ Catalog Ads-Plattform. Beide Optionen können zur Personalisierung der Anzeigengestaltung für Käufer, die mit ihrer Entscheidung noch nicht so weit sind, eingesetzt werden. Mit diesem Feature kannst du im Wesentlichen einen zweiten, kleineren Katalog von Bildern für die Anzeigengestaltung zusammenstellen, in dem Bilder für die einzelnen Kategorien (zusätzlich zum Katalog der Produktbilder) enthalten sind. Wir ordnen die Produktkategorien so den Personen in deinen Anzeigen zu wie bei der Zuordnung von Produkten und Personen.

Kategorien für Advantage+ Catalog Ads können für alle Targeting-Optionen mit den Zielsetzungen Traffic, Conversion und Katalogverkäufe genutzt werden. Wenn du kein qualitativ hochwertiges Bild für jede einzelne Kategorie oder Marke hast, kann Facebook automatisch eine 2x2-Collage mit den Top-Produkten aus den einzelnen Produktgruppen erstellen.

Bei der Zuordnung des neuen Bildmaterials zu den vorhandenen Produktkatalogen kannst du eine der folgenden drei Spalten in den Feed einsetzen, um Elemente zu gruppieren: Marke, Produkttyp und Google-Produktkategorie.

Im Katalog unten z. B. weist die Spalte Produkttyp fünf eindeutige Werte auf. Die Werbetreibenden können bis zu fünf Collagen oder Lifestyle-Bilder bereitstellen – eins für jeden eindeutigen Wert in product_type. Der Produkttyp ist das Kategorisierungskriterium der Kategorie. Hierbei handelt es sich um den für die Kategoriedefinitionen verwendeten Feldnamen. Der Wert des Katalogfelds ist der Kriterienwert der Kategorie.

Eine Kategorie kann anhand der folgenden Punkte eindeutig identifiziert werden:

• Produktkatalog-ID
• Kategorisierungskriterien (Marke, Produkttyp oder Google-Produktkategorie)
• Kriterienwert (aus dem Katalog)

Du kannst die einzelnen Kategorien (z. B. die einzelnen Produktgruppen gemäß den eindeutigen Werten in den oben angegebenen Spalten) mit Elementen verknüpfen:

• Name: eine an die Nutzer*innen gerichtete Kurzbezeichnung der Kategorie (bis zu 40 Zeichen)
• Beschreibung: eine an die Nutzer*innen gerichtete Beschreibung der Kategorie (bis zu 20 Zeichen)
• destination_uri: URL der Landing Page, auf die die Nutzer*innen gelangen, wenn sie auf die Kategorie klicken
• image_url: optional. URL eines Lifestyle-Bilds für die Kategorie. Wenn du keine image_url bereitstellst, erstellen wir automatisch eine Kollage der beliebtesten Produkte in dieser Kategorie.

Während der Auslieferung der Werbeanzeigen ordnen wir den einzelnen Kontenübersichtskonten dynamisch die Kategorien zu, auf die sie mit der größten Wahrscheinlichkeit reagieren werden (auf der Grundlage der Modelle für maschinelles Lernen, auf denen heute auch die Advantage+ Catalog Ads beruhen).

API für das Kategorienmanagement

Die Kategorieinformationen werden auf Katalogebene gespeichert. Das bedeutet, dass verschiedene Werbeanzeigen für Kategorien aus demselben Katalog Elemente wie Bilder und Videos gemeinsam nutzen würden. Ebenso würden Anzeigen für Produkte auf die in den Katalogen definierten Elemente zurückgreifen. Wir unterstützen verschiedene Optionen zur Anzeigengestaltung, damit die Anzeigen individuell an die jeweiligen Kategorien angepasst werden können.

Im Folgenden sind die APIs zum Abrufen und Aktualisieren von Kategorieinformationen aufgeführt.

Lesen

Anfrage

  curl -G \
    -d 'fields=["criteria_value","name","description","destination_uri","image_url"]' \
    -d 'categorization_criteria=product_type' \
    -d 'filter={"price_amount":{"gt":1500}}' \ # optional
    -d 'access_token=<ACCESS_TOKEN>' \
    https://graph.facebook.com/v19.0/<PRODUCT_CATALOG_ID>/categories

Wir führen bei allen Produkten eine Abfrage (der optionale Filter wird unterstützt) zur Ermittlung der 1.000 wichtigsten Kategorien (aufgelistet nach Anzahl der Produkte) durch.

Beispielantwort

{
  "data": [
    {
      "criteria_value": "clothes",
      "name": "Awesome clothes",
      "description": "Check out these awesome clothes!",
      "destination_uri": "http://www.example.com/clothes",
      "image_url": "http://www.example.com/clothes.jpg"
    },
    ...
    {
      "criteria_value": "shoes",
      "name": "Awesome shoes",
      "description": "Check out these awesome shoes!",
      "destination_uri": "http://www.example.com/shoes",
      "image_url": "http://www.example.com/shoes.jpg"
    }
  ]
}

Aktualisieren

Du kannst Informationen zu mehreren Kategorien in den Daten angeben. Für jede Kategorie sind categorization_criteria und criteria_value erforderlich. Die Felder name, description, destination_uri und image_url sind dagegen optional. Wenn du zum ersten Mal die Informationen zu einer Kategorie aktualisierst, musst du die destination_uri angeben. Wenn du die Auslieferung einer Kategorie überspringen möchten, lasse einfach die zugehörige destination_uri leer.

Hinweis: Zurzeit können Kategorien nicht gelöscht werden.

Anfrage

curl \
  -F 'data=[{"categorization_criteria":"product_type","criteria_value":"product_type_value","name":"Name","description":"Description","destination_uri":"http://www.example.com/","image_url":"<IMAGE_URL>"}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<lPRODUCT_CATALOG_ID>/categories

Anzeigenerstellung

Die Erstellung einer Werbeanzeige in der Kategorie für Advantage+ Catalog Ads ist mit der für andere Advantage+ Catalog Ads vergleichbar. Allerdings unterscheidet sich die Auswahl für die Anzeigengestaltung leicht. Du wirbst für die Produktpalette weiterhin mit dynamischen Kategorie-Anzeigen. Der Unterschied besteht darin, dass wir stattdessen Anzeigengestaltungen für die Kategorien zeigen.

curl \
  -F "name=Dynamic Category Ad Creative" \
  -F 'object_story_spec={"page_id": "<PAGE_ID>", "template_data": {"description": "{{category.description}}", "link": "https://www.example.com/", "message": "<MESSAGE>", "name": "{{category.name}}"}}' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'categorization_criteria=brand' \
  -F 'category_media_source=MIXED' \ # optional
  -F access_token=<ACCESS_TOKEN> \
  https://graph.facebook.com/v19.0/act_<ACCOUNT_ID>/adcreatives

Hiermit wird eine Anzeigengestaltung im Carousel-Format für eine Kategorie erstellt:

Kategorietoken

Unterstützte Kategorietoken:

• category.name: die Kategoriebezeichnung innerhalb der beworbenen Produktpalette
• category.description: die Kategoriebeschreibung innerhalb der beworbenen Produktpalette
• category.destination_uri: die Ziel-URL der Kategorie
• category.min_price: der Mindestpreis für diese Kategorie innerhalb der beworbenen Produktpalette Diese Informationen werden aus dem Katalog übernommen.

Parameter

Name	Beschreibung
categorization_criteria	Gibt an, welcher Kategorietyp verwendet werden soll. Werte: brand product_type google_product_category
category_media_source	Hier wird angegeben, wie die Karussell-Karte der Kategorie gerendert werden soll. Werte: mixed (Standard) : verwendet, falls vorhanden, das Bild der Kategorie; ansonsten wird auf products_collage zurückgegriffen. category : verwendet das Bild der Kategorie. Diese Kategorie überspringen, wenn kein Bild vorhanden ist. products_collage : generiert eine 2x2-Collage aus Produktbildern dieser Kategorie. products_slideshow : rendert eine Slideshow der Produkte aus dieser Kategorie.

Während der Anzeigengestaltung für die Kategorie suchen wir nach möglichen renderbaren Kategorien.

Hinweis: Kategorien ohne Namen oder Ziel-URL werden herausgefiltert. Kategorien ohne Bilder werden ebenfalls herausgefiltert (falls category_media_source = category).

Häufige Fehler

Die Anzeigengestaltung funktioniert nicht, wenn weniger als vier infrage kommende Kategorien vorhanden sind (zum Beispiel müssen zur Verwendung von Kategorien für Advantage+ Catalog Ads für die Anzeigengestaltung bei einer bestimmten Kampagne mindestens vier eindeutige Werte in einer bestimmten Spalte aus der Datenfeed-Datei vorhanden sein).

Schritt 3: Anzeigengestaltung bereitstellen

Advantage+ Catalog Ads-Vorlagen verwenden Inline-Seitenbeiträge zur Erstellung von Vorlagen für die Advantage+ Catalog-Anzeigengestaltung.

Eine Vorlage für die Anzeigengestaltung erstellen

Eine Vorlage für die Anzeigengestaltung bei Advantage+ Catalog Ads wird ähnlich erstellt wie alle anderen Anzeigengestaltungen. Der Unterschied besteht darin, dass du Vorlagenparameter hinzufügen kannst, die basierend auf den Daten in deiner Datenfeed-Datei zur Laufzeit generiert werden.

Erstelle die Vorlage auf der Grundlage des Objekts template_data der object_story_spec und nutze die folgenden Felder:

Beispiele

Eine Vorlage für Advantage+ Catalog Ads im Carousel-Format erstellen

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Eine Advantage+ Catalog Ads-Vorlage mit Bild-Overlays verwenden

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}",
      "image_layer_specs": [
        {
          "layer_type": "image",
          "image_source": "catalog"
        },
        {
          "layer_type": "frame_overlay",
          "blending_mode": "lighten",
          "frame_image_hash": "<HASH>",
          "frame_source": "custom",
          "opacity": 100,
          "overlay_position": "center",
          "scale": 100
        },
        {
          "layer_type": "text_overlay",
          "content": {
            "type": "price"
          },
          "opacity": 100,
          "overlay_position": "top_left",
          "overlay_shape": "rectangle",
          "shape_color": "DF0005",
          "text_color": "FFFFFF",
          "text_font": "open_sans_bold"
        }
      ]
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Eine Advantage+ Catalog Ads-Vorlage für ein einzelnes Produkt mit einem Call to Action erstellen

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "force_single_link": true, 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Eine Vorlage für Advantage+ Catalog Ads im Carousel-Format erstellen, bei der das Anzeigenbild das erste Bild des Arrays der zusätzlichen Bilder verwendet

Um eine Vorschau von Advantage+ Catalog Ads mit additional_image_index anzuzeigen, musst du die gesamten object_story_spec an den Endpunkt /generatepreviews übergeben. Wenn du nur die object_story_id übergibst, wird dadurch keine Vorschau erstellt.

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "additional_image_index": 0, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Eine Advantage+ Catalog Ads-Vorlage im Carousel-Format für ein einzelnes Produkt erstellen, wobei jedes Bild aus dem Array der zusätzlichen Bilder im Katalog stammt

curl -X POST \
     -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
     -F 'object_story_spec={
           "page_id": <PAGE_ID>,
           "template_data": {
             "message": "Test {{product.name | titleize}}",
             "link": "<YOUR_LINK_URL>",
             "name": "Headline {{product.price}}",
             "description": "Description {{product.description}}",
             "multi_share_end_card": false,
             "force_single_link": true,
             "show_multiple_images": true,
           }
         }' \
     -F 'product_set_id=<PRODUCT_SET_ID>' \
     -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Eine Advantage+ Catalog Ads-Vorlage im Carousel-Format erstellen, bei der die erste Karte eine statische Coupon-Karte ist

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "child_attachments": [ 
        { 
          "call_to_action": {"type":"SHOP_NOW"}, 
          "description": "30% off", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/coupon", 
          "name": "Coupon Static Card", 
          "static_card": true 
        }, 
        { 
          "call_to_action": {"type":"SHOP_NOW"}, 
          "description": "Description {{product.description}}", 
          "name": "Headline {{product.price}}" 
        } 
      ], 
      "link": "<LINK>", 
      "message": "Test Message" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Eine Carousel-Slideshow anhand der Vorlage für Advantage+ Catalog Ads erstellen

Wir rendern jede dynamische Karte im Carousel als Slideshow. Jede Slideshow zeigt Bilder aus einem dynamischen Artikel an, wenn der Artikel mehrere Bilder besitzt. Wenn der dynamische Artikel nur ein Bild besitzt, rendern wir eine Karte als statisches Bild.

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={
    "page_id": "PAGE_ID",
    "template_data": {
      "call_to_action": {"type":"SHOP_NOW"},
      "description": "Description {{product.description}}",
      "link": "LINK",
      "message": "Test {{product.name | titleize}}",
      "name": "Headline {{product.price}}",
      "format_option": "carousel_slideshows"
    }
  }' \
  -F 'product_set_id=PRODUCT_SET_ID' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Als Antwort auf solche Aufrufe erhältst du die ID einer neuen Vorlage für die Advantage+ Catalog Ads-Anzeigengestaltung.

{"id":"creative_id"}

Einen Katalog hochladen

Beim Hochladen eines Katalogs kannst du für jedes Bild in jeder Eigenschaft beliebige alphanumerische String-Tags angeben.

<listing>
 <hotel_id>hotel_1</hotel_id>
 ...
 <image>
 <url>https://media-cdn.tripadvisor.com/media/photo-o/05/ca/40/af/the-epiphany-a-joie-de.jpg (https://l.facebook.com/l.php?u=https%3A%2F%2Fmedia-cdn.tripadvisor.com%2Fmedia%2Fphoto-o%2F05%2Fca%2F40%2Faf%2Fthe-epiphany-a-joie-de.jpg&h=ATPTuLcCa7Vsnmn07cEVa0YseTFl1C2hOax9NezejmXDbR48w3CLdjLlwlpuGCRDQmuafQvk03ybGqfhk-2mBcH7xtuKAsnuuq9xKwBd8DwfuBMZkq3n1qX5MdychRKGy2bo2ax9BZQzgqVDY_AvC1EqE6aAdUEc)</url>
 <tag>exterior</tag>
 <tag>first image</tag>
 <tag>tree</tag>
 </image>
 <image>
 <url>http://www3.hilton.com/resources/media/hi/DFWANHH/en_US/img/shared/full_page_image_gallery/main/HH_exteriorview001_1270x560_FitToBoxSmallDimension_Center.jpg (http://l.facebook.com/l.php?u=http%3A%2F%2Fwww3.hilton.com%2Fresources%2Fmedia%2Fhi%2FDFWANHH%2Fen_US%2Fimg%2Fshared%2Ffull_page_image_gallery%2Fmain%2FHH_exteriorview001_1270x560_FitToBoxSmallDimension_Center.jpg&h=ATPTuLcCa7Vsnmn07cEVa0YseTFl1C2hOax9NezejmXDbR48w3CLdjLlwlpuGCRDQmuafQvk03ybGqfhk-2mBcH7xtuKAsnuuq9xKwBd8DwfuBMZkq3n1qX5MdychRKGy2bo2ax9BZQzgqVDY_AvC1EqE6aAdUEc)</url>
 <tag>skyline</tag>
 ...
 </image>
 ...
</listing>

Eine Anzeigengestaltung erstellen

Bei der Anzeigengestaltung kann ein Array von preferred_image_tags in den object_story_spec übergeben werden.

curl \
 -F 'name=Ad Creative Test'\
 -F 'object_story_spec={
     "page_id": '<PAGE_ID>',
     "template_data": {
       "preferred_image_tags": ["skyline","exterior"],
       "call_to_action": {"type":"BOOK_TRAVEL"},
       "description": "{{hotel.description}}",
       "link": "<URL>",
        "message": "Book your stay in {{hotel.city}}",
        "name": "{{hotel.name | titleize}}"
     }
    }' \
 -F 'product_set_id=<PRODUCT_SET_ID>' \
 -F 'access_token=<ACCESS_TOKEN>' \
 https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Video für Advantage+ Catalog Ads aktivieren

Die Hauptschritte zur Erstellung von Advantage+ Catalog Ads sind gleich geblieben. Zur Aktivierung von Video musst du Videodaten im Katalog bereitstellen. Unten sind die notwendigen Änderungen bei der Erstellung bzw. Aktualisierung von Katalogen aufgeführt.

Schritt 1: Einen Katalog einrichten

Wenn du die Liste um „Video“ erweiterst, werden die Felder url und tag unterstützt. Zurzeit wird pro Produkt nur ein Video unterstützt.

<?xml version="1.0" encoding="utf-8"?>
<listings>
  <title>Test hotel feed</title>
  <listing>
    <hotel_id>hotel_1</hotel_id>
    <name>Test Hotel 1</name>
    <description>A very nice hotel</description>
    <brand>Facebook</brand>
    <address format="simple">
      <component name="addr1">180 Hamilton Ave</component>
      <component name="city">Palo Alto</component>
      <component name="city_id">12345</component>
      <component name="region">California</component>
      <component name="postal_code">94301</component>
      <component name="country">United States</component>
    </address>
    <latitude>37.4435997</latitude>
    <longitude>-122.1615219</longitude>
    <neighborhood>Palo Alto</neighborhood>
    <neighborhood>Silicon Valley</neighborhood>
    <margin_level>8</margin_level>
    <base_price>200.5 USD</base_price>
    <phone>+1 650 666-3311</phone>
    <star_rating>2.5</star_rating>
    <guest_rating>
      <score>7.8</score>
      <rating_system>tripAdvisor</rating_system>
      <number_of_reviewers>300</number_of_reviewers>
    </guest_rating>
    <guest_rating>
      <score>9.8</score>
      <rating_system>Hotels.com</rating_system>
      <number_of_reviewers>35000</number_of_reviewers>
    </guest_rating>
    <image>
      <url>https://media-cdn.tripadvisor.com/media/photo-o/05/ca/40/af/the-epiphany-a-joie-de.jpg</url>
      <tag>front view</tag>
      <tag>first image</tag>
    </image>
    <image>
      <url>http://www.jdvhotels.com/content/uploads/2014/06/72-1200x800.jpg</url>
      <tag>room</tag>
      <tag>bed</tag>
    </image>
    <loyalty_program>Starwood</loyalty_program>
    <url>http://www.jdvhotels.com/hotels/california/silicon-valley-hotels/the-epiphany-hotel/</url>
    <applink property="ios_url" content="example-ios://electronic"/>
    <applink property="ios_app_store_id" content="42"/>
    <applink property="ios_app_name" content="Electronic Example iOS"/>
*    <video>
      <url>http://example.com/some_video1.mp4</url>
      <tag>City</tag>
      <tag>Package</tag>
    </video>*
  </listing>
</listings>

Spezifikationen für Videos

Schritt 2: Die API verwenden, um Video-Metadaten für die Fehlerbehebung zu erhalten

Mit der API kannst du die hochgeladenen Daten prüfen. Lass bei jedem Element die Abfrage der „Video-Metadaten“ zu.

Anfrage

curl -i -X GET \
 "https://graph.intern.facebook.com/v19.0/1234567890?fields=videos_metadata.fields(video,tags,url)&access_token=<ACCESS TOKEN>"

Beispielantwort

Schritt 3: Das Video in der Anzeigengestaltung oder Anzeige aktivieren

Informationen zur Aktivierung von Videoinhalten in Anzeigen auf Produktebene findest du in der Dokumentation zur Anzeigenerstellung mit dynamischen Medien.

Klick-Tracking und Vorlagen

Wenn du Link-Klicks durch den Klick-Tracker eines Drittanbieters verfolgst, bevor die Person zur finalen Produkt-URL weitergeleitet wird, kannst du das Feld template_url_spec in der Anzeigengestaltung verwenden. Dadurch kannst du eine Klick-Tracker-Vorlage zur Anzeigenebene hinzufügen, ohne sie in deine Datenfeed-Datei codieren zu müssen. Du kannst dieses Feld auch zum Erstellen von Vorlagen für Deep Links verwenden.

In diesem Feld kannst du dynamische Felder wie Produkt-URL oder -ID verwenden. Diese sollten URL-kodiert werden, wenn ihre Werte möglicherweise Zeichen enthalten, die die URL ungültig machen.

Beispiel

Erstellen einer Advantage+ Catalog Ads-Anzeige im Carousel-Format mit der Einstellung template_url_spec:

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<URL>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'template_url_spec={ 
    "ios": { 
      "app_store_id": "123", 
      "url": "example:\/\/link\/?nav=item.view&id={{product.retailer_id | urlencode}}&referrer=http:\/\/rover.example.com\/rover\/1\/711-198453-24755-9\/16%3Fitemid={{product.retailer_id | urlencode | urlencode}}" 
    }, 
    "web": { 
      "url": "http:\/\/clicktrack.com\/cm325?id={{product.retailer_id | urlencode}}&redirect_url={{product.url | urlencode | urlencode}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Datenfeed-Datei in deiner Vorlage verwenden

Wenn eine Anzeige angezeigt wird, ersetzt Facebook den Inhalt im Abschnitt {{ }} mit den entsprechenden Werten in deiner Datenfeed-Datei. Folgende Vorlagenwerte sind verfügbar:

Optionen

Einige Vorlagenwerte erhalten möglicherweise Optionen in beliebiger Reihenfolge im folgenden Format:

{{field option1 option2 ...}}

Die folgenden Optionen sind verfügbar:

Transformationen

Du kannst Vorlagenwerte mit Transformationen verwenden, wodurch dein Wert anhand dieses Formats angepasst wird:

{{field | transform}}

Verwende eine der folgenden Transformationen:

Das gewünschte Verhalten beim Klicken auf Anzeigen auf Mobilgeräten festlegen

Wenn du eine dynamische Anzeigengestaltung anzeigst, kannst du das gewünschte Verhalten beim Klicken auf die Anzeige in der nativen Facebook-App festlegen. Es gibt zwei Voraussetzungen für die Verwendung von Deep Links:

1. Die native mobile App, zu der Nutzer*innen weitergeleitet werden sollen, unterstützt Deep Links (iOS oder Android).
2. Die Informationen zu Deep Links wurden zur Datenfeed-Datei hinzugefügt. Alternativ sind Deep Link-Informationen über App-Links verfügbar.

Wenn beide Voraussetzungen erfüllt sind, kannst du das Feld applink_treatment bei der Anzeigengestaltung verwenden, um das gewünschte Verhalten beim Klicken auf eine Anzeige festzulegen.

Beispiele

Erstellen einer Vorlage für Advantage+ Catalog Ads im Carousel-Format mit Call to Action, die per Deep Link zu einer nativen App leitet, falls verfügbar, oder zurück zum Web leitet:

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'applink_treatment=deeplink_with_web_fallback' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Erstellen einer Vorlage für Advantage+ Catalog Ads im Carousel-Format mit aktivierten URL-Tags, die per Deep Link zu einer nativen App leitet, falls verfügbar, oder zurück zum App Store für die App leitet:

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'applink_treatment=deeplink_with_appstore_fallback' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Einen lokalisierten Katalog für Advantage+ Catalog Ads erstellen

Weitere Details findest du unter Lokalisierter Katalog für Advantage+ Catalog Ads.

Schritt 4: Werbeanzeige erstellen

Jetzt kannst du eine Anzeige erstellen. Die Anzeige bezieht sich auf eine Anzeigengestaltung.

Beispiel

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const AdAccount = bizSdk.AdAccount;
const Ad = bizSdk.Ad;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_ACCOUNT_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'name' : 'My Ad',
  'adset_id' : '<adSetID>',
  'creative' : {'creative_id':'<adCreativeID>'},
  'status' : 'PAUSED',
};
const ads = (new AdAccount(id)).createAd(
  fields,
  params
);
logApiCallResult('ads api call complete.', ads);

require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\Ad;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<AD_ACCOUNT_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'name' => 'My Ad',
  'adset_id' => '<adSetID>',
  'creative' => array('creative_id' => '<adCreativeID>'),
  'status' => 'PAUSED',
);
echo json_encode((new AdAccount($id))->createAd(
  $fields,
  $params
)->exportAllData(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adaccount import AdAccount
from facebook_business.adobjects.ad import Ad
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'name': 'My Ad',
  'adset_id': '<adSetID>',
  'creative': {'creative_id':'<adCreativeID>'},
  'status': 'PAUSED',
}
print AdAccount(id).create_ad(
  fields=fields,
  params=params,
)

import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<AD_ACCOUNT_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdAccount(id, context).createAd()
      .setName(\"My Ad\")
      .setAdsetId(<adSetID>L)
      .setCreative(
          new AdCreative()
            .setFieldId(\"<adCreativeID>\")
        )
      .setStatus(Ad.EnumStatus.VALUE_PAUSED)
      .execute();

  }
}

require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_ACCOUNT_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

ad_account = FacebookAds::AdAccount.get(id)
ads = ad_account.ads.create({
    name: 'My Ad',
    adset_id: '<adSetID>',
    creative: {'creative_id':'<adCreativeID>'},
    status: 'PAUSED',
})

Herzlichen Glückwunsch! Du hast deine erste Advantage+ Catalog Ad erstellt. Aktiviere die Anzeige, damit sie die Auslieferung aufnimmt.

Nächste Schritte

Advantage+ Catalog Ads in der Vorschau anzeigen

Mit der Ad Previews API kannst du Vorschauen deiner dynamischen Anzeigengestaltung erstellen. Lege einen Wert für den Parameter product_item_ids fest oder gib mehrere product_item_ids an, um die Vorschau für eine Carousel Ad anzuzeigen.

curl -X GET \
  -d 'ad_format="DESKTOP_FEED_STANDARD"' \
  -d 'product_item_ids=[
       "<PRODUCT_ITEM_ID>"
     ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CREATIVE_ID>/previews

'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const AdCreative = bizSdk.AdCreative;
const AdPreview = bizSdk.AdPreview;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_CREATIVE_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'ad_format' : 'DESKTOP_FEED_STANDARD',
  'product_item_ids' : ['<productItemID>'],
};
const previewss = (new AdCreative(id)).getPreviews(
  fields,
  params
);
logApiCallResult('previewss api call complete.', previewss);

require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\AdCreative;
use FacebookAds\Object\AdPreview;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<AD_CREATIVE_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'ad_format' => 'DESKTOP_FEED_STANDARD',
  'product_item_ids' => array('<productItemID>'),
);
echo json_encode((new AdCreative($id))->getPreviews(
  $fields,
  $params
)->getResponse()->getContent(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adcreative import AdCreative
from facebook_business.adobjects.adpreview import AdPreview
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_CREATIVE_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'ad_format': 'DESKTOP_FEED_STANDARD',
  'product_item_ids': ['<productItemID>'],
}
print AdCreative(id).get_previews(
  fields=fields,
  params=params,
)

import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<AD_CREATIVE_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdCreative(id, context).getPreviews()
      .setAdFormat(AdPreview.EnumAdFormat.VALUE_DESKTOP_FEED_STANDARD)
      .setProductItemIds(\"[\\"<productItemID>\\"]\")
      .execute();

  }
}

require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<AD_CREATIVE_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

ad_creative = FacebookAds::AdCreative.get(id)
previewss = ad_creative.previews({
    fields: {  },
    ad_format: 'DESKTOP_FEED_STANDARD',
    product_item_ids: ['<productItemID>'],
})

Parameter

Abrufen von Statistiken zu Produktanzeigen

Du kannst Statistiken pro Produkt abrufen, indem du einen GET-Aufruf an den Endpunkt Insights sendest. Füge product_id zum Parameter fields hinzu.

Dadurch werden Statistiken für alle Produkte in den Produktpaletten eines Kontos abgerufen, die in Advantage+ Catalog Ads angezeigt wurden.

Beispiel

Dieses Beispiel meldet clicks, actions und impressions für jede product_id.

Anfrage

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\Fields\AdsInsightsFields;
use FacebookAds\Object\Values\AdsInsightsActionBreakdownsValues;
use FacebookAds\Object\Values\AdsInsightsDatePresetValues;
use FacebookAds\Object\Values\AdsInsightsBreakdownsValues;

$account = new AdAccount('act_<AD_ACCOUNT_ID>');

$fields = array(
  AdsInsightsFields::ACCOUNT_NAME,
  AdsInsightsFields::IMPRESSIONS,
  AdsInsightsFields::ACTIONS,
);

$params = array(
  'date_preset' => AdsInsightsDatePresetValues::LAST_WEEK,
  'action_breakdowns' => array(
    AdsInsightsActionBreakdownsValues::ACTION_TYPE,
  ),
  'breakdowns' => array(
    AdsInsightsBreakdownsValues::PRODUCT_ID,
  ),
);

$stats = $account->getInsights($fields, $params);

from facebookads.adobjects.adaccount import AdAccount
from facebookads.adobjects.adsinsights import AdsInsights

account = AdAccount('act_<AD_ACCOUNT_ID>')

fields = [
    AdsInsights.Field.account_name,
    AdsInsights.Field.impressions,
    AdsInsights.Field.actions,
]

params = {
    'date_preset': 'last_week',
    'actions_group_by': ['action_type'],
    'breakdowns': [
        AdsInsights.Breakdowns.product_id,
    ],
}

stats = account.get_insights(fields=fields, params=params)

APINodeList<AdsInsights> adsInsightss = new AdAccount(act_<AD_ACCOUNT_ID>, context).getInsights()
  .setDatePreset(AdsInsights.EnumDatePreset.VALUE_LAST_WEEK)
  .setActionBreakdowns("[\"action_type\"]")
  .setBreakdowns("[\"product_id\"]")
  .requestField("account_name")
  .requestField("impressions")
  .requestField("actions")
  .execute();

curl -G \
  -d 'date_preset=last_week' \
  -d 'action_breakdowns=["action_type"]' \
  -d 'breakdowns=["product_id"]' \
  -d 'fields=account_name,impressions,actions' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.8/act_<AD_ACCOUNT_ID>/insights

Antwort

{
 "data": [ 
   {
      "account_id": "123456", 
      "product_id": "60750", 
      "date_start": "2015-02-03", 
      "date_stop": "2015-02-03", 
      "impressions": 880, 
      "clicks": 8, 
      "actions": [ 
        {
          "action_type": "link_click", 
          "value": 6
        }, 
        {
          "action_type": "offsite_conversion.other", 
          "value": 5
        },  
        {
          "action_type": "offsite_conversion", 
          "value": 5
        }
      ], 
      "account_name": "My Account"
    }, 
 ], 
...
}

Abrufen von Kommentaren und „Gefällt mir“-Angaben

Du kannst die Kommentare und „Gefällt mir“-Angaben sowie die product_id für einen Advantage+ Catalog Ads-Beitrag abrufen. Führe wie folgt einen GET-Aufruf mit einer post_id durch. Die post_id ist die effective_object_story_id einer Anzeigengestaltung im Format PageID_PostID.

Hinweis: Du kannst diesen Endpunkt nicht verwenden, um Kommentare aus Instagram abzurufen.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<POST_ID>/dynamic_posts

Dieser Endpunkt gibt dynamische Beitragsobjekte zurück.

Wenn du dynamische Beiträge erhältst, kannst du ggf. comments, likes, product_id und child_attachments für das Carousel-Format abrufen.

Mehr dazu

• Katalog einrichten
• Erstellen von Zielgruppen
• Referenz zur Anzeigengruppe
• Referenz zur Anzeigengestaltung
• Meta Blueprint-Kurs: Katalog für Advantage+ Catalog Ads vorbereiten und einrichten, Blueprint
• Meta Blueprint-Kurs: Probleme mit Katalog für Advantage+ Catalog Ads beheben
• Meta Blueprint-Live-Training: Probleme mit Katalog für Advantage+ Catalog Ads beheben