Anúncios de coleção

O formato de anúncio de coleção inclui uma experiência instantânea e facilita a descoberta, a navegação e a compra de produtos e serviços diretamente de dispositivos móveis, de forma visual e imersiva. Seu anúncio no feed terá três produtos em uma hero image ou um vídeo principal exibidos em uma experiência instantânea de tela cheia quando alguém interagir com ele. Existem dois tipos de anúncios de coleção: baseados em imagem e em vídeo.

Considere todas as menções a "Canvas" como uma referência a experiências instantâneas. Canvas era o nome anterior do formato.

Você pode gerar um anúncio com o formato de coleção ao criar uma experiência instantânea. Comece com um modelo ou escolha o próprio layout personalizado. Para mais informações, consulte Experiência instantânea na Central de Ajuda de Anúncios.

Também é possível incluir as interfaces do usuário para a criação de anúncios do Facebook no formato de coleção no seu site. Para isso, use o SDK para JavaScript para criar um diálogo dos anúncios de coleção.

Para informações gerais sobre o uso de coleções, acesse:

Para criar coleções usadas nas Lojas ou adicionar metadados a um conjunto de produtos, consulte API de Coleção de Conjunto de Produtos na Plataforma de Comércio.

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

Objetivos e posicionamentos compatíveis

Você pode usar anúncios de coleção com estes objetivos:

Tráfego
Conversões
Vendas do catálogo de produtos (compatível ao usar coleções com um conjunto de produtos)
Visitas ao estabelecimento (compatível ao usar coleções com um conjunto de produtos)
Reconhecimento da marca
Alcance

Com os objetivos de tráfego e de conversões, também é possível usar vídeos de apresentação multimídia. Consulte Escolher o objetivo do anúncio adequado na Central de Ajuda para Empresas para mais informações.

Os seguintes posicionamentos são compatíveis:

Feed do Facebook
Facebook Reels
Feed do Instagram (consulte Experiências instantâneas e anúncios do Instagram na documentação sobre experiências instantâneas)
Instagram Stories (consulte Experiências instantâneas e anúncios do Instagram na documentação sobre experiências instantâneas)

Para mais informações, consulte as páginas Sobre os posicionamentos e Posicionamentos de anúncio disponíveis para objetivos de marketing na Central de Ajuda para Empresas.

Anúncios de coleção em conjuntos de produtos

Antes de criar um anúncio de coleção, é necessário fornecer um criativo do anúncio e uma experiência instantânea. Forneça no mínimo quatro elementos que representem fotos ou quatro elementos que representem produtos com etiquetas de produto para exibição em rotação. Elementos secundários de foto em elemento de carrossel também são válidos.

Use seu catálogo para criar anúncios de coleção. Um anúncio de coleção tem 3 produtos abaixo de um vídeo principal ou hero image e é exibido no Feed móvel. É possível usar vídeos de apresentação multimídia com este recurso.

O anúncio aparece no Feed e as pessoas podem ver mais com uma experiência em tela cheia que abre quando elas tocam no anúncio.

Para usar um conjunto de produtos, é preciso já ter se familiarizado com os anúncios de catálogo Advantage+ e ter um catálogo de produtos configurado. Para ver mais informações, consulte Anúncios de Catálogo Advantage+ e Catálogo – Anúncios de Catálogo Advantage+.

Como criar anúncios

Ao gerar um anúncio de coleção com os conjuntos de produtos, é necessário criar também uma experiência instantânea com os elementos corretos. Quando a experiência instantânea for usada em um anúncio de coleção, esse anúncio será gerado automaticamente pelo Facebook. Sua experiência instantânea precisa conter:

uma imagem, seja uma foto, um vídeo ou um vídeo de modelo do Canvas;
um conjunto de produtos com show_in_feed definido como true (consulte a referência Conjunto de produtos do Canvas);
um rodapé (consulte a referência Rodapé do Canvas).

Imagem da experiência instantânea

Crie uma experiência instantânea com uma imagem:

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

Ou crie uma experiência instantânea com um vídeo:

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

Ou crie uma experiência instantânea com um vídeo de modelo:

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

Conjunto de produtos da experiência instantânea

Depois, crie um canvas_product_set com um product_set_id do seu catálogo de produtos. É necessário definir show_in_feed como true para criar um anúncio de coleção.

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

Observação: no exemplo acima, item_headline, item_description, image_overlay_spec, storefront_setting e retailer_item_ids são campos opcionais. No passado, eles eram fornecidos na mesma chamada para criar o anúncio de coleção e o ativo subjacente da experiência instantânea. Agora, você os inclui nessa chamada.

Forneça os campos obrigatórios no parâmetro image_overlay_spec. Para mais informações, consulte Ad Creative Link Data Image Overlay Spec.

O parâmetro storefront_setting é compatível com os campos product_set_layout, enable_sections e customized_section_titles.

Os campos `product_set_layout`

Nome	Descrição
`layout_type` string	Obrigatório. Indica como o conjunto de produtos será exibido. Valores: `GRID_2COL`, `GRID_3COL`, `CAROUSEL`, `HSCROLL_LIST`

Para usar customized_section_titles, é preciso definir enable_sections como true. O campo customized_section_titles espera uma matriz de objetos, cada um com os parâmetros title_id e customized_title.

Os campos `customized_section_titles`

Nome	Descrição
`title_id` string	Obrigatório. String de enumeração que representa a string padrão do título da seção que você quer substituir. Valores: `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	Obrigatório. String personalizada alternativa que deve ser vista como o título da seção.

Rodapé da experiência instantânea

Crie o rodapé da experiência instantânea com um 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 quiser, também é possível criar um botão para uso no rodapé.

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

O texto disponibilizado no rodapé é relativamente flexível. Antes, era necessário fornecer See more...., mas agora é possível incluir um texto personalizado com a URL do botão.

Experiência instantânea 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

Para criar a experiência instantânea com vídeo de modelo, conjunto de produtos, botão, localização do estabelecimento e rodapé opcional configurados por você, será necessário incluir o parâmetro 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

Para um modelo de vitrine, é preciso especificar source_template_id = 1932289657009030. Confira a definição em Usar um modelo na documentação Experiências instantâneas. O layout de cada modelo é fixo. No entanto, você pode substituir o conteúdo-padrão pelos próprios vídeos, produtos, textos e links dinâmicos. Para mais informações, consulte Usar um modelo na documentação Experiências instantâneas.

Criar o anúncio de coleção com a experiência instantânea

Por último, é necessário criar um anúncio de coleção. Isso permite que as pessoas cliquem nos elementos de imagem ou de vídeo do seu anúncio de coleção.

Se o primeiro elemento da experiência instantânea for uma foto, será necessário definir object_type como 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 o primeiro elemento da experiência instantânea for um vídeo, faça a seguinte solicitação:

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 o primeiro elemento da experiência instantânea for um vídeo de modelo, faça a seguinte solicitação:

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

Prévias do anúncio

Se tiver o recurso de prévia do anúncio, você poderá fornecer um ad_format e um token de acesso do usuário para gerar prévias com base no seu anúncio ou criativo do anúncio.

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

Observação: os formatos compatíveis com anúncios de experiência instantânea do vídeo de modelo são BIZ_DISCO_FEED_MOBILE, GROUPS_MOBILE, MOBILE_FEED_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE e WATCH_FEED_MOBILE.

Saiba mais em Prévias do anúncio.

Anúncios de coleção-padrão

É possível usar um modelo como forma rápida de criar uma experiência instantânea para uma meta de negócios específica. O layout de cada modelo é fixo. No entanto, você pode substituir o conteúdo-padrão por imagens, vídeos, produtos, textos e links próprios. Para mais informações, consulte Usar um modelo na documentação Experiências instantâneas.

Existem dois tipos de anúncio de coleção de experiências instantâneas: baseados em imagens e baseados em vídeo, dependendo do ativo fornecido. Assim que tiver um criativo, você poderá criar um anúncio.

Criar um anúncio baseado em imagem

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

Criar um anúncio baseado em vídeo

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

Parâmetros

Nome	Descrição
`link` string	Obrigatório Redireciona o espectador a uma experiência instantânea.
`collection_thumbnails` matriz	Obrigatório Uma matriz de miniaturas. São necessárias quatro miniaturas.

Campos `collection_thumbnails`

Nome	Descrição
`element_id` string numérica	Obrigatório A identificação do elemento de foto do Canvas ou da lista de produtos. É necessário associar a foto do Canvas à experiência instantânea anexada ao anúncio de coleção. Uma imagem associada a essa identificação aparecerá na experiência instantânea quando alguém clicar no anúncio. Um ID do elemento da hero image é inválido.
`element_child_index` número inteiro	Obrigatório para elemento de foto com e elemento de lista de produtos e etiquetas de produto O índice de produtos de uma matriz de identificações de elemento de foto com etiquetas de produto. Ou um índice de produtos de uma matriz de `product_id_list` que contém os elementos de lista de produtos. Observação: o valor deve ser um número inteiro positivo.
`element_crops` AdsImageCrops	Obrigatório para elemento de foto Um objeto JSON usado para definir as dimensões de corte para a imagem especificada. Somente a chave de corte `100x100` é permitida.

Criar públicos de engajamento

É possível criar automaticamente públicos para pessoas que interagiram com seu anúncio de coleção. Isso é semelhante aos públicos de engajamento para as experiências instantâneas regulares. Consulte Públicos de engajamento na documentação sobre experiências instantâneas para mais informações.

É possível fazer o direcionamento dos anúncios de experiência instantânea com uma visualização em tela cheia para as pessoas que tocaram no seu anúncio de coleção. Chamamos esse tipo de público de público de engajamento de experiência em tela cheia. Gere esse público por meio da criação de um Público Personalizado. Depois, defina object_id como CANVAS_ID e crie uma regra para rastrear um dos eventos.

Criar um público com pessoas que abriram uma experiência instantânea

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

Criar um público com pessoas que clicaram em um anúncio de coleção

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

Diálogo dos anúncios de coleção

Os anúncios de coleção são baseados em experiências instantâneas com um modelo. Portanto, para criar um anúncio de coleção com um diálogo, será preciso usar o diálogo de experiências instantâneas com parâmetros adicionais. Isso fornecerá o fluxo da interface do usuário para a criação de anúncios de coleção do Facebook no seu site. Para mais detalhes sobre o componente de interface do usuário, consulte Diálogos.

Para configurar o SDK do Facebook para JavaScript, consulte:

O SDK para JavaScript depende das permissões do usuário conectado para criar experiências instantâneas. Se o usuário não tiver as permissões necessárias para criar uma experiência instantânea para a página e a empresa fornecidas, o diálogo exibirá um erro. O usuário também deve ter acesso aos conjuntos e catálogos de produtos. Para garantir que não ocorram erros, o usuário precisará ter acesso ao Gerenciador de Negócios e permissões para criar anúncios para a página.

Depois disso, será possível acionar o diálogo dos anúncios de coleção.

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

É possível fornecer as seguintes configurações para o plugin:

Nome	Descrição
`display`	Obrigatório Parâmetro necessário definido com o valor de `popup`.
`method`	Obrigatório Parâmetro necessário definido com o valor de `instant_experiences_builder`.
`account_id`	Obrigatório A identificação da conta de anúncio.
`business_id`	Obrigatório A identificação da empresa.
`page_id`	Obrigatório A identificação da Página que você deseja associar à experiência instantânea.
`template_id`	Obrigatório A identificação do modelo que você quer usar.
`product_catalog_id`	Opcional A identificação do catálogo de produtos a ser usado na coleção. Isso será necessário se `product_set_id` for fornecido.
`product_set_id`	Opcional A identificação do conjunto de produtos a ser usado na coleção.

Confira todos os tipos de modelo válidos e as identificações correspondentes na seção Usar um modelo da documentação sobre experiências instantâneas.

Os parâmetros product_catalog_id e product_set_id são opcionais. Entretanto, se você fornecer product_set_id, será necessário fazer o mesmo com product_catalog_id. Depois de fornecer esses IDs, o usuário não poderá alterar a coleção na interface do usuário. Se nenhum parâmetro for fornecido, o usuário poderá selecionar o catálogo e o conjunto de produtos na interface do usuário. Para ver a prévia de um anúncio de coleção, recomendamos usar o diálogo de prévia das experiências instantâneas.

O plugin retorna a seguinte resposta em caso de sucesso:


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

O id retornado será uma experiência instantânea não publicada. É preciso publicar essa experiência instantânea para usá-la em campanhas de anúncios.

Se não houver resposta ou se a resposta retornada for undefined, isso indicará que o usuário fechou o diálogo antes de concluir a experiência instantânea ou que ele salvou a experiência, mas não a concluiu. Consulte a Graph API para ver todas as experiências instantâneas pertencentes a uma página. Com isso, será possível verificar se há experiências instantâneas inacabadas.

Como incluir catálogos de destino

É possível exibir os criativos do anúncio de um catálogo de destinos na hero image do anúncio de coleção. Você também pode exibir um carrossel de imagens de hotéis do destino em questão. Para isso, forneça uma imagem de fallback para exibição na hero image se não encontrarmos um destino correspondente para os hotéis no carrossel. Consulte Catálogo de destinos para mais informações.

Observe as seguintes limitações:

O criativo do vídeo não é compatível.
Aceitamos somente a exibição combinada dos destinos e das imagens do catálogo de hotéis.
A exibição de outras combinações de catálogo não é compatível.

Para usar o recurso, adicione o parâmetro destination_set_id ao criar seu elemento canvas_photo. Depois, siga as outras etapas-padrão para criar a experiência instantânea e o anúncio de coleção.

Exemplo

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