Contenido multimedia dinámico

El contenido multimedia dinámico permite a los anunciantes entregar recursos de video desde sus anuncios de catálogo Advantage+.

Antes de empezar

Necesitarás lo siguiente:

• Un catálogo de productos con productos ya cargados
• Un video de cada producto en formato URL de video descargable

Consulta la documentación de los anuncios de catálogo Advantage+ para obtener más información sobre su funcionamiento.

Limitaciones

• Recomendamos usar un mínimo de 20 productos, aunque no hay un mínimo obligatorio.
• El tamaño de cada video no debe superar los 200 MB. No hay restricciones en cuanto a la duración.
• Los videos deben estar en uno de los siguientes formatos: 3g2, 3gp, 3gpp, asf, avi, dat, divx, dv, f4v, flv, gif, m2ts, m4v, mkv, mod, mov, mp4, mpe, mpeg, mpeg4, mpg, mts, nsv, ogm, ogv, qt, tod, ts, vob o wmv.
• El video_fetch_status puede mostrarse como NO_STATUS hasta que el video se use en un anuncio u otro evento que requiera la activación del video.

Agregar videos a tu catálogo

Puedes agregar videos a artículos de productos del catálogo de tres formas: el archivo de lista del catálogo, la API por lotes de catálogo y la carga manual a través del administrador de catálogos.

Agregar videos con el archivo de lista del catálogo

Paso 1. Prepara el archivo de lista del catálogo

Puedes usar uno de los siguientes procesos para implementar tu archivo de lista de catálogo.

• Proceso 1: Cambiar la lista principal

  • Agrega una columna video[0].url al archivo de lista de catálogo que ya tienes, completa la URL de video solo en el caso de los productos seleccionados y deja vacías las filas de los otros productos.
  • Se pueden agregar más videos de los mismos productos con columnas adicionales: video[1].url, video[2].url, video[3].url, etc.
  • Si quieres agregar etiquetas a los videos, inclúyelas en columnas separadas. Por ejemplo: video[0].tag[0], video[0].tag[1], video[1].tag[0], y así sucesivamente.
• Proceso 2: Lista suplementaria
  Prepara un archivo de lista de catálogo suplementaria para agregar a una lista cargada previamente. Esta lista suplementaria solo puede agregar o reemplazar videos en artículos de productos que ya existen. Agrega una columna video[0].url y una columna de identificador para asociar el video con el identificador del producto.

Opcional:
en lugar de la columna video[0].url, puedes crear una columna llamada video y agregar una etiqueta al video. La columna video puede incluir varias URL de video por productos y muchas etiquetas por URL codificadas en un formato JSON. Si eliges usar una columna de etiquetas para el filtro de conjunto de productos, también tendrás que agregarla al archivo de lista.

En el caso de una lista de XML, las URL de video se pueden agregar usando etiquetas como <video>:

<video><url>https://{URL1}</url><tag>video_product_set1</tag><tag>video_product_set2 </tag></video><video><url>https://{URL2}</url><tag>video_product_set1</tag></video>

Consultar datos de videos en la API de productos

Los campos videos, videos_metadata y video_fetch_status están disponibles en las API del catálogo para recuperar detalles en video del producto del catálogo.

curl -i GET \ "http://graph.facebook.com/v25.0/<PRODUCT_ITEM_ID>?fields=videos,videos_metadata,video_fetch_status"

Para obtener información detallada sobre un video, consulta Productos.

Agregar videos con la API de lotes para catálogos

Los productos se pueden actualizar con el punto de conexión /{product_catalog_id}/items_batch. Puedes hacer una llamada a la API POST con el campo video, que es una matriz de URL.

curl \
  -d @body.json \
  -H "Content-Type: application/json"

> cat body.json
{
  "access_token": "<ACCESS_TOKEN>",
  "item_type": "PRODUCT_ITEM",
  "requests": [
    {
      "method": "CREATE",
      "data": {
        "id": "retailer-2",
        "availability": "in stock",
        "brand": "BrandName",
        "google_product_category": "t-shirts",
        "description": "product description",
        "image_link": "http://www.images.example.com/t-shirts/1.png",
        "title": "product name",
        "price": "10.00 USD",
        "shipping": [
          {
            "shipping_country": "US",
            "shipping_region": "CA",
            "shipping_service": "service",
            "shipping_price_value": "10",
            "shipping_price_currency": "USD"
          }
        ],
        "condition": "new",
        "link": "http://www.images.example.com/t-shirts/1.png",
        "item_group_id": "product-group-1",
        "video": [
          {"url": "http://www.jaspersmarket-example1.com/video-file.avi", "tag": ["Optional Tag1", "Optional Tag2"]}, 
          {"url": "http://www.jaspersmarket-example2.com/video-file.avi", "tag": ["Optional Tag1", "Optional Tag2"]}
        ]
      }
    },
    {
      "method": "UPDATE",
      "data": {
        "availability": "out of stock",
        "id": "retailer-3",
        "video": [
          {
            "url": "https://yourvideo.com/demo.mp4?q=1411"
          },
          {
            "url": "https://yourvideo.com/demo.mp4?q=1421"
          }
        ]
      }
    }
  ]
}

Consulta este ejemplo en el explorador de la API Graph.

Crear anuncios con contenido multimedia dinámico

Cuando creas anuncios, puedes usar tres tipos de opciones que aprovechan los videos del catálogo:

• Contenido multimedia en secuencias/colecciones (recomendado)
• Mostrar video cuando está disponible (solo disponible en ciertos formatos de anuncios)
• Imagen única incluida en contenido multimedia dinámico

Nota: Seleccionar el tipo de contenido multimedia dinámico con la API es similar a seleccionar las opciones de Contenido multimedia dinámico en el administrador de anuncios. Debido a los cambios que se implementarán a partir de septiembre de 2025, los anuncios de catálogo Advantage+ se incluirán en contenido multimedia dinámico de manera predeterminada.

Anuncios de tipo de contenido multimedia dinámico

Cuando creas un objeto de contenido del anuncio con el punto de conexión act_<AD_ACCOUNT_ID>/adcreatives

• A partir de septiembre de 2025, los anuncios del catálogo Advantage+ comenzarán a entregar videos de productos de catálogo de forma predeterminada. Puedes configurar media_type_automation en OPT_out para evitar que los videos de productos del catálogo aparezcan en los anuncios.
• La clave media_type_automation funciona con secuencias, colecciones y formatos de imagen única.

curl -X POST \ -F 'name=Dynamic Media Ad Creative' \ -F 'object_story_spec={ ... }' \ -F 'degrees_of_freedom_spec={ "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }' \ -F 'product_set_id=<PRODUCT_SET_ID>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

De la misma manera, si se crea un objeto publicitario de catálogo Advantage+ con el punto de conexión act_<AD_ACCOUNT_ID>/ads, el anuncio comenzará a entregar videos de productos de catálogo disponibles de forma predeterminada. Puedes configurar la clave media_type_automation en OPT_out para evitar que los videos de productos del catálogo aparezcan en los anuncios.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { ... }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

Anuncios de contenido multimedia dinámico (con formato de colección)

• El contenido multimedia dinámico solo reemplaza el contenido multimedia principal. Las imágenes en miniatura de los productos en la experiencia previa al clic y la experiencia instantánea siempre serán imágenes.
• Si se acepta el contenido multimedia dinámico y hay un video del producto disponible, reemplazaremos el video dinámico de contenido multimedia principal con el video del producto. Los anuncios de catálogo Advantage+ en formato de colección se activarán en el contenido multimedia dinámico de forma predeterminada y comenzarán a entregar videos de productos de catálogo a partir de septiembre de 2025. Puedes seguir configurando la clave media_type_automation en OPT_OUT para evitar que los videos de productos del catálogo aparezcan en los anuncios.
• El contenido multimedia dinámico solo reemplaza contenido multimedia dinámico principal con videos si se aceptó esa opción. Actualmente, no se reemplazarán imágenes y videos estáticos principales con un video del producto, es decir, la experiencia de presentación de imágenes se reemplaza con un video del producto.

Ejemplo de especificación de contenido para la colección con contenido multimedia dinámico

curl -X POST \ -F 'name=Dynamic Media Ad Creative' \ -F 'object_story_spec={ "template_data": { ... "format_option": "collection_video", "link": "https://fb.com/canvas_doc/<CANVAS_ID>", "message": "Your Collection Ad", ... } }' \ -F 'degrees_of_freedom_spec={ "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } }' \ -F 'product_set_id=<PRODUCT_SET_ID>' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

Anuncios de contenido multimedia dinámico (muestra videos cuando están disponibles)

En object_story_spec, cambia format_option a single_video. Esto solo está disponible para formatos de una sola imagen o un solo video.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { ... "format_option": "single_video", ... } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

Anuncios de contenido multimedia dinámico (imagen única incluida en contenido multimedia dinámico)

En object_story_spec, la format_option de single_image mostrará contenido multimedia dinámico cuando se incluya en media_type_automation.

A partir de septiembre de 2025, en los anuncios de catálogo Advantage+ que usen format_option de single_image, se activará de forma predeterminada el contenido multimedia dinámico y aparecerán videos de productos de catálogo disponibles en los anuncios. Puedes configurar media_type_automation en OPT_OUT para evitar que los videos de productos del catálogo aparezcan en los anuncios.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { "page_id": "<PAGE_ID>", "template_data": { "format_option": "single_image" } }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "enroll_status": "OPT_IN" } } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

Opcional: activar o desactivar el recorte de videos automático

Usa el campo video_crop_style para controlar el recorte de videos automático. Los valores posibles son AUTO o NONE.

Para desactivar el recorte de videos automático, configura el campo video_crop_style en NONE o elimina las personalizaciones de la configuración de media_type_automation.

curl -X POST \ -F 'adset_id=<ADSET_ID>' \ -F 'creative={ "name": "Dynamic Media Ad Creative", "object_story_spec": { ... }, "degrees_of_freedom_spec": { "creative_features_spec": { "media_type_automation": { "customizations": { "video_crop_style": "NONE" }, "enroll_status": "OPT_IN" } } }, "product_set_id": "<PRODUCT_SET_ID>" }' \ https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads

El recorte automático solo se aplica a los videos que no cumplen los requisitos de ubicación y tamaño. Actualmente, la función principal del recorte automático es ajustar el video a las dimensiones del reproductor.

Si la relación de aspecto de un video coincide con la de la ubicación del anuncio, se devolverá el video. Si se proporcionan todas las relaciones de aspecto de un video determinado, no se llevará a cabo el recorte automático. De lo contrario, el anuncio seleccionará un video del artículo y verificará la configuración del recorte automático: AUTO devuelve el video recortado y NONE devuelve el video original.

Estadísticas del contenido multimedia dinámico

Las métricas de las interacciones de video del administrador de anuncios también se pueden consultar en la API. Usa la siguiente tabla para comparar los resultados.

Ejemplo de solicitud

curl GET \ -d 'access_token=<ACCESS_TOKEN>' \ -d 'fields=impressions,video_continuous_2_sec_watched_actions,actions,video_thruplay_watched_actions' \ https://graph.facebook.com/v25.0/<AD_ID>/insights

Consulta la documentación sobre la API de estadísticas para obtener más información.