Personalización de piezas por segmento

Esta solución permite personalizar piezas de contenido de los anuncios según los tipos de segmentación geográfica. A fin de personalizar las piezas de contenido para diferentes ubicaciones, consulta Personalización de piezas por ubicación.

La personalización de piezas por segmento es una de nuestras tres API que utilizan las reglas de personalización de piezas. Consulta Reglas de personalización de piezas.

Con el lanzamiento de la versión 8.0 de la API de marketing, todos los casos de uso que no estaban relacionados con la geolocalización se han retirado para la personalización de piezas por segmento. Todas las reglas de segmentación ahora deben contener información de geolocalización en la especificación de la personalización. Hay una excepción para la regla predeterminada, que no necesita incluir geolocalización.

Introducción

Antes de comenzar, consulta las restricciones de este producto. Si tu caso de uso cumple nuestras especificaciones, continúa con los pasos siguientes:

Paso 2: Proporcionar el contenido del anuncio

Opciones de personalización

El anuncio puede personalizarse por geolocalizaciones. Para ello, debes crear una regla con una especificación de personalización. El tipo de personalización admitido es el siguiente:

  • Geolocalizaciones: se admite countries, regions, cities, geo_markets, zips y location_types.

El formato para indicar una especificación de personalización es similar al formato de la segmentación principal; puedes consultar Segmentación para obtener más información.

Crear reglas de personalización de piezas

Las reglas de personalización de piezas permiten agrupar piezas de contenido que aparecen juntas para una geolocalización determinada. Cada regla tiene un parámetro customization_spec que define las geolocalizaciones de los usuarios que pueden ver dichas piezas de contenido en el momento de la entrega de anuncios.

Puedes especificar una prioridad para cada regla durante la creación. De lo contrario, asignaremos a cada regla un número de prioridad según su posición en la lista proporcionada de reglas. Por ejemplo, a la primera regla de la lista se le asigna prioridad 1.

Debes configurar una regla predeterminada para evitar la entrega de una combinación aleatoria de piezas de contenido a usuarios que no coincidan con ninguna regla. Para ello, haz lo siguiente:

  • Crea un parámetro customization_spec vacío. Usa corchetes de apertura y cierre al final de la regla, como {}.
  • Asigna la prioridad más baja a la regla. Este es el número total de reglas, incluida la predeterminada. Si tienes diez reglas más una predeterminada, la prioridad de la predeterminada debería ser 11.

La regla predeterminada coincide con una pieza de contenido que se mostrará a los usuarios que no satisfagan ninguna de las reglas anteriores.

En la configuración, las reglas que no sean predeterminadas deben coincidir con un porcentaje elevado de la audiencia objetivo.

Configurar una especificación de una lista de piezas de contenido

Crea un parámetro asset_feed_spec y añade las reglas de personalización al campo asset_customization_rules. Puedes añadir hasta 50 reglas de personalización.

Para cada regla, tienes que especificar customization_spec, priority y las etiquetas de la pieza de contenido. El parámetro customization_specno puede tener más de 50 condiciones para una sola regla.

Ejemplo de configuración de una lista de piezas de contenido:

curl \
-F 'object_story_spec={
       "page_id": "<YOUR_PAGE_ID>",
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>"
    }' \
-F 'asset_feed_spec={
 "images": [
   {"hash":"<IMAGE_HASH>", "adlabels":[{"name":"image1"}]}, 
   {"hash":"<IMAGE_HASH>", "adlabels":[{"name":"image2"}]}
 ], 
 "bodies": [
   {"text":"Motor City Mission Corps", "adlabels":[{"name":"body1"}]}
 ], 
 "titles": [
   {"text":"Link title 1 goes here", "adlabels":[{"name":"title1"}]}, 
   {"text":"Link title 2 goes here", "adlabels":[{"name":"title2"}]},
   {"text":"Link title 3 goes here", "adlabels":[{"name":"title3"}]}
 ], 
 "call_to_action_types":[
   "LEARN_MORE"
 ],
 "descriptions": [
   {"text":"Begin Your Adventure"}
 ], 
 "ad_formats": [
   "SINGLE_IMAGE"
 ], 
 "link_urls": [
   {"website_url":"https://www.example.com/"}
 ],
 "asset_customization_rules": [
   { 
     "customization_spec": {
        "geo_locations": {
          "countries": ["US"]
        }
     },
     "image_label": {"name": "image1"},
     "title_label": {"name": "title1"},
     "priority": 1
   },
   {
     "customization_spec": {
       "geo_locations": {
          "countries": ["GB"]
        }
     }, 
     "image_label": {"name": "image1"},
     "title_label": {"name": "title2"},
     "priority": 2
   },
   {
     "customization_spec": {
       "geo_locations": {
         "cities": [
           {"key": "2481714"},
           {"key": "2481868"}
         ]
       }
     },
     "image_label": {"name": "image1"},
     "title_label": {"name": "title3"},
     "priority": 4
   },
   {
     "customization_spec": {}, 
     "image_label": {"name":"image2"},
     "title_label": {"name":"title1"},
     "priority": 5
  }]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Consulta todas las opciones disponibles para una especificación de una lista de piezas de contenido. Consulta los siguientes pasos en Reglas de personalización de piezas.

Paso 3 opcional: Obtener una vista previa del anuncio

Obtén una vista previa de las diferentes versiones de la regla de segmentación del anuncio mediante el extremo /generatepreview. También puedes añadir un campo dynamic_asset_label con un número de prioridad para ver la versión de un idioma en concreto.

Por ejemplo, para obtener una vista previa de una regla con prioridad 1:

curl -G --data-urlencode 
'creative={ 
  "object_story_spec": { 
    "page_id": "<PAGE_ID>" 
  },
  "asset_feed_spec": {
    ...
    "asset_customization_rules": [
      { 
        "customization_spec": { 
          "geo_locations": { 
          "countries": ["US"] 
          } 
        },
        "image_label": {
          "name": "image1"
        },
        "title_label": {
          "name": "title1"
        },
        "priority": 1
    },
    ...
    ]
  }
}' 
-d 'ad_format=DESKTOP_FEED_STANDARD' 
-d 'dynamic_asset_label=1'
-d 'access_token=<ACCESS_TOKEN>' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/generatepreviews

Restricciones

Categoría de anuncio especial: los anunciantes que muestran anuncios de vivienda, empleo y crédito con sede en los Estados Unidos o que muestran anuncios dirigidos a los Estados Unidos tienen un conjunto de restricciones distinto. Estos anunciantes deben cumplir las restricciones de la categoría de anuncio especial indicadas en asset_feed_spec. Obtén más información sobre la categoría de anuncio especial.

Campaña, Validación de objetivos: no se admite APP_ENGAGEMENT.

Ubicaciones admitidas: se admiten todas las ubicaciones.

Tipo de compra: Alcance y frecuencia o AUCTION.

Personalización por ubicación: si se usa la personalización por ubicación en alguna de las reglas, todas las reglas deben incluir la personalización por ubicación.

Las restricciones de asset_feed_spec coinciden con las de los anuncios basados en listas de piezas de contenido sin reglas de personalización. No obstante, hay varias excepciones:

  • Cada imagen o vídeo debe tener una etiqueta adjunta.
  • Solo se puede mostrar una imagen o vídeo por asset_customization_rule.
  • Formatos de anuncio: se admiten dos valores de ad_formats, que son SINGLE_IMAGE y SINGLE_VIDEO. Solo se admite un valor de ad_format por lista de piezas de contenido.
  • Solo puedes proporcionar un elemento en call_to_actions_types.
  • Para cada configuración de ubicación de la segmentación de un conjunto de anuncios, debes proporcionar al menos un valor de asset_customization_rule.