API de marketing

Anuncios con llamada

En esta guía, se explica cómo crear y publicar anuncios con llamada mediante la API de marketing de Meta.

Antes de empezar

En esta guía, se da por sentado que tienes lo siguiente:

Para realizar llamadas correctas a los puntos de conexión que se mencionan en esta guía, necesitarás lo siguiente:

  • Un token de acceso a la página solicitado por una persona que pueda realizar la tarea ADVERTIZE en la página.
  • Una persona que usa tu app debe otorgar los siguientes permisos:
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

Recomendaciones

Asegúrate de configurar el horario comercial del negocio en la Configuración de la página de Facebook.

Al probar una llamada a la API, puedes incluir el parámetro access_token configurado en tu token de acceso. Sin embargo, para hacer llamadas seguras desde tu app, usa la clase de token de acceso.

Limitaciones

  • El público objetivo debe tener 18 años o más
  • El número de teléfono incluido en la llamada a la acción debe ser del mismo país que el público objetivo

Paso 1: Crear una campaña

Para crear una campaña publicitaria, envía una solicitud POST al punto de conexión act_ad_account_id/campaigns, donde ad_account_id es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:

  • name
  • objective: configurado en alguno de los siguientes objetivos admitidos:
    • OUTCOME_AWARENESS
    • OUTCOME_ENGAGEMENT
    • OUTCOME_LEADS
    • OUTCOME_SALES
    • OUTCOME_TRAFFIC
  • special_ad_categories

Ejemplo de solicitud

El formato se modificó para facilitar la lectura. Reemplaza los valores en negrita y en cursiva, como ad_account_id, por tus propios valores.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "name":"Call_ad_campaign_name",
           "objective":"OUTCOME_TRAFFIC",
           "special_ad_categories":["NONE"],
         }'

Si la operación se procesa correctamente, la app recibirá una respuesta JSON con el identificador de la campaña.

{
  "id": "campaign_id"
}

Paso 2: Crear un conjunto de anuncios

Para crear un conjunto de anuncios, envía una solicitud POST al punto de conexión act_ad_account_id/adsets, donde ad_account_id es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:

  • bid_amount
  • billing_event configurado como IMPRESSIONS
  • campaign_id
  • daily_budget
  • destination_type configurado en PHONE_CALL
  • name
  • optimization_goal configurado en QUALITY_CALL en relación con los anuncios con el destino "Llamada telefónica"
  • targeting

Ejemplo de solicitud

El formato se modificó para facilitar la lectura. Reemplaza los valores en negrita y en cursiva, como ad_account_id, por tus propios valores.
curl -X POST "https://graph.facebook.com/v21.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"] 
           } 
         }'

Si se envía correctamente, tu app recibirá la siguiente respuesta JSON con el identificador del conjunto de anuncios.

{
  "id": "adset_id"
}

Paso 3: Crear el contenido del anuncio

El contenido del anuncio te permite agregar activos a los anuncios. Se admiten anuncios por secuencia, con imágenes, de solo texto y video.

Para crear el contenido de un anuncio, envía una solicitud POST al punto de conexión /act_ad_account_id/adcreatives, donde ad_account_id es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:

  • name
  • object_story_spec
  • object_story_spec con un objeto link_data que define la call_to_action, con el type configurado en CALL_NOW, y value como el teléfono de tu negocio

Ejemplo de solicitud de anuncio con imagen

El formato se modificó para facilitar la lectura. Reemplaza los valores en negrita y en cursiva, como page_access_token, con tus propios valores.
curl -X POST "https://graph.facebook.com/v21.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" }
               }   
             }
           }
         }'

Si la operación se procesa correctamente, tu app recibirá la siguiente respuesta JSON con el identificador del contenido del anuncio.

{
  "id": "ad_creative_id"
}

Paso 4: Crear el anuncio

Para crear el anuncio, debes asociar su contenido y el conjunto de anuncios. Para crear el anuncio, envía una solicitud POST al punto de conexión /act_ad_account_id/ads, donde ad_account_id es el identificador de tu cuenta publicitaria de Meta. En la solicitud, debes incluir los siguientes parámetros:

Ejemplo de solicitud de anuncio con contenido

El formato se modificó para facilitar la lectura. Reemplaza los valores en negrita y en cursiva, como ad_account_id, por tus propios valores.
curl -X POST "https://graph.facebook.com/v21.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"
         }'

Si la operación se procesa correctamente, tu app recibirá la siguiente respuesta JSON con el identificador del anuncio.

{
  "id": "ad_id"
}

Próximos pasos

Consulta la guía de primeros pasos para recibir información sobre cómo enviar tu anuncio para su revisión.

Más información

Obtén más información sobre la API de marketing y las opciones adicionales disponibles para los anuncios con llamadas.

Business Help Center

API de marketing