Inserzioni con raccolta

Il formato pubblicitario della raccolta include un'esperienza interattiva e consente alle persone di scoprire, sfogliare e acquistare prodotti e servizi dal proprio dispositivo mobile in modo più semplice, visivo e coinvolgente. La tua inserzione nei feed mostrerà tre prodotti sotto un'immagine o un video del banner che si apre in un'esperienza interattiva a schermo intero quando qualcuno interagisce con la tua inserzione. Esistono due tipi di inserzioni con raccolta: basate su immagini e basate su video.

Prendi in considerazione tutti i riferimenti a "Canvas" in relazione all'esperienza interattiva poiché Canvas è il nome precedente di questo formato.

Puoi creare un'inserzione con formato raccolta attraverso la creazione di un'esperienza interattiva. Inizia con un modello o scegli il tuo layout personalizzato. Per maggiori informazioni, consulta il Centro assistenza per le inserzioni, Informazioni sulle esperienze interattive.

Puoi anche includere l'interfaccia utente per la creazione delle inserzioni di Facebook per il formato raccolta nel tuo sito web con l'SDK JavaScript per creare una finestra di dialogo Inserzioni con raccolta.

Per informazioni generali sull'uso delle raccolte, consulta:

Per creare raccolte usate negli Shop o aggiungere metadati a un insieme di prodotti, consulta Piattaforma di vendita, API Product Set Collection.

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

Obiettivi e posizionamenti supportati

Puoi usare le inserzioni con raccolta con i seguenti obiettivi:

Traffico
Conversioni
Vendita dei prodotti del catalogo (supportato quando si utilizzano raccolte con un insieme di prodotti)
Visite al punto vendita (supportato quando si utilizzano raccolte con un insieme di prodotti)
Notorietà del brand
Copertura

Per gli obiettivi di traffico e conversioni, puoi anche utilizzare i video in slideshow. Per ulteriori informazioni, consulta il Centro assistenza per le aziende: Scelta dell'obiettivo pubblicitario giusto.

Sono supportati i seguenti posizionamenti:

Feed di Facebook
Facebook Reels
Feed di Instagram (consulta Esperienze interattive: esperienze interattive e inserzioni di Instagram)
Instagram Stories (consulta Esperienze interattive: esperienze interattive e inserzioni di Instagram)

Per ulteriori informazioni sui posizionamenti, consulta Centro assistenza per le aziende: Informazioni sui posizionamenti e Centro assistenza per le aziende: Posizionamenti pubblicitari disponibili per gli obiettivi di marketing.

Inserzioni con raccolta da insiemi di prodotti

Prima di creare un'inserzione con raccolta, hai bisogno di fornire la creatività dell'inserzione e un'esperienza interattiva. Devi fornire almeno quattro elementi che rappresentano foto o quattro elementi che rappresentano prodotti con i relativi tag da mostrare a rotazione. Sono validi anche gli elementi foto secondari in un elemento carosello.

Crea inserzioni con raccolta dal tuo catalogo. Un'inserzione con raccolta presenta tre prodotti sotto un'immagine o un video del banner e viene mostrata nel feed mobile. Con questa funzione puoi usare i video slideshow.

L'inserzione viene mostrata nel feed e le persone possono scoprire di più in un'esperienza a schermo intero che si apre quando toccano l'inserzione.

Per usare un insieme di prodotti, devi conoscere le inserzioni del catalogo Advantage+ e disporre già di un catalogo prodotti configurato. Consulta Inserzioni del catalogo Advantage+ e Inserzioni del catalogo Advantage+, Catalogo prodotti per maggiori informazioni.

Creazione di inserzioni

Quando crei un'inserzione con raccolta dagli insiemi di prodotti, devi anche creare esplicitamente un'esperienza interattiva con gli elementi corretti. Quando usi questaesperienza interattiva in un'inserzione con raccolta, Facebook genera automaticamente l'inserzione con raccolta. La tua esperienza interattiva deve contenere:

Un'immagine, come una foto canvas, un video canvas o un modello di video canvas.
Un insieme di prodotti con show_in_feed impostato su true(consulta Insieme di prodotti canvas, Riferimento)
Un piè di pagina (consulta Piè di pagina canvas, Riferimento)

Immagine dell'esperienza interattiva

Crea un'esperienza interattiva con un'immagine:

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

Oppure crea un'esperienza interattiva con un 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

Oppure crea un'esperienza interattiva con un modello di video:

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

Insieme di prodotti dell'esperienza interattiva

Quindi, crea un canvas_product_set con un product_set_id dal tuo catalogo prodotti. Devi impostare show_in_feed su true per creare un'inserzione con raccolta.

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

Nota: nell'esempio in alto, item_headline, item_description, image_overlay_spec, storefront_setting e retailer_item_ids sono tutti campi opzionali. In passato, fornivi questi elementi nella stessa chiamata per creare l'inserzione con raccolta e la risorsa esperienza interattiva sottostante. Ora devi fornirli in questa chiamata.

Fornisci eventuali campi obbligatori nel parametro image_overlay_spec. Per maggiori informazioni, consulta API Marketing, Riferimento, Dati dei link delle creatività dell'inserzione, Specifiche degli overlay dell'immagine.

Il parametro storefront_setting supporta i campi product_set_layout, enable_sections e customized_section_titles.

Campi `product_set_layout`

Nome	Descrizione
`layout_type` stringa	Obbligatorio. Come verrà visualizzato l'insieme di prodotti. Valori:`GRID_2COL`, `GRID_3COL`, `CAROUSEL`, `HSCROLL_LIST`

Per usare customized_section_titles, enable_sections deve essere impostato su true. Il campo customized_section_titles prevede un array di oggetti, ognuno con i parametri title_id e customized_title.

Campi `customized_section_titles`

Nome	Descrizione
`title_id` stringa	Obbligatorio. Stringa enum che rappresenta la stringa del titolo della sezione predefinita che desideri sostituire. Valori:`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` stringa	Obbligatorio. Stringa personalizzata alternativa che chi visualizza dovrebbe vedere come titolo della sezione.

Piè di pagina dell'esperienza interattiva

Crea il piè di pagina dell'esperienza interattiva con un 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

Se vuoi, puoi anche creare un pulsante da utilizzare nel piè di pagina.

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

Il testo che fornisci nel piè di pagina è relativamente flessibile. In passato dovevi fornire See more...., ma ora puoi fornire un testo personalizzato con il pulsante URL.

Esperienza interattiva completa

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

Per creare l'esperienza interattiva con un modello di video, un insieme di prodotti, un pulsante, la posizione del punto vendita e un piè di pagina facoltativo che hai configurato, dovrai includere il parametro source_template_id:

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

Per un modello di vetrina, devi specificare source_template_id = 1932289657009030, è definito in Esperienze istantanee, Uso di un modello. Il layout di ciascun modello è fisso, ma puoi sostituire i contenuti predefiniti con video dinamici, prodotti, testi e link. Per ulteriori informazioni, consulta Esperienze interattive, Uso di un modello.

Creazione dell'inserzione con raccolta con esperienza interattiva

Infine, devi creare un'inserzione con raccolta. Questo consente alle persone di cliccare sulle tue immagini o sui tuoi video dalla tua inserzione con raccolta.

Se il primo elemento della tua esperienza interattiva è una foto, devi impostare object_type su SHARE.

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

Se il primo elemento della tua esperienza interattiva è un video, devi fare questa richiesta:

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

Se il primo elemento della tua esperienza interattiva è un modello di video, devi fare questa richiesta:

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

Anteprima delle inserzioni

Se disponi della funzionalità di anteprima dell'inserzione, puoi fornire un ad_format e un token d'accesso dell'utente per generare anteprime in base alla tua inserzione o alla creatività dell'inserzione.

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

Nota: per le inserzioni con esperienza interattiva del modello di video, i formati supportati sono BIZ_DISCO_FEED_MOBILE, GROUPS_MOBILE, MOBILE_FEED_STANDARD, SUGGESTED_VIDEO_DESKTOP, WATCH_FEED_MOBILE e SUGGESTED_VIDEO_MOBILE.

Per maggiori informazioni, consulta Anteprime dell'inserzione.

Inserzioni con raccolta standard

Puoi usare un modello per creare in modo rapido un'esperienza interattiva per un obiettivo di business specifico. Il layout di ciascun modello è fisso, ma puoi sostituire i contenuti predefiniti con immagini, video, prodotti, testi e link. Per ulteriori informazioni, consulta Esperienze interattive, Uso di un modello.

Esistono due tipi di inserzioni con raccolta con esperienze interattive: basate su immagini e basate su video, in base alla risorsa fornita. Una volta predisposte le creatività dell'inserzione, puoi creare un'inserzione.

Creazione di un'inserzione basata su immagini

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

Creazione di un'inserzione basata su video

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

Parametri

Nome	Descrizione
`link` stringa	Obbligatorio Reindirizza il pubblico a un'esperienza interattiva.
`collection_thumbnails` array	Obbligatorio Un array di miniature. Sono obbligatorie quattro miniature.

Campi `collection_thumbnails`

Nome	Descrizione
`element_id` stringa numerica	Obbligatorio ID elemento foto canvas o ID elemento lista prodotti. La foto canvas deve essere associata all'esperienza interattiva allegata a questa inserzione con raccolta. Un'immagine associata a questo ID viene visualizzata nell'esperienza interattiva quando qualcuno clicca sull'inserzione. Un ID dell'elemento immagine del banner non è valido.
`element_child_index` numero intero	Obbligatorio per l'elemento foto con tag del prodotto ed elemento lista prodotti Indice dei prodotti di un array degli ID dell'elemento foto con tag del prodotto o un indice dei prodotti di un array di `product_id_list`, che contiene gli elementi della lista prodotti. Nota: deve essere un intero positivo.
`element_crops` AdsImageCrops	Obbligatorio per l'elemento foto Un oggetto JSON che definisce le dimensioni di ritaglio per l'immagine specificata. È consentita solo la chiave di ritaglio `100x100`.

Creazione di gruppi di pubblico in base alle interazioni

Puoi creare automaticamente gruppi di pubblico per le persone che hanno interagito con la tua inserzione con raccolta. È simile ai gruppi di pubblico per le esperienze interattive standard. Per ulteriori informazioni, consulta Esperienze interattive, Gruppi di pubblico in base alle interazioni.

Puoi definire come destinatari delle tue inserzioni con esperienza interattiva a schermo intero le persone che hanno toccato la tua inserzione con raccolta. Chiamiamo questo tipo di pubblico pubblico in base alle interazioni per l'esperienza a schermo intero. Realizza questo pubblico creando un pubblico personalizzato, quindi imposta object_id su CANVAS_ID e crea una regola per monitorare uno degli eventi.

Creazione di un pubblico che ha aperto un'esperienza interattiva

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

Creazione di un pubblico che ha cliccato su un'inserzione con raccolta

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

Finestra di dialogo Inserzioni con raccolta

Le inserzioni con raccolta sono basate su esperienze interattive con un modello. Quindi, per creare un'inserzione con raccolta usando una finestra di dialogo, dovrai usare la finestra di dialogo Esperienze interattive con parametri aggiuntivi. In questo modo doterai il tuo sito web del flusso dell'interfaccia utente per la creazione delle inserzioni con raccolta di Facebook. Per maggiori dettagli sul componente dell'interfaccia utente, consulta le Finestre di dialogo.

Per configurare Facebook SDK for Javascript, consulta:

L'SDK JavaScript si basa sulle autorizzazioni dell'utente connesso per creare esperienze interattive. Se l'utente non dispone delle autorizzazioni necessarie per creare un'esperienza interattiva per la pagina e l'azienda fornite, la finestra di dialogo mostrerà un errore. L'utente deve anche avere accesso ai cataloghi prodotti e agli insiemi di prodotti. Per garantire l'assenza di errori, l'utente deve avere accesso al Business Manager e possedere le autorizzazioni per la creazione di inserzioni per la pagina.

Quindi puoi attivare la finestra di dialogo Inserzioni con raccolta.

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
});

Puoi usare queste impostazioni per il plug-in:

Nome	Descrizione
`display`	Obbligatorio Parametro necessario impostato sul valore di `popup`.
`method`	Obbligatorio Parametro necessario impostato sul valore di `instant_experiences_builder`.
`account_id`	Obbligatorio ID del tuo account pubblicitario.
`business_id`	Obbligatorio ID della tua azienda.
`page_id`	Obbligatorio ID Pagina a cui desideri associare l'esperienza interattiva.
`template_id`	Obbligatorio ID del modello che desideri usare.
`product_catalog_id`	Facoltativo ID del catalogo prodotti da usare nella raccolta. Questo ID è necessario se viene fornito `product_set_id`.
`product_set_id`	Facoltativo ID dell'insieme di prodotti da usare nella raccolta.

È possibile trovare tutti i tipi di modelli validi e gli ID corrispondenti in Esperienze interattive, Uso di un modello.

I parametri product_catalog_id e product_set_id sono opzionali. Tuttavia, se fornisci product_set_id, dovrai fornire product_catalog_id. Una volta che avrai fornito questi ID, l'utente non sarà in grado di modificare la raccolta nell'interfaccia utente. Se non viene fornito nessuno dei due parametri, l'utente può selezionare il catalogo e l'insieme di prodotti nell'interfaccia utente. Per visualizzare in anteprima un'inserzione con raccolta, si raccomanda l'uso della finestra di dialogo Anteprima delle esperienze interattive.

Se l'operazione viene eseguita correttamente, il plug-in fornirà questa risposta:


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

L'id restituito sarà un'esperienza interattiva non pubblicata. Dovrà essere pubblicata prima di poter essere utilizzata nelle campagne pubblicitarie.

Se non viene restituita alcuna risposta o viene restituita una risposta undefined, ciò significa che l'utente ha chiuso la finestra di dialogo prima di completare l'esperienza interattiva oppure che l'utente ha salvato l'esperienza interattiva, ma non l'ha completata. Puoi effettuare una query all'API Graph per vedere tutte le esperienze interattive che appartengono a una pagina e in questo modo potrai vedere se ci sono esperienze interattive non completate.

Inclusione di cataloghi di destinazioni

Puoi mostrare le creatività dell'inserzione dal catalogo di destinazioni nell'immagine del banner di un'inserzione con raccolta. Puoi anche visualizzare un carosello di immagini di hotel in quella destinazione. Per eseguire questa operazione, devi fornire un'immagine di fallback visualizzata nell'immagine del banner nel caso in cui non troviamo una destinazione corrispondente per gli hotel nel carosello. Per maggiori informazioni di base, consulta Catalogo di destinazioni.

Tieni conto di queste limitazioni:

La creatività video non è supportata.
Supportiamo solo la visualizzazione delle immagini di cataloghi di destinazioni e hotel combinate.
Non supportiamo la visualizzazione di altre combinazioni di cataloghi.

Per utilizzare questa funzione, aggiungi il parametro destination_set_id durante la creazione dell'elemento canvas_photo, quindi segui gli altri passaggi standard per creare la tua esperienza interattiva e l'inserzione con raccolta.

Esempio

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