Collection Ads

Das Anzeigenformat „Collection“ beinhaltet eine Instant Experience und erleichtert das Entdecken, Durchstöbern und Kaufen von Produkten und Dienstleistungen auf Mobilgeräten auf visuelle und immersive Art und Weise. Deine Anzeige im Feed stellt drei Produkte unter einem Hero Image oder Video vor, das in einer Instant Experience im Vollbildmodus geöffnet wird, wenn jemand mit der Anzeige interagiert. Es gibt zwei Arten von Collection Ads: bildbasiert und videobasiert.

Alle Verweise auf „Canvas“ stehen für Instant Experience, da dieses Format früher als Canvas bezeichnet wurde.

Du kannst eine Anzeige mit dem Collection-Format erstellen, indem du eine Instant Experience aufbaust. Beginne mit einer Vorlage oder verwende dein eigenes Layout. Mehr dazu erfährst du unter Hilfebereich für Werbung, Instant Experience.

Du kannst auch die Benutzeroberflächen zur Anzeigenerstellung von Facebook für das Collection-Format in deine Website aufnehmen, indem du mit dem JavaScript-SDK einen Collections Ads-Dialog erstellst.

Allgemeine Informationen zur Nutzung von Collections findest du in den folgenden Ressourcen:

Mehr über das Erstellen von Collections, die in Shops verwendet werden, und das Hinzufügen von Metadaten zu einer Produktpalette findest du unter Handelsplattform, Product Set Collection API.

For API calls, your AD_ACCOUNT_ID should be formatted as act_XXXXXXXXXXXXXXX.

Unterstützte Ziele und Platzierungen

Du kannst Collection Ads mit den folgenden Zielen verwenden:

  • Traffic
  • Conversions
  • Produktkatalogverkäufe (Wird unterstützt, wenn du Collections mit einer Produktpalette verwendest.)
  • Besuche im Store (Wird unterstützt, wenn du Collections mit einer Produktpalette verwendest.)
  • Markenbekanntheit
  • Reichweite

Für die Ziele „Traffic“ und „Conversions“ kannst du auch Slideshow-Videos verwenden. Weitere Informationen findest du im Hilfebereich für Unternehmen: Auswählen des richtigen Werbeziels.

Die folgenden Platzierungen werden unterstützt:

Weitere Informationen zu Platzierungen findest du im Hilfebereich für Unternehmen: Info über Platzierungen und Hilfebereich für Unternehmen: Verfügbare Anzeigenplatzierungen für Marketing-Ziele.

Collection Ads aus Produktpaletten

Bevor du eine Collection Ad erstellst, musst du eine Anzeigengestaltung und Instant Experience bereitstellen. Du musst mindestens vier Elemente bereitstellen, die Fotos darstellen, oder vier Elemente, die Produkte mit Produkt-Tags darstellen, die abwechselnd angezeigt werden sollen. Untergeordnete Fotoelemente in einem Carousel-Element sind ebenfalls möglich.

Erstelle Collection Ads aus deinem Katalog. Eine Collection Ad umfasst drei Produkte unter einem Hero Image oder Video und wird im mobilen Feed angezeigt. Du kannst für diese Funktion auch Slideshow-Videos verwenden.

Die Werbeanzeige erscheint im Feed. Wenn Betrachter auf die Werbeanzeige tippen, wird ein Vollbild mit mehr Infos angezeigt.

Um eine Produktpalette zu verwenden, solltest du mit Advantage+ Catalog Ads vertraut sein und bereits einen Produktkatalog eingerichtet haben. Mehr Infos dazu findest du unter Advantage+ Catalog Ads und Advantage+ Catalog Ads, Produktkatalog.

Erstellen von Werbeanzeigen

Wenn du eine Collection Ad aus Produktpaletten erstellst, musst du auch ausdrücklich eine Instant Experience mit den richtigen Elementen erstellen. Wenn du diese Instant Experience in einer Collection Ad verwendest, erstellt Facebook die Collection Ad automatisch. Deine Instant Experience muss Folgendes beinhalten:

Das Instant Experience-Bild

Erstelle eine Instant Experience mit einem Bild:

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

Oder erstelle eine Instant Experience mit einem Video:

curl \
  -F 'canvas_video={ 
    "video_id": "VIDEO_ID", 
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

Oder erstelle eine Instant Experience mit einem Vorlagenvideo:

curl -X POST \
  -F canvas_template_video={
      "name": "Cover Image or Video",
	"bottom_padding": "0",
	"top_padding": "0",
	"product_set_id": <Product_Set_ID>,
	"template_video_spec": {
	    "customization": {
	        "text_color": "FFFFFF",
	        "text_background_color": "000000",
		  "name_template": "{{product.name}}",
		  "body_template": "{{product.current_price strip_zeros}}"
	    },
	}
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<PAGE_ID>/canvas_elements

Die Instant Experience-Produktpalette

Dann erstellst du ein canvas_product_set mit einer product_set_id aus deinem Produktkatalog. Du musst show_in_feed auf true setzen, um eine Collection Ad zu erstellen.

curl \
  -F 'canvas_product_set={ 
    "max_items": 50,
    "product_set_id": "<PRODUCT_SET_ID>",
    "item_headline": "{{product.name}}",
    "item_description": "{{product.current_price}}"
    "image_overlay_spec": {
      "overlay_template": "pill_with_text",
      "text_type": "price",
      "text_font": "dynads_hybrid_bold",
      "position": "top_left",
      "theme_color": "background_e50900_text_ffffff",
      "float_with_margin": true,
    },
    "storefront_setting": {
        "enable_sections": true,
        "customized_section_titles": [
            { "title_id": "popular", "customized_title": "My Populars" },
            { "title_id": "favorites", "customized_title": "My Favorites" }
        ],
        "product_set_layout": {
            "layout_type": "GRID_3COL"
        }
    },
    "retailer_item_ids": [0, 0, 0],
    "show_in_feed": true
  }' \
  https://graph.facebook.com/v19.0/<PAGE_ID>/canvas_elements

Hinweis: Im Beispiel oben sind item_headline, item_description, image_overlay_spec, storefront_setting und retailer_item_ids optionale Felder. In der Vergangenheit hast du diese in demselben Aufruf bereitgestellt, um die Collection Ad und das zugrunde liegende Instant Experience-Element zu erstellen. Jetzt stellst du sie in diesem Aufruf bereit.

Stelle alle Pflichtfelder im image_overlay_spec-Parameter bereit. Mehr dazu erfährst du unter Marketing API, Referenz, Anzeigengestaltungs-Linkdaten, Bild-Overlay-Spezifikation.

Der Parameter storefront_setting unterstützt die Felder product_set_layout, enable_sections und customized_section_titles.

Die product_set_layout-Felder
NameBeschreibung

layout_type

String

Erforderlich.. Wie die Produktpalette angezeigt wird.
Werte:GRID_2COL, GRID_3COL, CAROUSEL, HSCROLL_LIST

Um customized_section_titles verwenden zu können, muss enable_sections auf true festgelegt sein. Das Feld customized_section_titles erwartet ein Array mit Objekten, jeweils mit den Parametern title_id und customized_title.

Die customized_section_titles-Felder
NameBeschreibung

title_id

String

Erforderlich.
Enum-String, der für den Standardabschnittstitel steht, den du ersetzen möchtest.
Werte:keep_shopping, take_another_look, you_may_also_like, related_products, trending, popular, top_items, favorites, most_viewed, top_picks_for_you, suggested_for_you, featured_favorites, just_for_you, explore_more, shop_by_category

customized_title

String

Erforderlich.
Alternativer benutzerdefinierter String, den der*die Betrachter*in als Abschnittstitel sieht.

Die Instant Experience-Fußzeile

Erstelle die Instant Experience-Fußzeile mit einem Link.

curl \
  -F 'canvas_button={ 
    "rich_text": {
      "plain_text": "See more at www.abc.com."
    },
    "open_url_action": {
      "url": "https://www.abc.com"
    }
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

Du kannst auch einen Button erstellen, den du in der Fußzeile verwendest.

curl \
  -F 'canvas_footer={ 
    "child_elements": [BUTTON_ELEMENT_ID]
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

Der Text, den du in deiner Fußzeile angibst, ist variierbar. Früher musstest du See more.... bereitstellen, aber jetzt kannst du benutzerdefinierten Text mit dem Button URL angeben.

Die vollständige Instant Experience

curl \
  -F 'body_element_ids=[
    PHOTO/VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'is_published=true' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvases

Um die Instant Experience mit einem Vorlagenvideo, einer Produktpalette, einem Button, einem Store-Standort und einer von dir eingerichteten optionalen Fußzeile zu erstellen, musst du den Parameter source_template_id mit aufnehmen:

curl \
  -F 'body_element_ids=[
    TEMPLATE_VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'name="Dynamic Video Instant Experience"', \
  -F 'source_template_id="1932289657009030"', \
  -F 'is_published=true' \
  https://graph.facebook.com/v19.0/<PAGE_ID\/canvases

Für eine Storefront-Vorlage musst du source_template_id = 1932289657009030 festlegen. Sie ist unter Instant Experiences, Vorlagen verwenden definiert. Das Layout für jede Vorlage ist festgelegt. Du kannst aber den Standardinhalt durch deine eigenen dynamischen Videos, Produkte, Texte und Links ersetzen. Mehr dazu erfährst du unter Instant Experiences, Vorlagen verwenden.

Die Collection Ad mit der Instant Experience erstellen

Schließlich musst du eine Collection Ad erstellen. Dadurch können Nutzer über deine Collection Ad auf deine Bilder oder Videoelemente klicken.

Wenn das erste Element deiner Instant Experience ein Foto ist, musst du object_type auf SHARE setzen.

curl \
  -F 'name=Collection Sample Image Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "link": "https://fb.com/canvas_doc/CANVAS_ID", 
      "message": "AD_MESSAGE",
      "name": "AD_HEADLINE", 
    }, 
    "page_id": "PAGE_ID" 
  }' \
  -F 'object_type=SHARE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Wenn das erste Element deiner Instant Experience ein Video ist, stelle diese Anfrage:

curl \
  -F 'name=Collection Sample Video Creative' \
  -F 'object_story_spec={ 
    "video_data": {
      "call_to_action": {
        "type":"LEARN_MORE",
        "value":{
          "link":"https://fb.com/canvas_doc/CANVAS_ID",
        }
      },
      "image_url": "THUMBNAIL_IMAGE_URL",
      "message": "AD_MESSAGE",
      "title": "AD_HEADLINE", 
    }, 
    "page_id": "PAGE_ID" 
  }' \
  -F 'object_type=VIDEO' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Wenn das erste Element deiner Instant Experience ein Vorlagenvideo ist, stelle diese Anfrage:

curl -X POST \
  -F 'name="Dynamic Video Collection Ad"' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'status=PAUSED \
  -F 'creative={
       "object_story_spec": {
         "instagram_actor_id": "<INSTAGRAM_PAGE_ID>",
         "page_id": "<MAIN_PAGE_ID>",
         "template_data":{
           "call_to_action":{
             "type":"LEARN_MORE"
           },
           "format_option":"collection_video",
           "link":"https://fb.com/canvas_doc/CANVAS_ID",   
           "name":"Test Dynamic Ads with dynamic video",
           "retailer_item_ids":[
             "0",
             "0",
             "0",
             "0"
           ]
         }
       },
       "object_type": "SHARE",
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

Anzeigenvorschau

Falls du die Anzeigenvorschau-Funktion hast, kannst du ein ad_format und Nutzerzugriffsschlüssel bereitstellen, um eine Vorschau basierend auf deiner Werbeanzeige oder deiner Anzeigengestaltung zu generieren.

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

Hinweis: Die unterstützten Formate für Instant Experience-Werbeanzeigen mit Vorlagenvideos sind BIZ_DISCO_FEED_MOBILE, GROUPS_MOBILE, MOBILE_FEED_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE und WATCH_FEED_MOBILE.

Weitere Informationen dazu findest du unter Anzeigenvorschau.

Standard-Collection Ads

Mit einer Vorlage kannst du schnell eine Instant Experience für ein bestimmtes Geschäftsziel erstellen. Das Layout für jede Vorlage ist festgelegt. Du kannst aber den Standardinhalt durch deine eigenen Bilder, Videos, Produkte, Texte und Links ersetzen. Mehr dazu erfährst du unter Instant Experiences, Verwenden von Vorlagen.

Es gibt zwei Arten von Collection Ads mit Instant Experiences: bildbasiert und videobasiert, je nach dem von dir bereitgestellten Asset. Wenn du die Anzeigengestaltung fertiggestellt hast, kannst du eine Werbeanzeige erstellen.

Erstellen einer bildbasierten Werbeanzeige

curl 
  -F 'name=Instant Experiences Collection Sample Image Creative' 
  -F 'object_story_spec={ 
    "link_data": {
      "link": "https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID", 
      "message": "Ad message", 
      "name": "name", 
      "picture": "IMAGE_URL", 
      "collection_thumbnails": [
        {"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
        {"element_child_index": 0,"element_id": "",},
        {"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
      ],
    }, 
    "page_id": "PAGE_ID" 
  }' 
  -F 'access_token=ACCESS_TOKEN' 
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Erstellen einer videobasierten Werbeanzeige

curl 
  -F 'name=Instant Experiences Collection Sample Video Creative' 
  -F 'object_story_spec={ 
    "page_id": "PAGE_ID", 
    "video_data": { 
      "call_to_action": {"type":"LEARN_MORE","value":{"link":"https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID"}}, 
      "image_url": "IMAGE_URL",
      "collection_thumbnails": [
        {"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_NO_PRODUCT_TAGS_ID",},
        {"element_child_index": 0,"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
        {"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
      ],
      "title": "My title", 
      "video_id": "VIDEO_ID" 
    } 
  }' 
  -F 'access_token=ACCESS_TOKEN' 
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Parameter

NameBeschreibung

link

String

Erforderlich
Leitet Betrachter zu einer Instant Experience um.

collection_thumbnails

Array

Erforderlich
Ein Array mit Miniaturbildern. Vier Miniaturbilder sind erforderlich.

Die collection_thumbnails-Felder

NameBeschreibung

element_id

Numerischer String

Erforderlich
Element-ID des Canvas-Fotos oder der Produktliste. Das Canvas-Foto muss der Instant Experience zugewiesen werden, die mit dieser Collection Ad verknüpft ist. Ein Bild mit dieser ID wird in der Instant Experience angezeigt, wenn jemand auf die Anzeige klickt. Die Element-ID eines Hero Image ist ungültig.

element_child_index

Ganzzahl

Erforderlich für ein Fotoelement mit Produkt-Tags und Produktlistenelement
Der Produktindex aus einem Array von Fotoelement-IDs mit Produkt-Tags. Kann auch ein Produktindex aus einem Array von product_id_list sein, das die Produktlistenelemente enthält.
Hinweis: Muss eine positive Ganzzahl sein.

element_crops
AdsImageCrops

Erforderlich für ein Fotoelement
Ein JSON-Objekt, das Zuschnittsabmessungen für das angegebene Bild definiert. Nur ein Zuschneideschlüssel von 100x100 ist zulässig.

Erstellen von Zielgruppen für Interaktionen

Du kannst automatisch Zielgruppen aus Personen erstellen, die mit deiner Collection Ad interagiert haben. Diese ähneln Zielgruppen für Interaktionen für standardmäßige Instant Experiences. Mehr dazu erfährst du unter Instant Experiences, Zielgruppen für Interaktionen.

Du kannst mit deinem Instant Experience-Vollbilderlebnis Personen ansprechen, die auf deine Collection Ad getippt haben. Wir nennen diese Art von Zielgruppe eine Zielgruppe für Vollbild-Interaktionen. Du legst diese Zielgruppe an, indem du eine Custom Audience erstellst und dann object_id auf CANVAS_ID setzt und eine Regel zum Tracking eines der Events erstellst.

Erstellen einer Zielgruppe aus Personen, die eine Instant Experience geöffnet haben

curl \
    -F 'name=Collection Engagement Audience' 
    -F 'description=People who opened this Instant Experience' 
    -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_document_open"}]' 
    -F 'access_token=ACCESS_TOKEN' 
https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/customaudiences

Erstellen einer Zielgruppe aus Personen, die auf eine Collection Ad geklickt haben

curl \
    -F 'name=Collection Engagement Audience' 
    -F 'description=People who clicked any links in this Instant Experience' 
    -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_element_click"}]'
    -F 'access_token=ACCESS_TOKEN' 
https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/customaudiences

Dialog „Collection Ads“

Collection Ads basieren auf Instant Experiences mit einer Vorlage. Zum Erstellen einer Collection Ad mit einem Dialog verwendest du daher den Dialog „Instant Experiences“ mit zusätzlichen Parametern. Hierdurch werden die Benutzeroberflächen zum Erstellen von Collection Ads von Facebook auf deiner Website bereitgestellt. Ausführliche Informationen zur UI-Komponente findest du unter Dialoge.

Richte das Facebook-SDK for JavaScript ein. Entsprechende Informationen findest du hier:

Das JavaScript-SDK basiert auf den Berechtigungen des angemeldeten Nutzers zum Erstellen von Instant Experiences. Falls der Nutzer nicht über die notwendigen Berechtigungen zur Instant Experience-Erstellung für die angegebene Seite und das Unternehmen verfügt, wird im Dialog ein Fehler angezeigt. Der Nutzer muss außerdem Zugriff auf die Produktkataloge und -paletten haben. Damit keine Fehler auftreten, muss der Nutzer Zugriff auf den Business Manager und Berechtigungen zum Erstellen von Werbeanzeigen für die Seite besitzen.

Dann kannst du den Dialog für Collection Ads auslösen.

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_builder',
  account_id: 'AD_ACCOUNT_ID'.
  business_id: 'BUSINESS_ID',
  page_id: 'PAGE_ID',
  template_id: 'TEMPLATE_ID'
}, function(response) {
  // callback
});

Du kannst folgende Einstellungen für das Plugin angeben:

Name Beschreibung

display

Erforderlich
Notwendiger Parameter mit dem Wert von popup.

method

Erforderlich
Notwendiger Parameter mit dem Wert von instant_experiences_builder.

account_id

Erforderlich
Die ID deines Werbekontos.

business_id

Erforderlich
Deine Unternehmens-ID.

page_id

Erforderlich
Seiten-ID, mit der du die Instant Experience verknüpfen möchtest.

template_id

Erforderlich
Die ID der gewünschten Vorlage.

product_catalog_id

Optional
Die ID des Produktkatalogs für die Collection. Diese ist erforderlich, wenn product_set_id angegeben wird.

product_set_id

Optional
Die ID der Produktpalette für die Collection.

Du findest alle gültigen Vorlagentypen und die entsprechenden IDs in Instant Experiences: Vorlage verwenden.

Die Parameter product_catalog_id und product_set_id sind optional. Wenn du product_set_id angibst, musst du jedoch auch product_catalog_id angeben. Wenn du diese IDs angegeben hast, kann der Nutzer die Sammlung in der UI nicht mehr ändern. Wenn keiner der Parameter angegeben wird, kann der Nutzer den Katalog und die Produktpalette in der UI auswählen. Zum Anzeigen der Vorschau einer Collection Ad empfehlen wir dir den Dialog zur Instant Experiences-Vorschau.

Das Plugin gibt bei Erfolg folgende Antwort zurück:


{
  "success": true,
  "id": "CANVAS_ID"
}

Die zurückgegebene id ist eine nicht veröffentlichte Instant Experience. Sie muss veröffentlicht werden, bevor du sie in Kampagnen verwenden kannst.

Wenn keine Antwort oder eine undefined-Antwort zurückgegeben wird, hat der Nutzer den Dialog vor Ende der Instant Experience geschlossen oder die Instant Experience gespeichert, aber nicht beendet. Du kannst alle Instant Experiences, die zu einer Seite gehören, mit der Graph API aufrufen und prüfen, ob nicht fertiggestellte Instant Experiences darunter sind.

Reisezielkataloge aufnehmen

Du kannst Anzeigengestaltungen aus einem Reisezielkatalog im Hero Image einer Collection Ad anzeigen. Außerdem hast du die Möglichkeit, ein Carousel mit Hotelbildern für dieses Reiseziel anzuzeigen. Hierfür musst du ein Fallback-Bild bereitstellen, das für das Hero Image angezeigt wird, wenn kein entsprechendes Reiseziel für Hotels im Carousel gefunden wird. Mehr dazu erfährst du unter Reisezielkatalog.

Beachte die folgenden Einschränkungen:

  • Videoanzeigen werden nicht unterstützt.
  • Wir unterstützen nur die kombinierte Anzeige von Reiseziel- und Hotelkatalogbildern.
  • Die Anzeige anderer Katalogkombinationen unterstützen wir nicht.

Füge zur Nutzung dieses Features den Parameter destination_set_id beim Erstellen deines canvas_photo-Elements hinzu. Führe dann die anderen Standardschritte zum Erstellen deiner Instant Experience und Collection Ad aus.

Beispiel

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
    "destination_set_id": "DESTINATION_SET_ID",
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements