API de Marketing

Criativo do anúncio

Use os anúncios do Facebook com seus clientes existentes e também para alcançar novos clientes. Cada guia descreve produtos de anúncios do Facebook para ajudar a atingir suas metas de publicidade. Há vários tipos de unidades de anúncio com diversas opções de aparência, posicionamento e criativo. Confira as diretrizes sobre unidades de anúncio como conteúdo do criativo no Guia de anúncios do Facebook.

Criativo

Um criativo do anúncio é um objeto que contém todos os dados necessários para renderizar visualmente o próprio anúncio. A API inclui diferentes tipos de anúncios que podem ser criados no Facebook. Eles estão listados aqui.

Caso você tenha uma campanha com o objetivo de engajamento com a publicação da Página, agora será possível criar um anúncio que promove uma publicação feita pela Página. Consideramos isso um anúncio de publicação da Página. Os anúncios de publicação da Página exigem um campo object_story_id, que é a propriedade id de uma publicação desse tipo. Saiba mais na referência Criativo do anúncio.

Um criativo do anúncio tem três partes:

  • O criativo em si definido pelos atributos visuais do objeto correspondente
  • O posicionamento no qual o anúncio é veiculado
  • A prévia da unidade conforme o posicionamento

Para criar o objeto do criativo do anúncio, faça a seguinte chamada:

curl -X POST \
  -F 'name="Sample Promoted 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

A resposta à chamada de API é o id do objeto do criativo. Guarde isso, você precisará dele para o objeto do anúncio:


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

Limites

Existem limites sobre texto, tamanho da imagem, taxa de proporção da imagem e outros aspectos do criativo. Consulte o Guia de anúncios.

Ler

Na API de Anúncios, é necessário solicitar de forma explícita todos os campos que você quer recuperar, exceto id. A referência de cada objeto tem uma seção sobre a leitura e informa quais campos são legíveis. Para o criativo, são os mesmos campos especificados durante a criação do objeto, além de id.


curl -G \
  -d 'fields=name,object_story_id' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<CREATIVE_ID>Open In Graph API Explorer

Posicionamentos

Um posicionamento é o local onde o anúncio aparece no Facebook, como o Feed no desktop, Feed em dispositivos móveis ou a coluna da direita. Consulte o Guia de anúncios do Facebook.

Recomendamos que você execute anúncios em todos os posicionamentos disponíveis. O leilão de anúncios do Facebook foi desenvolvido para veicular impressões de anúncios no posicionamento que tem mais chances de gerar resultados de campanhas com o menor custo possível.

A maneira mais fácil de obter vantagens dessa otimização é deixar esse campo em branco. Você também pode selecionar posicionamentos específicos em uma target_spec do conjunto de anúncios.

Este exemplo tem um anúncio de publicação da Página. Os posicionamentos disponíveis são Feed do celular, Feed do desktop e coluna da direita do Facebook. Na API, consulte as opções de posicionamento. Se você escolher desktopfeed e rightcolumn como page_type, o anúncio será veiculado nos posicionamentos da coluna da direita e do Feed do desktop. Qualquer anúncio criado abaixo deste conjunto de anúncios tem apenas o posicionamento em desktop.

curl -X POST \
  -F 'name=Desktop Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=10000' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook","audience_network"] 
  }' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=1000' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  

Open In Graph API Explorer

Ver prévia de um anúncio

Você pode fazer a prévia de um anúncio de duas formas: com a API de Prévia do Anúncio ou com o plugin de prévia do anúncio.

Há três formas de gerar uma prévia com a API:

  1. Pela identificação do anúncio
  2. Pela identificação do criativo do anúncio
  3. Informando as especificações do criativo

De acordo com os documentos de referência da API de Prévia, a chamada mínima obrigatória será a seguinte:


curl -G \
  --data-urlencode 'creative="<CREATIVE_SPEC>"' \
  -d 'ad_format="<AD_FORMAT>"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

A especificação do criativo é uma matriz de cada campo e valor necessário para elaborar o criativo do anúncio.

No momento, nossa chamada de criativo do anúncio tem a seguinte aparência:


curl -X POST \
  -F 'name="Sample Promoted 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

Use object_story_id na chamada da API de Prévia:


curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=<AD_FORMAT>' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews


Open In Graph API Explorer

Os valores disponíveis para ad_format diferem um pouco de page_types. Mas, neste cenário, o Feed do desktop e a coluna da direita do Facebook são selecionados. Isso exige que você realize duas chamadas da API para gerar as prévias para cada posicionamento:



curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=RIGHT_COLUMN_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews

Open In Graph API Explorer

A resposta será um iFrame válido por 24 horas.

Ver mais