API de marketing

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 comenzar

Necesitarás lo siguiente:

  • Un catálogo de productos con productos reales
  • 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

  • Actualmente, esta función admite videos de hasta 30.000 productos por catálogo.
  • 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.

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

Con el archivo de lista del catálogo, puedes proporcionar hasta 30.000 productos con URL de video en el nivel de los productos.

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.
  • Proceso 2: Lista suplementaria
    Prepara un archivo de lista de catálogo suplementaria para agregarla a una carga de lista preexistente. 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. Si eliges usar una columna de etiquetas para el filtro de conjunto de productos, también tendrás que agregarla al archivo de lista.

Ejemplo de formato de columna de video:
[{"url": "http://www.jaspersmarket.com/video-file.avi", tag: ["Optional Tag1", "Optional Tag2"]}]

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></video><video><url>https://{URL2}</url><tag>video_product_set1</tag></video>

Agregar videos con la API de lotes para catálogos

Se admiten las actualizaciones de los productos si se usa 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": "https://yourvideo.com/demo.mp4?q=1411"
          },
          {
            "url": "https://yourvideo.com/demo.mp4?q=1421"
          }
        ]
      }
    },
    {
      "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 dos tipos de opciones que aprovechan los videos del catálogo:

  • Tipo de contenido multimedia dinámico (secuencia/colección) (recomendado)
  • Mostrar video cuando está disponible (solo disponible en ciertos formatos de anuncios)

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.

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

  • Configura la clave media_type_automation en OPT_IN.
  • Esta clave funciona con los formatos de secuencia y colección.
curl \
-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/v18.0/act_<AD_ACCOUNT_ID>/adcreatives

O cuando creas un objetivo del anuncio con el punto de conexión act_<AD_ACCOUNT_ID>/ads, configura la clave media_type_automation para que sea OPT_IN.

curl \
  -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/v19.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.
  • El contenido multimedia dinámico solo reemplaza el video dinámico de contenido multimedia principal si se aceptó esa opción. Actualmente, no se reemplazarán la imagen y el video principal con un video del producto, es decir, la experiencia de presentación de imágenes es reemplazada con un video del producto.

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

curl \
-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/v19.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 \
  -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/v19.0/act_<AD_ACCOUNT_ID>/ads