API de marketing

Reglas de personalización de piezas

Usa esta solución para definir las piezas de contenido que quieras mostrar en tus anuncios. Al crear un anuncio, puedes elegir la combinación de piezas de contenido que quieras mostrar según tus reglas de personalización de piezas. Las imágenes, los vídeos, el texto y el cuerpo de un anuncio son ejemplos de piezas de contenido.

Ofrecemos tres API que utilizan reglas de personalización de piezas:

Todos los anuncios que utilicen el parámetro asset_feed_spec deben contener al menos dos reglas de personalización de destino. Si el contenido utiliza el parámetro asset_feed_spece incluye menos de dos reglas, no podrás crear el anuncio.

Introducción

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

Puedes crear una campaña publicitaria estándar para reglas de personalización de piezas, aunque hay algunas limitaciones:

API Objetivos de campaña admitidos

Personalización de piezas por segmento

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LINK_CLICKS, REACH y VIDEO_VIEWS.

Personalización de piezas por ubicación

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LEAD_GENERATION, LINK_CLICKS, REACH y VIDEO_VIEWS.

Anuncios en varios idiomas

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LINK_CLICKS, REACH y VIDEO_VIEWS.

Para el conjunto de anuncios, utiliza el extremo de conjunto de anuncios estándar y establece el valor de is_dynamic_creative en false.

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=Sample Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=false'
  -F 'lifetime_budget=1000'
  -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=2019-04-02'
  -F 'end_time=2019-04-09'
  -F 'access_token=<ACCESS_TOKEN>'
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

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.

asset_feed_spec proporciona contenido para contenido dinámico, personalización de piezas por ubicación, anuncios en varios idiomas y personalización de piezas por segmento. El formato de la especificación es diferente para cada solución.

Paso 2: Proporcionar el contenido del anuncio

Proporciona el contenido mediante asset_feed_spec. Una lista de piezas de contenido es una colección de distintos elementos de contenido, como imágenes, títulos o cuerpos, entre otros. Puede especificar múltiples piezas de contenido para cada tipo de pieza.

Crea un parámetro asset_feed_spec en /adcreative. Para aplicar opciones de personalización, establece asset_customization_rules en asset_feed_spec.

Tras la configuración, verifica el parámetro asset_feed_spec:

curl -G 
-d "access_token=<ACCESS_TOKEN>"
-d "fields=asset_feed_spec" 
https://graph.facebook.com/v21.0/<AD_CREATIVE_ID>

Al crear el anuncio, proporciona una referencia al identificador del contenido. Puedes crear varios anuncios por conjunto de anuncios.

curl 
      -F 'name=Asset Custom Rule Ad' 
      -F 'adset_id=<ADSET_ID>' 
      -F 'access_token=<ACCESS_TOKEN>' 
      -F 'creative={
          "creative_id": <CREATIVE_ID>,
       }' 
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads

Tras la creación: