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
.
Du kannst Collection Ads mit den folgenden Zielen verwenden:
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.
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.
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:
show_in_feed
auf true
gesetzt ist. (Siehe Canvas-Produktpalette, Referenz.)Erstelle eine Instant Experience mit einem Bild:
curl \
-F 'canvas_photo={
"photo_id": "PHOTO_ID",
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvas_elements
Open In Graph API Explorer
Oder erstelle eine Instant Experience mit einem Video:
curl \
-F 'canvas_video={
"video_id": "VIDEO_ID",
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvas_elements
Open In Graph API Explorer
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/v21.0
/<PAGE_ID>/canvas_elements
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/v21.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
.
product_set_layout
-FelderName | Beschreibung |
---|---|
String | Erforderlich. Wie die Produktpalette angezeigt wird. |
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
.
customized_section_titles
-FelderName | Beschreibung |
---|---|
String | Erforderlich. |
String | Erforderlich. |
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"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvas_elements
Open In Graph API Explorer
Du kannst auch einen Button erstellen, den du in der Fußzeile verwendest.
curl \
-F 'canvas_footer={
"child_elements": [BUTTON_ELEMENT_ID]
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvas_elements
Open In Graph API Explorer
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.
curl \
-F 'body_element_ids=[
PHOTO/VIDEO_ELEMENT_ID,
PRODUCT_SET_ELEMENT_ID,
FOOTER_ELEMENT_ID
]' \
-F 'is_published=true' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvases
Open In Graph API Explorer
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' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<PAGE_ID>/canvases
Open In Graph API Explorer
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.
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/v21.0
/AD_ACCOUNT_ID/adcreatives
Open In Graph API Explorer
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/v21.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/v21.0
/act_<AD_ACCOUNT_ID>/ads
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/v21.0
/<CREATIVE_ID>/previews
Open In Graph API Explorer
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.
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.
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/v21.0
/AD_ACCOUNT_ID/adcreatives
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/v21.0
/AD_ACCOUNT_ID/adcreatives
Name | Beschreibung |
---|---|
String | Erforderlich |
Array | Erforderlich |
collection_thumbnails
-FelderName | Beschreibung |
---|---|
Numerischer String | Erforderlich |
Integer | Erforderlich für ein Fotoelement mit Produkt-Tags und Produktlistenelement |
| Erforderlich für ein Fotoelement |
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.
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/v21.0
/AD_ACCOUNT_ID/customaudiences
Open In Graph API Explorer
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/v21.0
/AD_ACCOUNT_ID/customaudiences
Open In Graph API Explorer
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 |
---|---|
| Erforderlich |
| Erforderlich |
| Erforderlich |
| Erforderlich |
| Erforderlich |
| Erforderlich |
| Optional |
| Optional |
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.
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:
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",
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/PAGE_ID/canvas_elements
Open In Graph API Explorer