Opciones de la especificación de listas de piezas de contenido

Puedes usar las siguientes opciones en asset_feed_spec. Obtén más información de referencia en Especificación de listas de piezas de contenido de anuncios.

Nombre de la propiedad Descripción

Nombre de la propiedad	Descripción
`images` Tipo: matriz de lista	Obligatoria para los formatos `SINGLE_IMAGE` y `CAROUSEL_IMAGE`. Matriz de imágenes que cumplen los requisitos. Las imágenes que se proporcionan en esta matriz se deben incluir en la biblioteca de imágenes de la cuenta publicitaria. Proporciona este campo como una matriz de lista con `{"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}`. Se necesita `url` o `hash`.
`videos` Tipo: matriz de lista	Obligatoria para el formato `SINGLE_VIDEO`. Matriz de valores de `video_id`. Los valores de `video_id` que se proporcionan en esta matriz deben pertenecer a la cuenta publicitaria. Proporciona este campo como una matriz de lista con `{"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}`.
Tipo `carousels` : matriz de lista	Opcional. Matriz de `child_attachments` con los booleanos de `multi_share_end_card` y `multi_share_optimized`, y `adlabels`. El valor de `child_attachments` que se proporciona en esta matriz debe pertenecer a la cuenta publicitaria. Proporciona `child_attachments` como una matriz de lista con `{"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}`. Se necesita `image_label` o `video_label`.
`bodies` Tipo: matriz de lista	Opcional. Matriz de cuerpos. Mensaje principal o texto del anuncio. Proporciona este campo como una matriz de lista de `{"text": "{BODY_TEXT}", "url_tags": "{TAG}"}`.
`call_to_action_types` Tipo: matriz de lista	Obligatoria para todos los objetivos, excepto `OUTCOME_AWARENESS`. Matriz de valores del tipo llamada a la acción. Proporciona estas campo como una matriz de lista de `{"{CALL_TO_ACTION}"}`. Puedes proporcionar varios valores (cinco como máximo).
`titles` Tipo: matriz de lista	Opcional. Matriz de títulos. Un título es un breve encabezado del anuncio, que normalmente se muestra junto a un enlace, una imagen o un vídeo. Proporciona este campo como una matriz de lista de `{"text": "{TITLE}", "url_tags": "{TAG}"}`.
`descriptions` Tipo: matriz de lista	Opcional. Matriz del texto secundario descriptivo, menos destacado que los cuerpos o los títulos. Normalmente se muestra junto a un enlace, una imagen o un vídeo. Si no se especifica, Facebook extrae el enlace proporcionado para generarla. Utiliza una cadena vacía con un solo espacio para una descripción en blanco si no quieres usar el texto extraído. Proporciona este campo como una matriz de lista de `{"text": "{DESCRIPTION}", "url_tags": "{TAG}"}`.
`link_urls` Tipo: matriz de lista	Obligatorio. Matriz de URL de enlaces. Proporciona este campo como una matriz de lista de `{"website_url": "{URL}"}`.
`ad_formats` Tipo: matriz de cadenas	Obligatorio. Matriz de formatos de anuncio de Facebook en la que debemos crear los anuncios. Los formatos admitidos son `SINGLE_IMAGE`, `CAROUSEL`, `SINGLE_VIDEO` y `AUTOMATIC_FORMAT`. Proporciona este campo como una matriz de cadenas `["{AD_FORMAT}"]`.
`optimization_type` Tipo: cadena	Opcional. Tipo de optimización que se utiliza en la lista de piezas de contenido. Los posibles valores son `ASSET_CUSTOMIZATION`, `LANGUAGE`, `PLACEMENT` y `REGULAR`.
`message_extensions` Tipo: matriz de cadenas	Opcional. Tipo de extensión de mensajes que se utiliza en la lista de piezas de contenido. Valor posible: `whatsapp`.
Tipo `onsite_destinations` : matriz de lista	Obligatoria para los anuncios de tiendas. Es válida para los anuncios estáticos y los formatos `SINGLE_IMAGE`, `SINGLE_VIDEO` o `CAROUSEL`. Proporciona este campo como una matriz de lista con uno de los siguientes valores para especificar el destino de la tienda en el sitio. {"storefront_shop_id": "<SHOP_STOREFRONT_ID>"} or {"shop_collection_product_set_id": "<PRODUCT_SET_ID>" or {"details_page_product_id": "<PRODUCT_ID>"}
Tipo `shops_bundle` : booleano	Obligatoria para los anuncios de tiendas. Es válida para los anuncios de catálogo de Advantage+. Proporciona este campo para la optimización de tiendas. Incluye los tipos de optimización de tiendas `reasons_to_shop` y `automated_product_tags`. Posibles valores: `true` y `false`.
Tipo `reasons_to_shop` : booleano	Obligatoria para los anuncios de tiendas. Es válida para los anuncios de catálogo de Advantage+. Proporciona este campo para la optimización de tiendas. Destaca automáticamente la información del producto de la tienda, como “Envío gratis”, “Tendencia” o “Pocas existencias”. Posibles valores: `true` y `false`.

images

Tipo: matriz de lista

Obligatoria para los formatos SINGLE_IMAGE y CAROUSEL_IMAGE.

Matriz de imágenes que cumplen los requisitos. Las imágenes que se proporcionan en esta matriz se deben incluir en la biblioteca de imágenes de la cuenta publicitaria.

Proporciona este campo como una matriz de lista con {"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}. Se necesita url o hash.

videos

Tipo: matriz de lista

Obligatoria para el formato SINGLE_VIDEO.

Matriz de valores de video_id. Los valores de video_id que se proporcionan en esta matriz deben pertenecer a la cuenta publicitaria.

Proporciona este campo como una matriz de lista con {"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}.

Tipo carousels
: matriz de lista

Opcional.
Matriz de child_attachments con los booleanos de multi_share_end_card y multi_share_optimized, y adlabels. El valor de child_attachments que se proporciona en esta matriz debe pertenecer a la cuenta publicitaria.

Proporciona child_attachments como una matriz de lista con {"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}. Se necesita image_label o video_label.

bodies

Tipo: matriz de lista

Opcional.

Matriz de cuerpos. Mensaje principal o texto del anuncio.

Proporciona este campo como una matriz de lista de {"text": "{BODY_TEXT}", "url_tags": "{TAG}"}.

call_to_action_types

Tipo: matriz de lista

Obligatoria para todos los objetivos, excepto OUTCOME_AWARENESS.

Matriz de valores del tipo llamada a la acción.

Proporciona estas campo como una matriz de lista de {"{CALL_TO_ACTION}"}. Puedes proporcionar varios valores (cinco como máximo).

titles

Tipo: matriz de lista

Opcional.

Matriz de títulos. Un título es un breve encabezado del anuncio, que normalmente se muestra junto a un enlace, una imagen o un vídeo.

Proporciona este campo como una matriz de lista de {"text": "{TITLE}", "url_tags": "{TAG}"}.

descriptions

Tipo: matriz de lista

Opcional.

Matriz del texto secundario descriptivo, menos destacado que los cuerpos o los títulos. Normalmente se muestra junto a un enlace, una imagen o un vídeo. Si no se especifica, Facebook extrae el enlace proporcionado para generarla. Utiliza una cadena vacía con un solo espacio para una descripción en blanco si no quieres usar el texto extraído.

Proporciona este campo como una matriz de lista de {"text": "{DESCRIPTION}", "url_tags": "{TAG}"}.

link_urls

Tipo: matriz de lista

Obligatorio.

Matriz de URL de enlaces.

Proporciona este campo como una matriz de lista de {"website_url": "{URL}"}.

ad_formats

Tipo: matriz de cadenas

Obligatorio.

Matriz de formatos de anuncio de Facebook en la que debemos crear los anuncios. Los formatos admitidos son SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO y AUTOMATIC_FORMAT.

Proporciona este campo como una matriz de cadenas ["{AD_FORMAT}"].

optimization_type

Tipo: cadena

Opcional.

Tipo de optimización que se utiliza en la lista de piezas de contenido. Los posibles valores son ASSET_CUSTOMIZATION, LANGUAGE, PLACEMENT y REGULAR.

message_extensions

Tipo: matriz de cadenas

Opcional.
Tipo de extensión de mensajes que se utiliza en la lista de piezas de contenido.

Valor posible: whatsapp.

Tipo onsite_destinations
: matriz de lista

Obligatoria para los anuncios de tiendas. Es válida para los anuncios estáticos y los formatos SINGLE_IMAGE, SINGLE_VIDEO o CAROUSEL.
Proporciona este campo como una matriz de lista con uno de los siguientes valores para especificar el destino de la tienda en el sitio.

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

Tipo shops_bundle
: booleano

Obligatoria para los anuncios de tiendas. Es válida para los anuncios de catálogo de Advantage+.
Proporciona este campo para la optimización de tiendas. Incluye los tipos de optimización de tiendas reasons_to_shop y automated_product_tags.
Posibles valores: true y false.

Tipo reasons_to_shop
: booleano

Obligatoria para los anuncios de tiendas. Es válida para los anuncios de catálogo de Advantage+.
Proporciona este campo para la optimización de tiendas. Destaca automáticamente la información del producto de la tienda, como “Envío gratis”, “Tendencia” o “Pocas existencias”.
Posibles valores: true y false.

Restricciones de la especificación de listas de piezas de contenido

Formatos de anuncio

Valores de ad_formats admitidos: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO y AUTOMATIC_FORMAT.
Solo se admite un valor de ad_format por lista de piezas de contenido.
ad_format se considera una pieza de contenido en la lista de piezas de contenido.

Número de piezas de contenido:

Máximo de 30 piezas de contenido en total. Por ejemplo, tienes 28 piezas de contenido con diez images, cinco bodies, cinco titles, cinco description, un ad_format, un link_url y un call_to_action_types.
Número total de imágenes: <= 10.
Número total de vídeos: <= 10. Si usas Instagram como ubicación, solo se permiten los vídeos cuadrados o en horizontal.
Número total de cuerpos: <= 5.
Número total de llamadas a la acción: <= 5.
Número total de títulos: <= 5.
Número total de enlaces: <= 5.
Número total de descripciones: <= 5.

Requisitos de las imágenes:

Especificaciones de imagen recomendadas: 1,9:1.
Tamaño de imagen recomendado: 1200 × 628 píxeles.
Para el formato CAROUSEL_IMAGE, debes proporcionar al menos dos imágenes.
Si usas Instagram como ubicación, usa imágenes cuadradas para conseguir un mejor rendimiento.

Requisitos del texto:

Título y texto de la descripción: longitud máxima de 255 caracteres.
Texto del cuerpo: longitud máxima de 1024 caracteres.
Si no especificas ninguna descripción, extraemos el enlace proporcionado para recuperar una descripción.
Para CAROUSEL_IMAGE, los títulos son opcionales.

Los valores de url_tags son opcionales y solo están disponibles para images, videos, bodies, descriptions y titles. Facebook añade url_tags a la URL del enlace como parámetros para cada pieza de contenido de un anuncio.

Por ejemplo, una configuración válida de una combinación de listas de piezas de contenido para el formato SINGLE_IMAGE es la siguiente:

Cinco images
Tres bodies
Tres titles
Tres descriptions
Un formato: SINGLE_IMAGE
Dos link_urls

"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]"

Usar enlaces profundos

Puedes usar enlaces profundos en las especificaciones de listas de piezas de contenido con los siguientes objetivos:

APP_INSTALLS
CONVERSIONS
LINK_CLICKS

Añade deeplink_url en link_urls al crear asset_feed_spec.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F "asset_feed_spec={'images': [{'hash':'image_hash'}], 'bodies': [{'text':'Body 1'}, {'text':'Body 2'}], 'titles': [{'text':'Title 1'}, {'text':'Title 2'}], 'descriptions': [{'text':' '}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'App's object store URL','deeplink_url':'deeplink URL'}]}" \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Anuncios del sitio web a WhatsApp

Puedes crear anuncios que envíen a los usuarios a tu sitio web con un botón de WhatsApp que aparece en la parte inferior de la pantalla para que puedan ponerse en contacto contigo al instante. De esta forma, podrán conectar contigo en WhatsApp mientras visitan tu sitio web.

Añade message_extensions al crear asset_feed_spec.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F 'asset_feed_spec={"images": [{"hash":"image_hash"}], "bodies": [{"text":"Body 1"}, {"text":"Body 2"}],"titles": [{"text":"Title 1"}, {"text":"Title 2"}], "descriptions": [{"text":" "}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"business URL"}], "message_extensions": [{"type": "whatsapp"}]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives