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 con los que puedes alcanzar tus objetivos relativos a la publicidad. Existen diversos tipos de anuncios, con diferentes opciones de formato, ubicación y contenido. Para conocer las normas relativas a los componentes de los anuncios, como el contenido publicitario, consulta la Guía de anuncios de Facebook.

Contenido

El contenido del anuncio es un objeto que contiene toda la información necesaria para representar visualmente el anuncio. En la API, existen diferentes tipos de anuncios que se pueden crear en Facebook. Puedes encontrar una lista de ellos aquí.

Si tienes una campaña con el objetivo de interacción con una publicación de la página, ahora puedes crear un anuncio en el que se promocione una publicación de la página. Estos anuncios se denominan anuncios sobre la publicación de la página, Los anuncios sobre la publicación de la página requieren un campo llamado object_story_id, que es la propiedad id de una publicación de la página. Obtén más información al respecto en la documentación Contenido del anuncio, Referencia.

El contenido de un anuncio consta de tres partes:

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

Para crear el objeto del contenido del anuncio, debes realizar 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 a la llamada a la API es el campo id del objeto de contenido, que debes conservar porque lo necesitarás para el objeto publicitario:


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 limitaciones relativas al texto, el tamaño y la relación de aspecto de la imagen, así como otros aspectos del contenido. Consulta la guía de anuncios.

Lectura

En la API de anuncios, cada campo que quieras recuperar debe solicitarse expresamente, a excepción de id. En la documentación de referencia de cada objeto se incluye una sección sobre cómo leer el objeto y se indican los campos que se pueden leer. Los campos correspondientes al contenido son los mismos que se especificaron al crear el objeto y el 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

Una ubicación es el lugar en el que tu anuncio se muestra en Facebook, como la sección de noticias del ordenador o del móvil, o la columna derecha. Consulta la Guía de anuncios.

Es recomendable mostrar anuncios en toda la variedad de ubicaciones disponibles. La subasta de anuncios de Facebook se ha diseñado para entregar impresiones de anuncio a la ubicación con mayor probabilidad de generar resultados de campaña al menor coste posible.

La forma más sencilla de aprovechar esta optimización es dejar este campo en blanco. También puedes seleccionar ubicaciones concretas en el campo target_spec del conjunto de anuncios.

En este ejemplo se muestra un anuncio sobre la publicación de la página. Las ubicaciones disponibles son la sección de noticias del móvil y del ordenador, y la columna derecha de Facebook. En la API, consulta Opciones de ubicación. Si estableces los valores del parámetro page_type como desktopfeed y rightcolumn, el anuncio se publicará en la sección de noticias del ordenador y en la columna derecha. Los anuncios que crees en este conjunto de anuncios solo se mostrarán en ordenadores.

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

Obtener la vista previa de un anuncio

Puedes obtener la vista previa de un anuncio de dos formas: con la API de vista previa de anuncios o mediante el plugin de vista previa de anuncios.

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

  1. Con el identificador de anuncio
  2. Mediante el identificador de contenido del anuncio
  3. Si se proporcionan 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 estos momentos, nuestra llamada al contenido del anuncio tiene el aspecto siguiente:


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 el campo 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 para el campo ad_format difieren ligeramente de los disponibles para el campo page_types. En este caso, se ha seleccionado la sección de noticias del ordenador y la columna derecha de Facebook, por lo que es necesario realizar dos llamadas a la API para generar las vistas previas de 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 durante 24 horas.

Más información