API de marketing

Contenido dinámico

El contenido dinámico te permite entregar automáticamente distintas combinaciones de contenido de un anuncio a tus usuarios. Ayuda a encontrar la mejor combinación de contenido por impresión y aprende a partir del rendimiento del activo en distintos públicos.

A su vez, esta solución mejora tu capacidad para explorar un amplio abanico de públicos y combinaciones de activos de contenido a fin de que puedas mostrar las mejores imágenes, títulos y descripciones, entre otro activos, a tus usuarios.

Recomendamos usar el contenido dinámico para realizar lo siguiente:

  • Automatizar el flujo de trabajo usado para probar contenido.
  • Usar distintos públicos para obtener más información sobre cómo elegir la combinación de activos de contenido más eficaz.

Usa esta API en las campañas nuevas y en curso, así como en aquellas campañas que tengan una duración superior a cinco días. Debes realizar pruebas A/B con tus campañas preexistentes a fin de encontrar el abordaje óptimo según tus necesidades.

Empezar

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

Puedes crear una campaña de anuncios estándar para el contenido dinámico, pero existen dos limitaciones:

  • Tu objective debe ser alguno de los siguientes: OUTCOME_SALES, OUTCOME_ENGAGEMENT, OUTCOME_LEADS, OUTCOME_AWARENESS, OUTCOME_TRAFFIC o OUTCOME_APP_PROMOTION.
  • AUCTION debe estar configurado de forma predeterminada en buying_type, o bien dejarse en blanco.

Por ejemplo, para crear una campaña publicitaria con el objective de CONVERSIONS, haz lo siguiente:

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

Una vez que tengas la campaña, crea un conjunto de anuncios mediante el punto de conexión del conjunto de anuncios estándar.

  • Puedes usar todos los billing_event, targeting y promoted_object, en tanto sean compatibles con el objective de la campaña publicitaria principal.
  • Debes configurar el optimization_goal en OFFSITE_CONVERSIONS de los objetivos OUTCOME_SALES, OUTCOME_ENGAGEMENT, OUTCOME_LEADS y OUTCOME_TRAFFIC.
  • Luego, configura is_dynamic_creative en true.

Para crear un conjunto de anuncios en una campaña con el optimization_goal configurado 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

Esta acción devolverá un nuevo identificador del conjunto de anuncios:

{"id":"23842500259260001"}

Si usas asset_feed_spec con un conjunto de anuncios optimizado para APP_INSTALLS, debes especificar el link_url (por ejemplo, http://www.abc.com). El link_urldebe ser igual aobject_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 mediante asset_feed_spec

Proporciona el contenido mediante el campo asset_feed_spec, también conocido como lista de archivos. En este campo, puedes especificar varios activos de contenido para cada tipo de activo. Algunos ejemplos de tipos de activos son las imágenes, los videos, los títulos y las descripciones de enlace. Consulta los siguientes enlaces:

Ten en cuenta que es posible que, además, debas configurar page_id y instagram_actor_id.

asset_feed_id solo es compatible en la versión 3.1 o anteriores de la API de marketing. Como alternativa, debes usar asset_feed_spec.

Recorte de imágenes

El contenido dinámico admite el recorte de imágenes. Especifica los parámetros de recorte de imágenes en las especificaciones de la imagen. Puedes proporcionar solo un recorte por imagen. Aplicamos los recortes a todas las ubicaciones de tu imagen. Consulta API de marketing, función de recorte de imágenes.

En este momento, tu conjunto de anuncios debe estar vacío. Cuando crees el anuncio, proporciona una referencia al identificador del contenido. Solo puedes crear un anuncio por conjunto de anuncios. No obstante, puedes crear más anuncios de contenido dinámico en otros nuevos conjuntos de anuncios.

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

Luego de crear tu anuncio, ocurre lo siguiente:

Una vez que crees un anuncio con contenido dinámico, no podrás eliminarlo o archivarlo. Como alternativa, debes eliminar o archivar el conjunto de anuncios principal.

El contenido dinámico es compatible con todas las ubicaciones, salvo sponsored_messages en Messenger.

Anuncios por secuencia

El contenido dinámico entrega la mejor combinación de activos en el formato de anuncio por secuencia. Si tu lista tiene menos de 10 imágenes, la cantidad de tarjetas de la secuencia será igual a la cantidad de imágenes. Si usas más de 10 imágenes, mostraremos una secuencia con 10 tarjetas. Te recomendamos usar imágenes cuadradas.

Si usas una secuencia con contenido dinámico, no podrás usar 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 estadísticas del activo, agregamos en los activos de la primera tarjeta las métricas basadas en impresiones correspondientes a los activos de todas las tarjetas. Los activos de tarjeta incluyen las imágenes, el título y la descripción.

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

Paso 4 (opcional): Verificar el estado de revisión

Después de crear tu campaña, conjunto de anuncios y anuncio, verifica el estado de revisión de anuncios:

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

El resultado incluye comentarios sobre la revisión de anuncios. Si ves una matriz vacía, tu anuncio pasó la revisión:

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

Si tu anuncio no pasó la revisión, verás 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>"  
}