Anuncios con llamada de la API de marketing de Meta

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

Información general sobre la creación de anuncios

Para crear y publicar un anuncio deberás hacer lo siguiente:

Crear una campaña publicitaria.
Crear un conjunto de anuncios que vincule los anuncios con la campaña publicitaria.
Crear el contenido del anuncio para el anuncio con llamada.
Crear un anuncio vinculando el contenido del anuncio con el conjunto de anuncios.
Publicar el anuncio en Facebook e Instagram.

Antes de empezar

En esta guía se presupone lo siguiente:

Tienes una cuenta publicitaria de Meta con un método de pago válido.
Has subido a los servidores de Meta todos los activos (como fotos o vídeos) que vas a utilizar en los anuncios.

Para realizar correctamente llamadas a todos los extremos de esta guía, necesitarás lo siguiente:

Un identificador de acceso a la página solicitado por una persona que pueda realizar la tarea ADVERTIZE en la página.
Se deben conceder los siguientes permisos a las personas que utilizan la aplicación:
- ads_management
- pages_manage_ads
- pages_read_engagement
- pages_show_list

Recomendaciones

Asegúrate de definir el horario comercial de tu empresa en la configuración de la página de Facebook.

Al probar una llamada a la API, puedes incluir el parámetro access_token establecido en el identificador de acceso. Sin embargo, al realizar llamadas seguras desde la aplicación, debes usar la clase de identificador de acceso.

Limitaciones

La audiencia objetivo debe ser mayor de 18 años.
El número de teléfono incluido en la llamada a la acción debe ser del mismo país que la audiencia objetivo.

Paso 1. Crear una campaña

Para crear una campaña publicitaria, envía una solicitud POST al extremo act_ad_account_id/campaigns, donde ad_account_id es el identificador de la cuenta publicitaria de Meta. La solicitud debe incluir lo siguiente:

name
objective establecido en uno de los siguientes objetivos admitidos:
- OUTCOME_AWARENESS
- OUTCOME_ENGAGEMENT
- OUTCOME_LEADS
- OUTCOME_SALES
- OUTCOME_TRAFFIC
special_ad_categories

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus 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"],
         }'

Si la operación se realiza correctamente, la aplicación recibe 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 extremo act_ad_account_id/adsets, donde ad_account_id es el identificador de la cuenta publicitaria de Meta. La solicitud debe incluir lo siguiente:

bid_amount
billing_event establecido en IMPRESSIONS
campaign_id
daily_budget
destination_type establecido en PHONE_CALL
name
optimization_goal establecido en QUALITY_CALL para los anuncios con llamada
targeting

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus 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"] 
           } 
         }'

Si la operación se realiza correctamente, la aplicación recibe 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 añadir activos a los anuncios. Se admiten los anuncios por secuencia, con imagen o vídeo, y de solo texto.

Para crear el contenido del anuncio, envía una solicitud POST al extremo /act_ad_account_id/adcreatives, donde ad_account_id es el identificador de la cuenta publicitaria de Meta. La solicitud debe incluir lo siguiente:

name
object_story_spec
object_story_spec con un objeto link_data que defina el elemento call_to_action con el valor de type establecido en CALL_NOW y value como el número de teléfono de tu empresa.

Ejemplo de solicitud de un anuncio con imagen

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como page_access_token, por tus 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" }
               }   
             }
           }
         }'

Si la operación se realiza correctamente, la aplicación recibe la siguiente respuesta JSON con el identificador del contenido del anuncio.

{
  "id": "ad_creative_id"
}

Paso 4. Crear el anuncio

Para crear el anuncio, tienes que asociar el contenido del anuncio y el conjunto de anuncios. Para crear el anuncio, envía una solicitud POST al extremo /act_ad_account_id/ads, donde ad_account_id es el identificador de la cuenta de Meta. La solicitud debe incluir lo siguiente:

adset_id (del paso 2)
creative_id (del paso 3)
name
status

Ejemplo de solicitud de un anuncio con contenido

Se ha aplicado formato para mejorar la legibilidad. Sustituye los valores en negrita y cursiva, como ad_account_id, por tus 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"
         }'

Si la operación se realiza correctamente, la aplicación recibe la siguiente respuesta JSON con el identificador del anuncio.

{
  "id": "ad_id"
}

Siguientes pasos

Consulta la guía de introducción para obtener información sobre cómo enviar el anuncio a revisión.

Más información

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

Servicio de ayuda para empresas

Consultar métricas relativas a los anuncios con llamada en el Administrador de anuncios