API de marketing

Anuncios de colección

El formato de anuncio de colección incluye una experiencia instantánea, y permite a las personas descubrir, explorar y comprar productos y servicios desde sus dispositivos móviles de una forma sencilla, visual y envolvente. El anuncio en el feed incluirá tres productos después de una imagen o vídeo 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: basados en imagen y en vídeo.

Ten en cuenta todas las referencias de “Canvas” para representar la experiencia instantánea, ya que “Canvas” es el nombre anterior de este formato.

Para crear un anuncio con formato de colección, genera una experiencia instantánea. Comienza con una plantilla o elige tu propio diseño personalizado. Para obtener más información, consulta Servicio de ayuda para publicidad, Experiencia instantánea.

También puedes incluir las interfaces de usuario de creación de anuncios de Facebook para el formato de colección en tu sitio web. Para ello, utiliza el SDK de JavaScript para crear un cuadro de diálogo Anuncios de colección.

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

Para crear colecciones que se utilicen en tiendas o añadir metadatos a un conjunto de productos, consulta Plataforma de comercio, API de colección de conjunto 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 admiten cuando usas colecciones con un conjunto de productos).
  • Visitas en el negocio (se admiten cuando usas colecciones con un conjunto de productos).
  • Reconocimiento de marca
  • Alcance

También puedes utilizar presentaciones de vídeo para los objetivos de tráfico y conversiones. Para obtener más información, consulta Servicio de ayuda para empresas: Elegir el objetivo publicitario adecuado.

Se admiten las ubicaciones siguientes:

Para obtener más información sobre las ubicaciones, consulta Servicio de ayuda para empresas: Información sobre las ubicaciones y Servicio de ayuda para empresas: Ubicaciones de anuncios disponibles para los 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 facilitar al menos cuatro elementos que representen fotos o cuatro elementos que representen productos con etiquetas de producto en rotación. También son válidos los elementos de foto dependientes en un elemento de secuencia.

Puedes crear anuncios de colección a partir del catálogo. Un anuncio de colección muestra cuatro productos debajo de una imagen o un vídeo principal y aparece en el feed del móvil. Recuerda que con esta función se pueden usar los vídeos con presentación.

Los anuncios aparecen en el feed y, al tocarlos, se abren a pantalla completa.

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

Creación de anuncios

Al crear 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. Al usar esta experiencia instantánea en un anuncio de colección, Facebook genera el anuncio automáticamente. Tu experiencia instantánea debe contener:

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 crea una experiencia instantánea con un 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

O crea una experiencia instantánea con un vídeo de plantilla:

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

A continuación, crea canvas_product_set con un valor de product_set_id del 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, los campos item_headline, item_description, image_overlay_spec, storefront_setting y retailer_item_ids son opcionales. Anteriormente, se proporcionaban en la misma llamada para crear el anuncio de colección y el activo de experiencia instantánea subyacente. Ahora se proporcionan en esta llamada.

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

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

Los campos product_set_layout
NombreDescripción

layout_type

Cadena

Obligatorio.. Cómo se mostrará el conjunto de productos.
Valores:GRID_2COL, GRID_3COL, CAROUSEL, HSCROLL_LIST

Para poder usar customized_section_titles, enable_sections se debe establecer en true. El campo customized_section_titles espera una matriz de objetos, cada uno con 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 con el título de la sección predeterminada que quieres 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, shop_by_category

customized_title

Cadena

Obligatorio.
Cadena personalizada alternativa que el espectador 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 quieres, también puedes crear un botón para usarlo 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 proporcionas en el pie de página es relativamente flexible. Anteriormente 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 un vídeo de plantilla, un conjunto de productos, un botón, una ubicación de tienda y un pie de página opcional para la configuración, tendrás que 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 escaparate, tienes que especificar source_template_id = 1932289657009030, que se define en Experiencias instantáneas, Uso de plantillas. Aunque el diseño de cada plantilla es fijo, puedes reemplazar el contenido predeterminado por tus propios vídeos dinámicos, productos, textos y enlaces. Para obtener más información, consulta Experiencias instantáneas, Uso de plantillas.

Creación del anuncio de colección con la experiencia instantánea

Por último, tienes que crear un anuncio de colección. Esto permite que las personas hagan clic en las imágenes o el elemento de vídeo desde el anuncio de colección.

Si el primer elemento de la experiencia instantánea es una foto, debes establecer object_type en 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 la experiencia instantánea es un vídeo, 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 la experiencia instantánea es un vídeo de plantilla, 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 dispones de una función de vista previa de anuncios, puedes proporcionar un valor de ad_format y un identificador de acceso de usuario para generar vistas previas a partir del 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 vídeos de plantilla, los formatos admitidos son BIZ_DISCO_FEED_MOBILE, GROUPS_MOBILE, MOBILE_FEED_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE y WATCH_FEED_MOBILE.

Consulta Vistas previas de anuncios para obtener más información.

Anuncios de colección estándar

Puedes utilizar una plantilla para crear rápidamente una experiencia instantánea para un objetivo de negocio específico. Aunque el diseño de cada plantilla es fijo, puedes reemplazar el contenido predeterminado por tus propios vídeos, imágenes, productos, textos y enlaces. Para obtener más información, consulta Experiencias instantáneas, Uso de plantillas.

Hay dos tipos de anuncios de colección con experiencias instantáneas: basados en imagen y en vídeo, en función del activo que proporciones. Cuando ya tengas el contenido del anuncio, puedes crear el anuncio.

Creación de un anuncio basado en imagen

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 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

NombreDescripción

link

Cadena

Obligatorio
Redirige al espectador a una experiencia instantánea.

collection_thumbnails

Matriz

Obligatorio
Matriz de miniaturas. Se requieren cuatro miniaturas.

Campos collection_thumbnails

NombreDescripción

element_id

Cadena numérica

Obligatorio
Identificador del elemento de la foto de Canvas o de la lista de productos. La foto de Canvas debe asociarse a la experiencia instantánea relacionada con este anuncio de colección. Imagen asociada con este identificador que aparece en la experiencia instantánea cuando alguien hace clic en el anuncio. Un identificador de elemento de imagen principal no es válido.

element_child_index

Entero

Obligatorio para un elemento de foto con etiquetas de producto y un elemento de lista de productos
Índice de productos de una matriz de identificadores de elementos de foto con etiquetas de producto. O bien, índice de productos de una matriz de product_id_list, que contiene los elementos de la lista de productos.
Nota: Debe ser un entero positivo.

element_crops
AdsImageCrops

Obligatorio para un elemento de foto
Objeto JSON que define las dimensiones de recorte para la imagen especificada. Solo se permite la clave de recorte 100x100.

Creación de audiencias de interacción

Puedes crear automáticamente audiencias para las personas que han interactuado con tu anuncio de colección. Es similar a las audiencias de interacción para las experiencias instantáneas estándar. Para obtener más información, consulta Experiencias instantáneas, Audiencias de interacción.

Puedes dirigir tus anuncios de experiencia instantánea con una vista en pantalla completa a las personas que tocaron tu anuncio de colección. Llamamos a este tipo de audiencia audiencia de interacción de experiencia a pantalla completa. Para crear esta audiencia, genera una audiencia personalizada, establece object_id en CANVAS_ID y crea una regla para realizar un seguimiento de uno de los eventos.

Creación de una audiencia que ha 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

Creación de una audiencia que ha 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 están basados en experiencias instantáneas con una plantilla. Por lo tanto, para crear un anuncio de colección mediante un cuadro de diálogo, usarás el cuadro de diálogo Experiencias instantáneas con parámetros adicionales. Este proporcionará el proceso de la interfaz de usuario de creación de anuncios de colección de Facebook en tu sitio web. Para obtener detalles sobre el componente de IU, consulta Cuadros de diálogo.

Para configurar el SDK de Facebook para JavaScript, consulta los siguientes recursos:

El SDK para JavaScript depende de los permisos del usuario que ha iniciado la 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 la empresa especificadas, el cuadro de diálogo mostrará un error. El usuario también debe tener acceso a los conjuntos y catálogos de productos. Para garantizar que no haya errores, el usuario debe tener acceso a Business Manager y disponer de permisos para crear anuncios para la página.

A continuación, puedes activar el cuadro de diálogo de 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 establecer la siguiente configuración para el plugin:

Nombre Descripción

display

Obligatorio
Parámetro necesario con el valor popup establecido.

method

Obligatorio
Parámetro necesario con el valor instant_experiences_builder establecido.

account_id

Obligatorio
Identificador de tu cuenta publicitaria.

business_id

Obligatorio
Identificador de tu empresa.

page_id

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

template_id

Obligatorio
Identificador de la plantilla que quieres utilizar.

product_catalog_id

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

product_set_id

Opcional
Identificador del conjunto de productos que se utilizará en la colección.

Todos los tipos de plantilla válidos y el identificador correspondiente se pueden encontrar en Experiencias instantáneas: Utilizar 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 que 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 correctamente, el plugin devuelve la siguiente respuesta:


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

El id devuelto será una experiencia instantánea sin publicar. Es necesario publicarla para poder usarla en campañas publicitarias.

Si no se recibe ninguna respuesta o se devuelve una respuesta undefined, significa que el usuario ha cerrado el cuadro de diálogo antes de finalizar la experiencia instantánea, o bien que ha guardado dicha experiencia, pero no la ha finalizado. Puedes consultar la API Graph para ver todas las experiencias instantáneas que pertenecen a una página y así comprobar si existe alguna sin finalizar.

Inclusión de catálogos de destinos

Puedes mostrar el contenido del anuncio de un 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 información general, consulta Catálogo de destinos.

Ten en cuenta estas limitaciones:

  • El contenido del vídeo no se admite.
  • Solo se admite la visualización de las imágenes de los catálogos de destinos y hoteles combinadas.
  • No se admite la visualización de otras combinaciones de catálogos.

Para utilizar esta función, añade el parámetro destination_set_id al crear el elemento canvas_photo y, a continuación, 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