Opciones de especificación de la lista de activos

Puedes usar las siguientes opciones en tu asset_feed_spec. Consulta Especificaciones de la lista de activos del anuncio para obtener más información de referencia.

Nombre de la propiedad Descripción

Nombre de la propiedad	Descripción
`images` Tipo: matriz de lista	Obligatorio para el formato `SINGLE_IMAGE` y `CAROUSEL_IMAGE`. Matriz de imágenes elegibles. Las imágenes proporcionadas en esta matriz deben estar incluidas en la biblioteca de imágenes de la cuenta publicitaria. Proporciona este campo como una matriz de lista que contenga `{"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}`. Se requiere `url` o `hash`.
`videos` Tipo: matriz de lista	Obligatorio para el formato `SINGLE_VIDEO`. Matriz de `video_id`. Los `video_id` que se proporcionan en esta matriz deben pertenecer a la cuenta publicitaria. Proporciona este campo como una matriz de lista que contenga `{"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}`
`carousels` Tipo: matriz de lista	Obligatorio para el formato. Matriz de `child_attachments` junto con los booleanos `multi_share_end_card` y `multi_share_optimized`, y `adlabels`. Los `child_attachments` que se proporcionan en esta matriz deben pertenecer a la cuenta publicitaria. Proporciona `child_attachments` como una matriz de lista que contenga `{"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 requiere `image_label` o `video_label`.
`bodies` Tipo: matriz de lista	Opcional. Matriz de cuerpos. El mensaje principal o copia del anuncio. Proporciona este campo como matriz de lista de `{"text": "{BODY_TEXT}", "url_tags": "{TAG}"}`.
`call_to_action_types` Tipo: matriz de lista	Obligatorio para todos los objetivos, excepto `OUTCOME_AWARENESS`. Matriz de valores del tipo de llamada a la acción. Proporciona este campo como matriz de lista de `{"{CALL_TO_ACTION}"}`. Puedes proporcionar múltiples valores hasta un máximo de cinco.
`titles` Tipo: matriz de lista	Opcional. Matriz de títulos. Un título es un encabezado breve del anuncio que suele aparece junto a un enlace, una imagen o un video. Proporciona este campo como una matriz de lista de `{"text": "{TITLE}", "url_tags": "{TAG}"}`.
`descriptions` Tipo: matriz de lista	Opcional. Matriz del texto de descripción secundario; se muestra menos prominente que los cuerpos o los títulos. Suele aparece junto a un enlace, imagen o vídeo. Si no se especifica, Facebook extrae el enlace que proporcionaste para generarlo. Utiliza una cadena vacía con un solo espacio para proporcionar una descripción en blanco, si no quieres usar el texto que se extrajo. Proporciona este campo como 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 matriz de lista de `{"website_url": "{URL}"}`.
`ad_formats` Tipo: matriz de cadenas	Obligatorio. Matriz de formatos de anuncios de Facebook en la que deberás crear los anuncios. Los formatos admitidos son: `SINGLE_IMAGE`, `CAROUSEL`, `SINGLE_VIDEO` y `AUTOMATIC_FORMAT`. Proporciona este campo como matriz de cadenas `["{AD_FORMAT}"]`.
`optimization_type` Tipo: cadena	Opcional. Tipo de optimización usado en la lista de activos. Los valores posibles son `ASSET_CUSTOMIZATION`, `LANGUAGE`, `PLACEMENT` y `REGULAR`.
`message_extensions` Tipo: matriz de cadenas	Opcional. Tipo de extensión de mensaje utilizado en la lista de activos. Valor posible: `whatsapp`
`onsite_destinations` Tipo: matriz de lista	Obligatorio para los anuncios de tiendas. Válido para anuncios estáticos; formato `SINGLE_IMAGE`, `SINGLE_VIDEO` o `CAROUSEL`. Proporciona este campo como una matriz de lista que contenga alguno de los siguientes valores para especificar el destino de tu 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>"}
`shops_bundle` Tipo: booleano	Obligatorio para los anuncios de tiendas. Válido para anuncios de catálogo Advantage+. Proporciona este campo para optimizar la tienda. Incluye ambos tipos de optimización de tiendas `reasons_to_shop` y `automated_product_tags`. Posibles valores: `true`, `false`
`reasons_to_shop` Tipo: booleano	Obligatorio para los anuncios de tiendas. Válido para anuncios de catálogo Advantage+. Proporciona este campo para optimizar la tienda. Destaca automáticamente la información del producto de tu tienda, como "envío gratuito", "tendencia" o "bajo stock". Posibles valores: `true`, `false`

images

Tipo: matriz de lista

Obligatorio para el formato SINGLE_IMAGE y CAROUSEL_IMAGE.

Matriz de imágenes elegibles. Las imágenes proporcionadas en esta matriz deben estar incluidas en la biblioteca de imágenes de la cuenta publicitaria.

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

videos

Tipo: matriz de lista

Obligatorio para el formato SINGLE_VIDEO.

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

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

carousels
Tipo: matriz de lista

Obligatorio para el formato.
Matriz de child_attachments junto con los booleanos multi_share_end_card y multi_share_optimized, y adlabels. Los child_attachments que se proporcionan en esta matriz deben pertenecer a la cuenta publicitaria.

Proporciona child_attachments como una matriz de lista que contenga {"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 requiere image_label o video_label.

bodies

Tipo: matriz de lista

Opcional.

Matriz de cuerpos. El mensaje principal o copia del anuncio.

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

call_to_action_types

Tipo: matriz de lista

Obligatorio para todos los objetivos, excepto OUTCOME_AWARENESS.

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

Proporciona este campo como matriz de lista de {"{CALL_TO_ACTION}"}. Puedes proporcionar múltiples valores hasta un máximo de cinco.

titles

Tipo: matriz de lista

Opcional.

Matriz de títulos. Un título es un encabezado breve del anuncio que suele aparece junto a un enlace, una imagen o un video.

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

descriptions

Tipo: matriz de lista

Opcional.

Matriz del texto de descripción secundario; se muestra menos prominente que los cuerpos o los títulos. Suele aparece junto a un enlace, imagen o vídeo. Si no se especifica, Facebook extrae el enlace que proporcionaste para generarlo. Utiliza una cadena vacía con un solo espacio para proporcionar una descripción en blanco, si no quieres usar el texto que se extrajo.

Proporciona este campo como 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 matriz de lista de {"website_url": "{URL}"}.

ad_formats

Tipo: matriz de cadenas

Obligatorio.

Matriz de formatos de anuncios de Facebook en la que deberás crear los anuncios. Los formatos admitidos son: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO y AUTOMATIC_FORMAT.

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

optimization_type

Tipo: cadena

Opcional.

Tipo de optimización usado en la lista de activos. Los valores posibles son ASSET_CUSTOMIZATION, LANGUAGE, PLACEMENT y REGULAR.

message_extensions

Tipo: matriz de cadenas

Opcional.
Tipo de extensión de mensaje utilizado en la lista de activos.

Valor posible: whatsapp

onsite_destinations
Tipo: matriz de lista

Obligatorio para los anuncios de tiendas. Válido para anuncios estáticos; formato SINGLE_IMAGE, SINGLE_VIDEO o CAROUSEL.
Proporciona este campo como una matriz de lista que contenga alguno de los siguientes valores para especificar el destino de tu 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>"}

shops_bundle
Tipo: booleano

Obligatorio para los anuncios de tiendas. Válido para anuncios de catálogo Advantage+.
Proporciona este campo para optimizar la tienda. Incluye ambos tipos de optimización de tiendas reasons_to_shop y automated_product_tags.
Posibles valores: true, false

reasons_to_shop
Tipo: booleano

Obligatorio para los anuncios de tiendas. Válido para anuncios de catálogo Advantage+.
Proporciona este campo para optimizar la tienda. Destaca automáticamente la información del producto de tu tienda, como "envío gratuito", "tendencia" o "bajo stock".
Posibles valores: true, false

Restricciones aplicables a las especificaciones de la lista de activos

Formatos de anuncio

Se admiten ad_formats: SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO y AUTOMATIC_FORMAT.
Solo se admite un ad_format por cada lista de activos.
ad_format cuenta como un activo de una lista de activos.

Número de activos:

Máximo 30 activos totales. Por ejemplo, tienes 28 activos compuestos por 10 images, 5 bodies, 5 titles, 5 description, 1 ad_format, 1 link_url y 1 call_to_action_types.
Número total de imágenes: <= 10.
Número total de videos: <= 10. Si usas Instagram como tu ubicación, solo se permiten videos cuadrados u horizontales.
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 la imagen:

Especificaciones de la imagen recomendadas: 1.9:1.
Tamaño de imagen recomendado: 1.200 x 628 píxeles.
En relación con el formato CAROUSEL_IMAGE, debes proporcionar al menos 2 imágenes.
Si usas Instagram como tu ubicación, usa imágenes cuadradas para que el rendimiento sea mejor.

Requisitos del texto:

Título y texto de la descripción: longitud máxima de 255 caracteres.
Texto del cuerpo: longitud máxima de 1.024 caracteres.
Si no especificas ninguna descripción, extraemos el enlace que nos proporcionaste para recuperar una descripción.
En relación con CAROUSEL_IMAGE, los títulos son opcionales.

url_tags son opcionales y solo están disponibles para images, videos, bodies, descriptions y titles. Facebook agrega url_tags a la URL del enlace como parámetros de los activos de un anuncio.

Por ejemplo, una configuración válida en relación con la combinación de las listas de activos para el formato SINGLE_IMAGE es la siguiente:

5 images
3 bodies
3 titles
3 descriptions
1 formato: SINGLE_IMAGE
2 link_urls

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

Usar enlaces profundos

Puedes usar enlaces profundos en las especificaciones de la lista de activos de las campañas con los siguientes objetivos:

APP_INSTALLS
CONVERSIONS
LINK_CLICKS

Agrega deeplink_url en link_urls al crear tu 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

Sitio web a anuncios de WhatsApp

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

Agrega message_extensions al crear tu 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