Mídia dinâmica

Com a mídia dinâmica, os anunciantes podem usar ativos de vídeo do seu catálogo nos anúncios de catálogo Advantage+.

Antes de começar

Você precisará do seguinte:

• Um catálogo de produtos com produtos cadastrados
• Um vídeo para cada produto em formato de URL de vídeo disponível para baixar

Consulte a documentação sobre anúncios de catálogo Advantage+ para saber mais sobre como isso funciona.

Limitações

• Recomendamos ter pelo menos 20 produtos, mas não há quantidade mínima obrigatória.
• Cada vídeo não pode exceder 200 MB. Não há restrições de tempo.
• Os vídeos devem estar em um dos seguintes 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 ou wmv.
• O video_fetch_status pode aparecer como NO_STATUS até que o vídeo seja usado em um anúncio ou em outro evento que exija seu disparo.

Adicionar vídeos ao catálogo

Há 3 formas de adicionar vídeos a produtos em um catálogo: arquivo de feed do catálogo, API em lote do catálogo e carregamento manual pelo Gerenciador de Comércio.

Adicionar vídeos com o arquivo de feed do catálogo

Etapa 1. Preparar o arquivo de feed do catálogo

Você pode usar um dos seguintes processos para implementar o arquivo de feed do catálogo.

• Processo 1: alterar o feed principal

  • Adicione uma coluna video[0].url ao arquivo de feed de catálogo existente, especifique o URL do vídeo somente para os produtos selecionados e deixe as demais linhas de produto vazias.
  • É possível adicionar mais de um vídeo para o mesmo produto com colunas adicionais: video[1].url, video[2].url, video[3].url e assim por diante.
  • As tags podem ser adicionadas aos vídeos em colunas separadas. Por exemplo: video[0].tag[0], video[0].tag[1], video[1].tag[0] e assim por diante.
• Processo 2: incluir feed complementar
  prepare outro arquivo de feed de catálogo para complementar o feed atualmente carregado. Este feed complementar só pode adicionar ou substituir vídeos a produtos já existentes. Adicione uma coluna video[0].url e uma coluna de ID para associar o vídeo ao ID do produto.

Opcional:
Em vez de usar a coluna video[0].url, você pode criar uma coluna chamada video e adicionar uma tag ao vídeo. A coluna video pode incluir diversos URLs de vídeo por produto e várias tags por URL codificadas em formato JSON. Se optar por usar uma coluna de tag para o filtro de produtos, será necessário adicioná-la ao arquivo de feed também.

Para feeds XML, é possível adicionar URLs de vídeo usando tags <video> da seguinte forma:

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

Consulte dados de vídeo da API do item do produto

Os campos videos, videos_metadata e video_fetch_status estão disponíveis nas APIs do catálogo para gerar detalhes sobre os vídeos de produtos associados.

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

Para saber mais sobre os vídeos, consulte os detalhes do Item de produto.

Adicionar vídeos com a API em lote de catálogo

É possível promover alterações em produtos usando o ponto de extremidade /{product_catalog_id}/items_batch. Você pode fazer uma chamada de API POST com o campo video, que é uma matriz de URLs.

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"
          }
        ]
      }
    }
  ]
}

Veja este exemplo no Explorador da Graph API.

Criar anúncios com mídia dinâmica

Na criação de anúncios, há três opções que usam vídeos do catálogo:

• Mídia dinâmica de coleção/carrossel (recomendada)
• Exibir vídeo quando disponível (apenas para vídeo único)
• Imagem única com mídia dinâmica

Observação: selecionar "mídia dinâmica" com a API é semelhante a selecionar as opções de Mídia dinâmica no Gerenciador de Anúncios. A partir de setembro de 2025, os anúncios de catálogo Advantage+ usarão mídia dinâmica por padrão.

Anúncios de mídia dinâmica

Ao criar um objeto de criativo de anúncio com o ponto de extremidade act_<AD_ACCOUNT_ID>/adcreatives

• A partir de setembro de 2025, os anúncios de catálogo Advantage+ começarão a veicular vídeos de produtos do catálogo por padrão. É possível definir media_type_automation como OPT_out para desativar os vídeo de produtos do catálogo em anúncios.
• A chave media_type_automation funciona com formatos de carrossel, coleção e imagem ú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

Da mesma forma, ao criar um objeto de anúncio de catálogo Advantage+ usando o ponto de extremidade act_<AD_ACCOUNT_ID>/ads, o anúncio começará a veicular os vídeos de produtos do catálogo disponíveis por padrão. É possível definir media_type_automation como OPT_out para desativar os vídeo de produtos do catálogo em anúncios.

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

Anúncios de mídia dinâmica (com formato de coleção)

• Mídia dinâmica substitui apenas conteúdo principal. Miniaturas de produto em experiências pré-clique e instantâneas sempre serão imagens.
• Ao decidir por mídia dinâmica, se o vídeo do produto estiver disponível, substituiremos a mídia principal de vídeo dinâmica por um vídeo do produto. Os anúncios de catálogo Advantage+ no formato de coleção terão mídia dinâmica ativada por padrão e começarão a veicular vídeos de produtos do catálogo a partir de setembro de 2025. É possível definir media_type_automation como OPT_out para desativar os vídeo de produtos do catálogo em anúncios.
• A mídia dinâmica só substitui a mídia principal de vídeo dinâmica se ativada. No momento, uma imagem ou vídeo principal estáticos não serão substituídos por um vídeo de produto, ou seja, a experiência de apresentação de imagens é substituída por um vídeo de produto.

Exemplo de especificação do criativo para coleção com mídia dinâmica

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

Anúncios de mídia dinâmica (exibir vídeos quando disponíveis)

Em object_story_spec, altere format_option para single_video. Essa opção só está disponível para formato de imagem/vídeo individual.

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

Anúncios com mídia dinâmica (imagem única com mídia dinâmica)

Em object_story_spec, a format_option de single_image mostrará mídia dinâmica quando media_type_automation for selecionado.

A partir de setembro de 2025, os anúncios de catálogo Advantage+ que usarem format_option de single_image terão mídia dinâmica ativada por padrão e exibirão vídeos de produtos do catálogo disponíveis nos anúncios. É possível definir media_type_automation como OPT_out para desativar os vídeo de produtos do catálogo em anúncios.

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: ativar ou desativar o corte automático de vídeo

Use o campo video_crop_style para controlar o corte automático de vídeo. Os valores disponíveis são AUTO ou NONE.

Para desativar o corte automático de vídeo, defina video_crop_style como NONE ou remova as personalizações nas configurações 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

O corte automático se aplica apenas a vídeos que não atendem aos requisitos de tamanho do posicionamento. No momento, esse recurso serve principalmente para ajustar o vídeo à área visível do player.

Quando um vídeo corresponder à taxa de proporção do posicionamento do anúncio, ele será retornado. Se todas as taxas de proporção de um determinado vídeo de produto forem fornecidas, o corte automático não será aplicado. Caso contrário, o anúncio selecionará um vídeo do item e verificará a configuração de corte automático: AUTO retorna o vídeo cortado automaticamente e NONE mostra o vídeo original.

Insights de mídia dinâmica

As métricas de engajamento de vídeo do Gerenciador de Anúncios também podem ser consultadas na API. Use a tabela a seguir para ver uma comparação.

Exemplo de solicitação

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

Para saber mais, consulte a documentação API de Insights.