API de marketing

Contenido del anuncio

Usa los anuncios de Facebook con tus clientes actuales y llega a otros nuevos. En cada guía, se describen los productos publicitarios de Facebook, que te ayudarán a cumplir tus objetivos en este ámbito. Existen diversos tipos de anuncios con una variedad de opciones de apariencias, ubicaciones y contenidos. Para conocer las normas que se aplican a los anuncios en función de su contenido, consulta la Guía de anuncios de Facebook.

Contenido

El contenido del anuncio es un objeto que contiene todos los datos necesarios para representar visualmente el anuncio. La API incluye diferentes tipos de anuncios que se pueden crear en Facebook (se pueden consultar todos aquí).

Si tienes una campaña con el objetivo "Interacción con publicación de la página", ahora puedes crear un anuncio que promocione una publicación realizada en la página. Este anuncio se denomina “anuncio de publicación de la página”. Este tipo de anuncios requiere un campo denominado object_story_id, que es la propiedad id de la publicación de una página. Obtén más información sobre el contenido del anuncio en la documentación de referencia.

El contenido del anuncio se divide en tres partes:

  • El propio contenido del anuncio, que se define en función de los atributos visuales del objeto de contenido.
  • La ubicación en la que se publica el anuncio.
  • La vista previa del propio anuncio, por ubicación.

Para crear el objeto de contenido del anuncio, realiza la siguiente llamada:

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

La respuesta de la llamada a la API es el valor id del objeto de contenido. Guarda esta información, ya que la necesitarás para el objeto del anuncio:


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

Límites

Existen límites en relación con el texto, el tamaño de la imagen, la relación de aspecto de la imagen y otras características del contenido. Consulta la guía de anuncios.

Lectura

En la API de anuncios, los campos que deseas recuperar deben solicitarse de forma expresa, con excepción de id. La referencia de cada objeto contiene una sección referida a cómo leer el objeto e indica qué campos se pueden leer. En el caso del contenido, se especifican los mismos campos que al momento de crear el objeto, y se agrega 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

Ubicaciones

La ubicación es el lugar en el que tu anuncio se muestra en Facebook, como el feed de la computadora, el feed del celular o la columna derecha. Consulta la guía de productos publicitarios.

Te recomendamos publicar anuncios en todas las ubicaciones disponibles. La función de subasta de anuncios de Facebook está diseñada para generar impresiones de anuncios en la ubicación con mayores probabilidades de impulsar los resultados de la campaña con el menor costo posible.

La manera más sencilla de aprovechar esta optimización es no completar este campo. También puedes seleccionar ubicaciones específicas en el campo "target_spec" del conjunto de anuncios.

En este ejemplo, se muestra un anuncio de publicación de la página. Las ubicaciones disponibles son el feed del celular, el feed de la computadora y la columna derecha de Facebook. Consulta las opciones de ubicación en la API. Si eliges desktopfeed y rightcolumn como page_type, el anuncio se mostrará en el feed de la computadora y en la columna derecha. Los anuncios creados en este conjunto de anuncios solo se pueden mostrar en la computadora.

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

Vista previa del anuncio

Hay dos formas de obtener una vista previa del anuncio: con la API de vista previa del anuncio o el plugin de vista previa del anuncio.

Existen tres formas de generar una vista previa con la API:

  1. Mediante el identificador del anuncio
  2. Mediante el identificador del contenido del anuncio
  3. Mediante especificaciones de contenido

De acuerdo con la documentación de referencia de la API de vista previa, la llamada mínima requerida es la siguiente:


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

Las especificaciones de contenido son una matriz de cada campo y valor necesarios para crear el contenido del anuncio.

En este momento, nuestra llamada de contenido del anuncio tiene el siguiente aspecto:


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

Usa object_story_id en la llamada a la API de vista previa:


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

Los valores disponibles de ad_format difieren un poco de los de page_types. No obstante, en esta situación, se seleccionan el feed de la computadora y la columna derecha de Facebook. De esta manera, debes realizar dos llamadas de la API para generar las vistas previas correspondientes a cada ubicación:



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

La respuesta es un iFrame válido por 24 horas.

Ver más