API de Marketing

Anúncios com ligação telefônica da API de Marketing da Meta

Este guia explica como criar e publicar anúncios com ligação telefônica usando a API de Marketing da Meta.

Visão geral da criação de anúncio

Para criar e publicar um anúncio:

  1. Crie uma campanha de anúncios
  2. Crie um conjunto de anúncios vinculando os anúncios à campanha.
  3. Forneça um criativo para o anúncio com ligação telefônica.
  4. Crie um anúncio vinculando o criativo ao conjunto de anúncios.
  5. Publique o anúncio no Facebook e no Instagram.

Antes de começar

Este guia considera que você já tem o seguinte:

Para fazer chamadas aos pontos de extremidade deste guia, você precisará do seguinte:

  • Um token de acesso à Página solicitado por uma pessoa que pode executar a tarefa ADVERTIZE na Página.
  • Estas permissões devem ser concedidas a uma pessoa que usa o seu app:
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

Recomendações

Defina o horário de funcionamento da sua empresa nas configurações da Página do Facebook. .

Ao testar uma chamada de API, você pode incluir o parâmetro access_token definido como seu token de acesso. No entanto, quando fizer chamadas seguras do seu app, use as classes de token de acesso.

Limitações

  • O público-alvo precisa ter 18 anos ou mais.
  • O número de telefone incluído na chamada para ação deve ser do mesmo país do público-alvo.

Etapa 1: criar uma campanha

Para criar uma campanha de anúncios, envie uma solicitação POST ao ponto de extremidade act_ad_account_id/campaigns, sendo ad_account_id a identificação da conta de anúncios da Meta. A solicitação precisa incluir:

  • name
  • objective – definido como um dos objetivos compatíveis a seguir:
    • OUTCOME_AWARENESS
    • OUTCOME_ENGAGEMENT
    • OUTCOME_LEADS
    • OUTCOME_SALES
    • OUTCOME_TRAFFIC
  • special_ad_categories

Exemplo de solicitação

Texto formatado para facilitar a leitura. Substitua os valores em negrito e itálico (como ad_account_id) pelos seus valores.
curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "name":"Call_ad_campaign_name",
           "objective":"OUTCOME_TRAFFIC",
           "special_ad_categories":["NONE"],
         }'

Caso ela seja bem-sucedida, o app receberá uma resposta JSON com a identificação da campanha.

{
  "id": "campaign_id"
}

Etapa 2: criar um conjunto de anúncios

Para criar um conjunto de anúncios, envie uma solicitação POST ao ponto de extremidade act_ad_account_id/adsets, sendo ad_account_id a identificação da conta de anúncios da Meta. A solicitação precisa incluir:

  • bid_amount
  • billing_event definido como IMPRESSIONS
  • campaign_id
  • daily_budget
  • destination_type definido como PHONE_CALL
  • name
  • optimization_goal definido como QUALITY_CALL para anúncios com ligação telefônica
  • targeting

Exemplo de solicitação

Texto formatado para facilitar a leitura. Substitua os valores em negrito e itálico (como ad_account_id) pelos seus valores.
curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "destination_type":"PHONE_CALL",
           "name:"Your_call_adset_name",
           "optimization_goal":"QUALITY_CALL",
           "targeting":{ 
             "geo_locations": { "countries":["US","CA"] },
             "device_platforms": ["mobile"],
             "publisher_platforms": ["facebook"] 
           } 
         }'

Caso ela seja bem-sucedida, o app receberá a resposta JSON a seguir com a identificação do conjunto de anúncios.

{
  "id": "adset_id"
}

Etapa 3: fornecer um criativo do anúncio

Com o criativo, é possível adicionar ativos aos seus anúncios. Há compatibilidade com anúncios do tipo carrossel, imagem, somente texto e vídeo.

Para fornecer um criativo de anúncio, envie uma solicitação POST ao ponto de extremidade /act_ad_account_id/adcreatives, sendo ad_account_id a identificação da conta de anúncios da Meta. A solicitação precisa incluir:

  • name
  • object_story_spec
  • object_story_spec com um objeto link_data que define a call_to_action com o type configurado como CALL_NOW e o value como o número de telefone da sua empresa

Exemplo de solicitação de anúncio com imagem

Texto formatado para facilitar a leitura. Substitua os valores em negrito e itálico (como page_access_token) pelos seus valores.
curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "name":"Your_call_image_ad_name",
           "object_story_spec":{
             "page_id": "your_page_id",
             "link_data": {
               "picture": "Your_image_URL", 
               "link": "Your_business_page_URL", 
               "call_to_action": {
                 "type":"CALL_NOW",
                 "value":{ "link":"tel:+Your_business_phone_number_with_country_code" }
               }   
             }
           }
         }'

Caso ela seja bem-sucedida, o app receberá a resposta JSON a seguir com o ID do criativo do anúncio.

{
  "id": "ad_creative_id"
}

Etapa 4. criar o anúncio

Para criar o anúncio, você precisa associar o criativo ao conjunto de anúncios. Envie uma solicitação POST ao ponto de extremidade /act_ad_account_id/ads, sendo ad_account_id a identificação da conta de anúncio da Meta. A solicitação precisa incluir:

Exemplo de solicitação de anúncio com criativo

Texto formatado para facilitar a leitura. Substitua os valores em negrito e itálico (como ad_account_id) pelos seus valores.
curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{

           "adset_id": "Your_ad_set_id",
           "creative": { "creative_id": "Your_ad_creative_id" },
           "status": "PAUSED"
         }'

Caso ela seja bem-sucedida, o app receberá a resposta JSON a seguir com a identificação do anúncio.

{
  "id": "ad_id"
}

Próximas etapas

Acesse o guia Primeiros passos para saber como enviar o anúncio para análise.

Saiba mais

Saiba mais sobre a API de Marketing e conheça as opções adicionais para anúncios com ligação telefônica.

Central de Ajuda para Empresas

API de Marketing