Anúncios em vídeo e em carrossel

Você pode criar, mensurar e otimizar facilmente anúncios de vídeo e em carrossel no Facebook por meio da API. Consulte Anúncios em carrossel no Facebook para Empresas. Para ver os formatos de vídeo compatíveis com anúncios, acesse Vídeos na Central de Ajuda para o Anunciante.

Anúncios em vídeo

Siga estas etapas para criar um anúncio em vídeo em um objetivo VIDEO_VIEWS e otimizar o alcance do lance:

• Etapa 1: fornecer criativos do anúncio
• Etapa 2: criar campanha de anúncios
• Etapa 3: criar um conjunto de anúncios
• Etapa 4: criar um anúncio

Etapa 1: fornecer criativos do anúncio

Crie um anúncio usando um ID de vídeo existente e um vídeo carregado no Facebook.

Você precisará do seguinte:

• As permissões pages_read_engagement e ads_management
• Um vídeo carregado para o ponto de extremidade act_{ad-account-id}/advideos

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Apresentação multimídia

Ao ampliar ou lançar campanhas de marca para smartphones comuns em mercados emergentes, ou ao criar um vídeo simples, experimente a apresentação multimídia de imagens. São necessárias pelo menos 3 imagens. Carregue imagens em um ativo de vídeo. Por exemplo:

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

Consulte Bring Video Ads to Life: Best Practices for Video Creative on Facebook e Referência: Ad Account Advideos.

Etapa 2: criar campanha de anúncios

Defina o objetivo como VIDEO_VIEWS:

curl -X POST \
  -F 'name="Video Views campaign"' \
  -F 'objective="OUTCOME_ENGAGEMENT"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns
  
Open In Graph API Explorer

Consulte Referência: Campaign, AdObjectives em PHP e AdObjectives em Python.

Etapa 3: criar um conjunto de anúncios

Se a meta for o menor custo por visualização possível, será necessário emparelhar o objetivo da campanha de visualização do vídeo com optimization_goal=THRUPLAY de um conjunto de anúncios. Você pode definir bidding_event como IMPRESSIONS ou THRUPLAY para pagar por impressão ou por visualização do vídeo. Consulte Anúncios com custo por ação.

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

As taxas de custo por visualização são menores para conjuntos de anúncios com optimization_goal=THRUPLAY se comparadas a CPVs de compras por alcance e frequência otimizadas para visualizações de vídeo. A data final deve estar no futuro. Consulte a Referência: Ad Set.

Etapa 4: criar um anúncio

Use o conjunto de anúncios e o criativo do anúncio existentes:

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
  "creative_id": "<CREATIVE_ID>"
  }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Quando um objetivo da campanha for VIDEO_VIEWS, por padrão, o anúncio obterá as especificações de rastreamento adequadas que definem as ações rastreadas de um anúncio. Por exemplo, visualizações do vídeo:

{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}
    

Consulte Minhas campanhas do Gerenciador de Anúncios e a referência Anúncio.

Exemplo de reconhecimento da marca

Consulte o blog de reconhecimento da marca para criar um anúncio em vídeo para essa finalidade.

Exemplo de alcance e frequência

Para disponibilizar um vídeo a mais pessoas, use o objetivo da campanha de visualização do vídeo com alcance e frequência. Você precisará criar uma previsão, reservá-la e atribuí-la ao seu conjunto de anúncios.

Siga a criação da visualização do vídeo, mas aplique alcance e frequência ao seu conjunto de anúncios. Especifique estes parâmetros adicionais:

-F "rf_prediction_id=<RESERVATION_ID>" \

Vídeo para resposta direta

Para incentivar as pessoas a mudar do reconhecimento à ação, consulte Criativo do vídeo no formato de carrossel.

• Alcance pessoas que assistiram a um vídeo. Do reconhecimento a afinidade e consideração. Consulte Remarketing.
• Tenha engajamento com marcas e produtos. Adicione uma chamada para ação para visitar uma página específica no seu site. Consulte Chamada para ação.

Remarketing

O remarketing de anúncios em vídeo oferece suporte para os anunciantes direcionarem para determinados públicos personalizados de vídeos orgânicos ou pagos no Facebook e Instagram. Use este recurso para mover pessoas do reconhecimento para os objetivos da parte mais inferior do funil, como afinidade e consideração. Consulte a pesquisa Combinações de criativos que funcionam.

Você precisa de permissão de anunciante para a página que contém um vídeo para criar um público para esse vídeo.

Para o público, defina subtype=ENGAGEMENT. Então, defina as regras para o público que você deseja criar. Cada regra tem um object_id, por exemplo, ID de vídeo e event_name. O event_name será uma das seguintes opções:

• video_watched – o número de vezes em que o vídeo foi visto por um agregado de no mínimo 3 segundos ou por quase toda sua duração (o que acontecer primeiro).
• video_completed – o número de vezes nas quais o vídeo foi visto até a marca que corresponde a 95% da duração, inclusive visualizações em que as pessoas pularam até esse ponto.
• video_view_10s – o número de vezes em que o vídeo foi visto por um agregado de no mínimo 10 segundos ou por quase toda sua duração (o que acontecer primeiro).
• video_view_15s – o número de vezes em que o vídeo foi visto por um agregado de no mínimo 15 segundos ou por quase toda sua duração (o que acontecer primeiro).
• video_view_25_percent – o número de vezes nas quais o vídeo foi visto até a marca que corresponde a 25% da duração, inclusive visualizações em que as pessoas pularam até esse ponto.
• video_view_50_percent – o número de vezes nas quais o vídeo foi visto até a marca que corresponde a 50% da duração, inclusive visualizações em que as pessoas pularam até esse ponto.
• video_view_75_percent – o número de vezes nas quais o vídeo foi visto até a marca que corresponde a 75% da duração, inclusive visualizações em que as pessoas pularam até esse ponto.

Você pode combinar vídeos para criar um público baseado em vários vídeos e ações. Por exemplo, um público pode conter visualizações de três segundos do vídeo A e visualizações completas do vídeo B e C.

Isso cria um público dos últimos 14 dias de espectadores que visualizaram o vídeo 1 por mais de 3 segundos, e os espectadores que visualizaram o vídeo 2 completamente. O público também será preenchido automaticamente com espectadores antes que ele seja criado com prefill=true.

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

A veiculação secundária é compatível com visualizações do vídeo depois de 16 de outubro de 2015.

Chamada para ação

Os vídeos com comandos interativos de chamada para ação (CTA) estimulam as pessoas a saber mais e a visitar uma página específica em um site. Melhore o desempenho quando seu objetivo principal for gerar visualizações do vídeo ou reconhecimento da marca e seu objetivo secundário for gerar cliques fora do site. Você deve usar um anúncio de link de vídeo para o último. Como as CTAs funcionam:

• Para dispositivos móveis e desktop, é mostrada como parte da publicação. Quando o vídeo é pausado, é exibida ao lado da opção Retomar.
• Para dispositivos móveis, quando alguém clica em um vídeo para assistir em tela cheia, uma CTA flutuante aparece como uma imagem sobreposta do vídeo.
• As publicações de link de vídeo externo não exibem CTAs.

Você pode usar o vídeo com CTAs apenas com os seguintes objetivos de campanha:

• PAGE_LIKES
• LEAD_GENERATION
• LOCAL_AWARENESS
• LINK_CLICKS
• CONVERSIONS
• APP_INSTALLS
• VIDEO_VIEWS
• BRAND_AWARENESS
• Ad for Mobile App

Consulte Expansão de vídeo para objetivos adicionais. Isso cria um anúncio em vídeo com a chamada para ação GET_DIRECTIONS:

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Métricas de vídeo

Insights de publicação de vídeo, Orgânico

Saiba mais sobre o desempenho dos seus vídeos no Facebook e tome decisões mais informadas sobre o conteúdo de vídeo. Atualmente, oferecemos métricas apenas quando alguém começa a assistir aos vídeos. Essas métricas incluem visualizações do vídeo, visualizações do vídeo únicas, a duração média da visualização do vídeo e a retenção do público. Veja em quais partes as pessoas desistem do vídeo e as partes que as pessoas acham mais interessantes.

Insights do anúncio em vídeo, Pago

Use a API de Insights sobre Anúncios. A resposta contém diversas métricas de vídeo.

Tipo de vídeo

Recupere as estatísticas do anúncio em vídeo agrupadas por tipo de vídeo, como reprodução automática e clique para reproduzir. Inclua action_video_type em action_breakdowns. Os valores esperados para action_video_type são total, click_to_play e auto_play.

Estamos fazendo testes limitados com a opção action_video_type no momento. Para identificar clientes com o detalhamento, verifique CAN_USE_VIDEO_METRICS_BREAKDOWN da conta de anúncios.

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

A resposta inclui objetos com action_type como video_view e contém um action_video_type importante:

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

Consulte API de Insights.

Anúncios em carrossel

Obtenha mais espaço para o criativo no Feed e leve as pessoas para seu site ou app para celular a fim de converter. Crie um anúncio em carrossel de duas formas:

• Criar um anúncio e uma publicação sem exibição na Página em uma chamada – API do Criativo do Anúncio
• Criar uma publicação sem exibição na Página e um criativo do anúncio por meio da publicação (indisponível para carrossel de vídeo)

Os anúncios em carrossel não são compatíveis com o Facebook Stories.

Criar em linha

Crie uma publicação da Página de anúncio em carrossel enquanto elabora um criativo do anúncio. Especifique o conteúdo da publicação da Página em object_story_spec. Isso criará uma publicação sem exibição na Página a partir de adcreatives. Consulte os criativos do anúncio. Por exemplo:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

A resposta é um ID do criativo:

{"id":"<CREATIVE_ID>"}

Criar a publicação e depois o anúncio

Crie uma publicação sem exibição na Página. child_attachments é uma matriz de objetos de link. Em cada objeto de link, picture, name e description são opcionais. Você pode publicá-los apenas pela Página com um token de acesso à Página.

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

Em seguida, forneça um criativo do anúncio com a publicação sem exibição na Página. Use id para object_story_id no seu criativo do anúncio.

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Criar anúncio em carrossel com vídeos

Os anúncios em carrossel com vídeos podem ter "legenda" no anexo secundário para personalizar a URL de exibição no final da tela:

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

Para ver detalhes sobre os anexos secundários, use o ID e faça uma chamada à Graph API, Vídeo, Referência.

Criar anúncio de app para celular

Limitações:

• Os anúncios de app para celular em carrossel oferecem suporte a apenas um app
• Um mínimo de três imagens, em comparação com as duas imagens nos anúncios em carrossel que não são de app
• Os anúncios de app para celular em carrossel devem ter uma chamada para ação
• O cartão final que normalmente exibe a foto do perfil da Página não será exibido para anúncios de app para celular em carrossel. É necessário especificar o mesmo link da loja de apps em cada child_attachment. Você não precisa especificar o link novamente em call_to_action:{'value':{'link':... }}}.

Por exemplo, se quiser criar um anúncio em carrossel para instalação do app para celular:

\

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Você pode publicar apenas sua publicação como a Página do Facebook associada ao app para celular. Você precisa usar um token de acesso à Página.

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/feed

Use o id da resposta para criar AdCreative:

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Especificação de campo

Este é um anúncio em carrossel no iOS, mostrando como os campos descritos são usados.

Estatísticas do anúncio por produto

Reúna ações para anúncios em carrossel por produto com actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']. Cada child_attachment tem um ID de cartão diferente. action_carousel_card_id e action_carousel_card_name só se aplicam a anúncios em carrossel.

Obtenha as seguintes estatísticas por cartão:

• website_ctr – disponível ao especificar fields=['website_ctr'].
• app_install, app_use, apps.uses, credit_spent, mobile_app_install, tab_view, link_click, mobile_app_install, app_custom_event.* e offsite_conversion.* – disponíveis ao especificar fields=['actions']. Outras ações não estão disponíveis com um detalhamento do cartão.

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Resposta:

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

Também é possível solicitar cost_per_action_type para obter o detalhamento dos custos por tipo de ação:

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Exemplo de resposta:

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}

Posicionamentos

Se você selecionar somente right_hand_column como o posicionamento, poderá usar apenas um formato de carrossel ou de vídeo único no grupo de anúncios. Não há compatibilidade com o formato de vídeo se apenas um posicionamento right_hand_column for selecionado. Consulte Direcionamento e posicionamento avançados.

Por exemplo, crie um conjunto de anúncios em que right_hand_column é o único posicionamento:

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

Forneça um criativo de anúncio com vídeo:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Ou forneça um formato de anúncio do Canvas para o criativo do anúncio:

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Se você tentar criar um anúncio com o conjunto de anúncios e o criativo do anúncio:

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Caso você receba um código de erro, forneça um criativo compatível ou altere o direcionamento.

Veja também

• Guias: Publicação
• Carousel for Mobile App Ads
• Feed de Página
• Unpublished Page Posts
• Ad Creatives
• Anúncios do Instagram