API de marketing

Anuncios de colección

El formato de anuncio de colección incluye una experiencia instantánea y permite descubrir, explorar y comprar productos y servicios desde dispositivos móviles de una forma visual y envolvente. El anuncio que se muestra en la sección de noticias incluye tres productos después de una imagen o video principal que se expande para mostrar una experiencia instantánea de pantalla completa cuando alguien interactúa con el anuncio. Hay dos tipos de anuncios de colección: los que se basan en imagen y los que se basan en video.

Interpreta todas las referencias a "Canvas" como referencias a la experiencia instantánea, ya que "Canvas" es el nombre anterior de este formato.

Puedes crear un anuncio con formato de colección si creas una experiencia instantánea. Comienza con una plantilla o elige tu propio diseño personalizado. Para obtener más información, consulta Centro de ayuda para anunciantes: Experiencia instantánea.

Además, en tu sitio web, puedes usar el SDK de JavaScript para incluir interfaces de usuario de creación de anuncios de Facebook para el formato de colección y crear un cuadro de diálogo de anuncios de colección.

Para obtener información general sobre el uso de las colecciones, consulta:

Para crear colecciones usadas en las tiendas o agregar metadatos a un conjunto de productos, consulta Plataforma de comercio, API de colección de conjuntos de productos.

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

Objetivos y ubicaciones admitidos

Puedes usar los anuncios de colección con los siguientes objetivos:

  • Tráfico
  • Conversiones
  • Ventas del catálogo de productos (se admite cuando se usan colecciones con un conjunto de productos).
  • Visitas a la tienda (se admite cuando se usan colecciones con un conjunto de productos).
  • Reconocimiento de marca
  • Alcance

Para los objetivos de tráfico y conversiones, también se pueden usar videos de presentaciones. Para obtener más información, consulta Servicio de ayuda para empresas: Elegir el objetivo adecuado.

Se admiten las siguientes ubicaciones:

Para obtener más información sobre las ubicaciones, consulta Servicio de ayuda para empresas: Información sobre ubicaciones y Servicio de ayuda para empresas: Ubicaciones de anuncios disponibles para objetivos de marketing.

Anuncios de colección a partir de conjuntos de productos

Antes de crear anuncios de colección, debes proporcionar el contenido del anuncio y una experiencia instantánea. Debes proporcionar al menos cuatro elementos que representen fotos de cuatro elementos que representen productos con etiquetas de producto que se mostrarán con rotación. También se admiten las fotos secundarias en un elemento de la secuencia.

Crea anuncios de colección a partir de tu catálogo. Un anuncio de colección muestra tres productos debajo de una imagen o de un video principal, y aparece en la sección de noticias del celular. Con esta función, puedes usar videos de presentaciones.

El anuncio aparece en el Feed y la gente puede ver más en una experiencia de pantalla completa que se abre al tocar el anuncio.

Para usar un conjunto de productos, debes estar familiarizado con los anuncios del catálogo Advantage+ y tener ya preparado un catálogo de productos. Para obtener más información, consulta Anuncios del catálogo Advantage+ y Anuncios del catálogo Advantage+, Catálogo de productos.

Creación de anuncios

Cuando creas un anuncio de colección a partir de conjuntos de productos, también debes crear explícitamente una experiencia instantánea con los elementos correctos. Cuando usas esta experiencia instantánea en un anuncio de colección, Facebook genera el anuncio de forma automática. La experiencia instantánea debe contener lo siguiente:

Imagen de la experiencia instantánea

Crea una experiencia instantánea con una imagen:

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

O créala 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

O créala con una plantilla de 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

Conjunto de productos de la experiencia instantánea

Luego crea un canvas_product_set con un valor de product_set_id desde tu catálogo de productos. Debes definir el campo show_in_feed en true para crear un anuncio de colección.

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: En el ejemplo anterior, item_headline, item_description, image_overlay_spec, storefront_setting y retailer_item_ids son campos opcionales. Anteriormente, los proporcionabas en la misma llamada para crear el anuncio de colección y el recurso de experiencia instantánea subyacente. Ahora, los proporcionas en esta solicitud.

Proporciona los campos obligatorios en el parámetro image_overlay_spec. Para obtener más información, consulta API de marketing > Referencia > Datos de enlace de contenido del anuncio > Especificaciones de superposición de imágenes.

El parámetro storefront_setting admite los campos product_set_layout, enable_sections y customized_section_titles.

Los campos product_set_layout
NombreDescripción

layout_type

Cadena

Obligatorio. El modo en que se mostrará el producto.
Valores:GRID_2COL, GRID_3COL, CAROUSEL y HSCROLL_LIST

Para usar customized_section_titles, enable_sections se debe configurar en true. En el campo customized_section_titles, se debería utilizar una matriz de objetos, donde cada uno presenta los parámetros title_id y customized_title.

Los campos customized_section_titles
NombreDescripción

title_id

Cadena

Obligatorio.
Cadena de enumeración que representa la cadena del título de la sección predeterminada que te gustaría reemplazar.
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 y shop_by_category

customized_title

Cadena

Obligatorio.
Cadena personalizada alternativa que el usuario debería ver como título de la sección.

Pie de página de la experiencia instantánea

Crea el pie de página de la experiencia instantánea con un enlace.

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

Si lo deseas, también puedes crear un botón para usar en el pie de página.

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

El texto que colocas en el pie de página es relativamente flexible. Antes, tenías que incluir un elemento See more...., pero ahora puedes usar texto personalizado con el botón URL.

Experiencia 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 crear la experiencia instantánea con una plantilla de video, un conjunto de productos, un botón, una ubicación de la tienda y un pie de página opcional que hayas configurado, deberás incluir el 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

En el caso de una plantilla de tienda, debes especificar el parámetro source_template_id = 1932289657009030; se define en Uso de plantillas en experiencias instantáneas. Aunque el diseño de cada plantilla es fijo, puedes reemplazar el contenido predeterminado con tus propios videos, productos, textos y enlaces dinámicos. Para obtener más información, consulta Uso de plantillas en experiencias instantáneas.

Crea el anuncio de colección con la experiencia instantánea

Finalmente, tienes que crear un anuncio de colección. Esto permite que las personas hagan clic en las imágenes o el elemento de video desde el anuncio de colección.

Si el primer elemento de tu experiencia instantánea es una foto, debes establecer 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

Si el primer elemento de tu experiencia instantánea es un video, envía la siguiente solicitud:

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

Si el primer elemento de tu experiencia instantánea es una plantilla de video, envía la siguiente solicitud:

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

Vistas previas de anuncios

Si puedes obtener una vista previa del anuncio, puedes proporcionar un valor de ad_format y un token de acceso de usuario para generar vistas previas según el anuncio o el contenido del anuncio.

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: En el caso de los anuncios de experiencias instantáneas de plantillas de video, los formatos admitidos son BIZ_DISCO_FEED_MOBILE, GROUPS_MOBILE, MOBILE_FEED_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE y WATCH_FEED_MOBILE.

Para obtener más información, consulta Vistas previas de anuncios.

Anuncios de colección estándar

Puedes usar una plantilla como una forma rápida de crear una experiencia instantánea para lograr un objetivo comercial específico. Aunque el diseño de cada plantilla es fijo, puedes reemplazar el contenido predeterminado con tus propios videos, productos, textos, enlaces e imágenes. Para obtener más información, consulta Uso de plantillas en experiencias instantáneas.

Hay dos tipos de anuncios de colección con experiencias instantáneas: los que se basan en imágenes y los que se basan en video, en función del activo que proporciones. Cuando ya tengas el contenido del anuncio, podrás crearlo.

Creación de un anuncio basado en imágenes

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

Creación de un anuncio basado en 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

Parámetros

NombreDescripción

link

Cadena

Obligatorio
Redirige al espectador a una experiencia instantánea.

collection_thumbnails

Matriz

Obligatorio
Una matriz de imágenes en miniatura. Debe tener cuatro imágenes en miniatura.

Los campos de collection_thumbnails

NombreDescripción

element_id

Cadena numérica

Obligatorio
Identificador del elemento de la foto de Canvas o identificador del elemento de la lista de productos. La foto de Canvas debe asociarse a la experiencia instantánea relacionada con este anuncio de colección. Una imagen asociada con este identificador aparece en la experiencia instantánea después de que alguien hace clic en el anuncio. No se admite el identificador de elemento de una imagen principal.

element_child_index

Número entero

Obligatorio en el caso de elementos de foto con etiquetas de producto y elementos de lista de productos
Índice de productos de una matriz de identificadores de elementos de fotos con etiquetas de productos. También puede ser un índice de productos de una matriz de product_id_list, que incluye los elementos de la lista de productos.
Nota: Debe ser un número entero positivo.

element_crops
AdsImageCrops

Obligatorio en el caso de elementos de foto
Objeto JSON que define las dimensiones de recorte para la imagen especificada. Solo se admite la clave de recorte 100x100.

Creación de públicos de interacción

Puedes crear automáticamente públicos para las personas que han interactuado con tu anuncio de colección. Esto es similar a los públicos de interacción en las experiencias instantáneas estándar. Para obtener más información, consulta Públicos de interacción en experiencias instantáneas.

Puedes dirigir tus anuncios de experiencia instantánea con una vista en pantalla completa a las personas que tocaron tu anuncio de colección. A este tipo de público lo llamamos público de interacción de experiencia en pantalla completa. Para crearlo, genera un público personalizado, establece object_id como CANVAS_ID y crea una regla para realizar un seguimiento de uno de los eventos.

Crea un público que haya abierto una experiencia 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

Crea un público de personas que hayan hecho clic en un anuncio de colección

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

Cuadro de diálogo "Anuncios de colección"

Los anuncios de colección se basan en experiencias instantáneas con una plantilla. Por lo tanto, para crear un anuncio de colección mediante un cuadro de diálogo, debes usar el cuadro de diálogo "Experiencias instantáneas" con parámetros adicionales. De este modo, se proporcionará el proceso de la interfaz de usuario de creación de anuncios de colección de Facebook en tu sitio web. Para obtener información detallada sobre el componente de UI, consulta Diálogos.

Para configurar el SDK de Facebook para JavaScript, consulta:

El SDK de JavaScript se basa en los permisos del usuario que inició sesión para crear experiencias instantáneas. Si el usuario no tiene los permisos necesarios para crear una experiencia instantánea para la página y el negocio proporcionados, el cuadro de diálogo mostrará un error. El usuario también debe tener acceso a los conjuntos y catálogos de productos. Para asegurarte de que no haya errores, el usuario debe tener acceso al administrador comercial y debe tener permisos para crear anuncios para la página.

Así, podrás activar el cuadro de diálogo de los anuncios de colección.

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

Puedes proporcionar esta configuración para el plugin:

Nombre Descripción

display

Obligatorio
Parámetro necesario definido con un valor de popup.

method

Obligatorio
Parámetro necesario definido con un valor de instant_experiences_builder.

account_id

Obligatorio
Identificador de tu cuenta publicitaria.

business_id

Obligatorio
Identificador de tu empresa.

page_id

Obligatorio
Identificador de la página a la que deseas asociar la experiencia instantánea.

template_id

Obligatorio
Identificador de la plantilla que deseas usar.

product_catalog_id

Opcional
Identificador del catálogo de productos que deseas usar en la colección. Es obligatorio si se proporciona el valor product_set_id.

product_set_id

Opcional
Identificador del conjunto de productos que deseas usar en la colección.

Todos los tipos de plantilla válidos y los identificadores correspondientes se pueden encontrar en Experiencias instantáneas: Usar una plantilla.

Los parámetros product_catalog_id y product_set_id son opcionales. Sin embargo, si proporcionas el parámetro product_set_id, también deberás proporcionar product_catalog_id. Una vez proporciones estos identificadores, el usuario no podrá cambiar la colección en la interfaz de usuario. Si no se proporciona ninguno de los parámetros, el usuario puede seleccionar el catálogo y el conjunto de productos en la interfaz de usuario. Para obtener una vista previa de un anuncio de colección, se recomienda usar el cuadro de diálogo Vista previa de experiencias instantáneas.

Si la operación se realiza con éxito, el plugin proporciona esta respuesta:


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

El valor de id devuelto será una experiencia sin publicar. Deberás publicarla para poder usarla en campañas publicitarias.

Si no recibes una respuesta o la respuesta que recibes es undefined, significa que el usuario cerró el cuadro de diálogo antes de finalizar la experiencia instantánea o que el usuario guardó la experiencia instantánea pero no la finalizó. Puedes enviar una consulta a la API Graph para ver todas las experiencias instantáneas correspondientes a una página; esto te permitirá ver si existe alguna sin finalizar.

Inclusión de catálogos de destinos

Puedes mostrar contenido de anuncios desde el catálogo de destinos en la imagen principal de un anuncio de colección. También puedes mostrar una secuencia de imágenes de hotel en ese destino. Para ello, debes proporcionar una imagen de reserva que se muestre en la imagen principal en caso de que no encontremos ningún destino correspondiente para los hoteles de la secuencia. Para obtener más información, consulta Catálogo de destinos.

Ten en cuenta las siguientes limitaciones:

  • No se admite el contenido de video.
  • Solo se admite la visualización de las imágenes de los catálogos de destinos y hoteles combinada.
  • No se admite la visualización de otras combinaciones de catálogos.

Para usar esta función, agrega el parámetro destination_set_id cuando crees el elemento canvas_photo y, luego, sigue los demás pasos estándar para crear la experiencia instantánea y el anuncio de colección.

Ejemplo

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