API de marketing

Contenido dinámico

El contenido dinámico te permite entregar automáticamente diferentes combinaciones del contenido de un anuncio a los usuarios. Te ayuda a encontrar la mejor combinación de contenido por impresión y aprende del rendimiento del activo en diferentes audiencias.

Esta solución también mejora tu capacidad para explorar una serie de combinaciones de piezas de contenido y audiencias a fin de mostrar las mejores imágenes, títulos, descripciones y otros activos a los usuarios.

Debes utilizar el contenido dinámico para:

  • Automatizar el proceso que se utiliza para probar el contenido
  • Utilizar diferentes audiencias para aprender a elegir la combinación más eficaz de piezas de contenido

Utiliza esta API para las campañas nuevas y continuas, así como para las campañas que duren más de cinco días. Debes realizar pruebas A/B con las campañas existentes para encontrar el enfoque que mejor se ajuste a tus necesidades.

Introducción

Paso 1: Crear una campaña publicitaria y un conjunto de anuncios

Puedes crear una campaña publicitaria estándar para el contenido dinámico, aunque hay dos limitaciones:

  • El valor de objective debe ser uno de los siguientes: OUTCOME_SALES, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_AWARENESS, OUTCOME_TRAFFIC o OUTCOME_APP_PROMOTION.
  • buying_type debe ser el valor predeterminado, que es AUCTION, o quedar en blanco.

Por ejemplo, para crear una campaña publicitaria con el valor de objectiveCONVERSIONS:

curl \
  -F 'name=Dynamic Creative Sample Campaign'
  -F 'objective=OUTCOME_SALES'
  -F 'status=PAUSED'
  -F 'special_ad_categories=<SPECIAL_AD_CATEGORY>'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

Cuando tengas la campaña, crea un conjunto de anuncios con el extremo de conjuntos de anuncios estándar.

  • Puedes utilizar todos los valores de billing_event, targeting y promoted_object siempre y cuando sean compatibles con el valor de objective de la campaña publicitaria principal.
  • Debes establecer el valor de optimization_goal en OFFSITE_CONVERSIONS para los objetivos OUTCOME_SALES, OUTCOME_ENGAGEMENT, OUTCOME_LEADS y OUTCOME_TRAFFIC.
  • A continuación, establece is_dynamic_creative en true.

Para crear un conjunto de anuncios en una campaña con el valor de optimization_goal establecido en conversions:

curl \
  -F 'status=PAUSED'
  -F 'name=Dynamic Creative Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=true'
  -F 'lifetime_budget=5000'
  -F 'promoted_object={"pixel_id": "<PIXEL_ID>", "custom_event_type": "PURCHASE"}'
  -F 'billing_event=IMPRESSIONS'
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP'
  -F 'targeting={"geo_locations": {"countries": ["US"]}}'
  -F 'start_time=2024-04-09'
  -F 'end_time=2024-04-20'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

Esto devuelve un nuevo identificador de conjunto de anuncios:

{"id":"23842500259260001"}

Si utilizas asset_feed_spec con un conjunto de anuncios optimizado para APP_INSTALLS, debes especificar un valor de link_url, como http://www.abc.com. El valor de link_urldebe coincidir con el de object_store_url en promoted_object. Solo debes proporcionar un parámetro link_url en asset_feed_spec.

curl 
-F "name=Dynamic Creative AdSet"
-F "campaign_id=CAMPAIGN_ID"
-F "optimization_goal=APP_INSTALLS"
-F 'is_dynamic_creative=true'
-F "billing_event=IMPRESSIONS"
-F "is_autobid=true"
-F "promoted_object={'object_store_url':'https://itunes.apple.com/us/app/facebook/id284882215','application_id':ADVERTISED_APP_ID}"  // object_store_url must match what is provided in asset feed's link_urls 
-F "lifetime_budget=20000"
-F "end_time=1461974400"
-F "targeting={
     'geo_locations':{'countries':['US']},
     'age_min':18,
     'age_max':24,
     'publisher_platforms':['facebook', 'audience_network'],
     'user_os':['ios']
   }"
-F "access_token=ACCESS_TOKEN" 
https://graph.facebook.com/<API_VERSION>/act_AD_ACCOUNT_ID/adsets

Paso 2: Proporcionar el contenido del anuncio con asset_feed_spec

Proporciona el contenido mediante el campo asset_feed_spec, también conocido como “lista de activos”. En este campo, puedes especificar múltiples piezas de contenido para cada tipo de pieza. Algunos ejemplos de tipos de piezas de contenido son las imágenes, los videos, los encabezados y las descripciones de enlaces. Consulta lo siguiente:

Ten en cuenta que también puede ser necesario establecer page_id e instagram_actor_id.

asset_feed_id solo se admite en la versión 3.1 y anteriores de la API de marketing. Debes utilizar asset_feed_spec en su lugar.

Recorte de imágenes

El contenido dinámico admite el recorte de imágenes. Especifica el parámetro de recorte de imágenes en la especificación de imágenes. Solo puedes proporcionar un recorte por imagen. Aplicamos los recortes a todas las ubicaciones de la imagen. Consulta API de marketing, Recorte de imágenes.

En este punto, el conjunto de anuncios debe estar vacío. Al crear el anuncio, proporciona una referencia al identificador del contenido. Solo puedes crear un anuncio por conjunto de anuncios. Sin embargo, puedes crear más anuncios de contenido dinámico en otros conjuntos de anuncios nuevos.

curl 
  -F 'name=Dynamic Creative Ad' 
  -F 'adset_id=<ADSET_ID>' 
  -F 'access_token=<ACCESS_TOKEN>' 
  -F 'creative={
      "creative_id": <CREATIVE_ID>,
   }' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

Después de crear el anuncio:

Una vez que crees un anuncio para el contenido dinámico, no puedes eliminarlo ni archivarlo. En lugar de eso, debes eliminar o archivar el conjunto de anuncios principal.

El contenido dinámico admite todas las ubicaciones excepto sponsored_messages en Messenger.

Anuncios por secuencia

El contenido dinámico entrega la mejor combinación de activos en formato de anuncio por secuencia. Si la lista tiene menos de diez imágenes, el número de elementos de secuencia es el mismo que el número de imágenes. Si utilizas más de diez imágenes, mostramos una secuencia con diez elementos. Recomendamos utilizar imágenes cuadradas.

Si usas una secuencia con contenido dinámico, no puedes utilizar estas funciones de los anuncios por secuencia:

  • BODY_LABEL
  • CALL_TO_ACTION_TYPE_LABEL
  • LINK_URL_LABEL
  • CAPTION_LABEL
  • AD_FORMAT_LABEL

En el desglose de insights de activos, agregamos las métricas basadas en impresiones de los activos en todos los elementos a los activos del primer elemento. Los activos en el elemento incluyen las imágenes, el título y la descripción.

Para obtener información general, consulta Anuncios por secuencia.

Paso 4 opcional: Comprobar el estado de la revisión

Después de crear la campaña, el conjunto de anuncios y el anuncio, comprueba el estado de la revisión del anuncio:

curl -G 
-d "access_token=<ACCESS_TOKEN>" 
-d 'fields=review_feedback' 
https://graph.facebook.com/<API_VERSION>/<ADSET_ID>

En el resultado se incluyen los comentarios de la revisión del anuncio. Una matriz vacía significa que el anuncio ha superado la revisión:

{
  "review_feedback":"[]",
  "id":"<ADSET_ID>"
}

Si el anuncio no supera la revisión, ves lo siguiente:

{
  "review_feedback": {
    {"id":23842500258220001,"text":"Body 1","reason":["ALCOHOL"]},
    {"id":23842500258160001,"text":"Title 1","reason":["ALCOHOL"]},
    {"id":23842500258170001,"text":"Title 2","reason":["ALCOHOL"]}
  }",
  "id": "<AD_ID>"  
}