API de marketing

Segmentación de ubicaciones

Entrega anuncios en ubicaciones específicas, como en la sección de noticias del ordenador solamente o en la sección de noticias del móvil y en un vídeo con premio de Audience Network. Solo puedes usar determinadas opciones de ubicación en función del objetivo de la campaña. Consulta Campaña, Objetivo y ubicaciones para obtener más información.

Las plataformas y posiciones disponibles son device_platforms, publisher_platforms, facebook_positions, audience_network_positions, instagram_positions y messenger_positions. Consulta la sección Dispositivo, editor y posiciones para obtener más información.

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="REACH"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "facebook"
       ],
       "facebook_positions": [
         "feed"
       ]
     }' \
  -F 'promoted_object={
       "page_id": "<PAGE_ID>"
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets


Si no especificas ningún valor para un campo de ubicación determinado, Facebook considera todas las posiciones predeterminadas posibles de ese campo. Por ejemplo, si estableces publisher_platforms en facebook, pero no seleccionas ningún valor para facebook_positions, Facebook considera todas las posiciones predeterminadas de la plataforma, como feed, right_hand_column, etc. Si no seleccionas ningún valor para publisher_platforms, Facebook considera todos los valores predeterminados de publisher_platforms. Es posible que Facebook también considere automáticamente las plataformas y posiciones nuevas a medida que estén disponibles.

En Audience Network, puedes limitar los editores que muestran tus anuncios. Puedes excluir editores por categoría o crear una lista personalizada de URL de dominios o tiendas de aplicaciones que excluir.

No puedes utilizar solo right_hand_column de forma independiente como ubicación de los anuncios de lienzo, colección o vídeo.

El filtro de inventario ayuda a controlar si los anuncios se muestran junto a distintos tipos de contenido en las ubicaciones in-stream de Facebook y Audience Network. Para obtener más información sobre estas categorías de contenido, consulta Servicio de ayuda para publicidad, Filtro de inventario. Puedes elegir un valor para las ubicaciones in-stream de Facebook y un valor para Audience Network. Las opciones son las siguientes: Full, Standard y Limited. Para obtener más información, consulta brand_safety_content_filter_levels a continuación:

Nombre Descripción

brand_safety_content_filter_levels

Matriz<string>

Admitimos los siguientes valores para las ubicaciones in-stream de Facebook:


  • FULL: FACEBOOK_RELAXED
  • STANDARD: FACEBOOK_STANDARD
  • LIMITED: FACEBOOK_STRICT

Para Audience Network, se permiten los valores siguientes:


  • FULL: AN_RELAXED
  • STANDARD: AN_STANDARD
  • LIMITED: AN_STRICT

Ejemplo:"brand_safety_content_filter_levels":["FACEBOOK_STRICT", "AN_RELAXED"]

NOTA: Cuando se aplica un filtro a nivel de cuenta publicitaria, solo habrá disponibles opciones más restrictivas a nivel de campaña. Por ejemplo, si la cuenta está configurada como Moderada, el usuario solo podrá seleccionar Moderado o Limitado en las campañas. Las opciones menos restrictivas (en este ejemplo, Ampliado) no estarán disponibles.

excluded_publisher_categories

Matriz<string>

Incluye dating y gambling.

excluded_publisher_list_ids

Matriz<numeric strings>

Cada cadena es un identificador de las listas de exclusiones. Crea listas personalizadas en el administrador de anuncios o consulta API de marketing, Lista de bloqueo de editores.


Ejemplo:
"excluded_publisher_list_ids":["{block_list_id_1}","{block_list_id_2}"]

Por ejemplo, para usar brand_safety_content_filter_levels:

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting= { "geo_locations":{"countries":["US"]}, "brand_safety_content_filter_levels":["FACEBOOK_STRICT","AN_STANDARD"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/VERSION/AD_ACCOUNT_ID/adsets

En el caso de Audience Network, y los vídeos in-stream, también puedes excluir editores por categoría:

Nombre Descripción

excluded_publisher_categories

Matriz<string>

Incluye:

  • debated_social_issues
  • mature_audiences
  • tragedy_and_conflict

Ejemplo:
"excluded_publisher_categories": ["debated_social_issues", "mature_audiences"]

Dispositivo, editor y posiciones

Nombre: opciones Descripción

device_platforms: mobile, desktop

Opcional.
Valor predeterminado: todos.
Los tipos de dispositivo que tiene una persona que ve el anuncio.

publisher_platforms: facebook, instagram, messenger, audience_network

Opcional.
Valor predeterminado: todos.
El canal de publicación del anuncio. Para definir la posición del canal de publicación, debes establecerla en facebook_positions, instagram_positions, audience_network_positions o messenger_positions.

facebook_positions: feed, right_hand_column, marketplace, video_feeds, story, search, instream_video, facebook_reels, profile_feed

Opcional.
Valor predeterminado: todos.


Notas:

  • Si se proporciona, publisher_platforms debe incluir facebook; en caso contrario, se utilizan todos los valores de forma predeterminada.
  • feed incluye el feed del ordenador y el móvil.
  • En el caso de las campañas dirigidas a Estados Unidos (US), Reino Unido (GB), Francia (FR), España (ES), Alemania (DE), México (MX), India (IN) y Tailandia (TH), puedes usar instream_video sin feed para los objetivos VIDEO_VIEWS y POST_ENGAGEMENT. instream_video no se admite en el objetivo CONVERSIONS.
  • Si seleccionas story, debes utilizar el objeto feed de Facebook o los objetos story y device_platforms: mobile de Instagram, ya que Facebook Stories solo está disponible para móviles.
  • Si seleccionas marketplace, search o profile_feed, debes utilizar feed.
  • A partir de la versión 3.0, right_hand_column solo está disponible en formatos de imagen única, vídeo único o por secuencia para los objetivos TRAFFIC, CONVERSIONS y PRODUCT_CATALOG_SALES.

instagram_positions: stream, story, explore, explore_home, reels, profile_feed, ig_search, profile_reels

Opcional.
Valor predeterminado: todos.
Puedes dirigir los anuncios por secuencia de Instagram a los objetos stream, story o ig_search de esta plataforma. Si usas contenido por secuencia en las historias sin avisar, no puedes seleccionar las dos opciones para el mismo conjunto de anuncios.
Los anuncios que utilicen story se mostrarán en los feeds web de Instagram para ordenadores y móviles.

audience_network_positions: classic, rewarded_video

Opcional.
Valor predeterminado: todos.
De forma predeterminada, no se devuelve effective_audience_network_positions al leer las especificaciones de segmentación de un conjunto de anuncios. Puede ser diferente al objeto audience_network_positions configurado. Si especificas una posición que no se admite en un objetivo determinado, aparece en la lista de posiciones configuradas, pero no en la de posiciones efectivas.

messenger_positions: messenger_home, sponsored_messages, story

Opcional.
Valor predeterminado: messenger_home, story.


Notas:

  • Si seleccionas messenger_home, también debes seleccionar los objetos publisher_platform y feed de Facebook para facebook_positions.
  • messenger_home está disponible para secuencias e imágenes únicas en los objetivos LINK_CLICKS, CONVERSIONS, MESSAGES, APP_INSTALLS y PRODUCT_CATALOG_SALES de los anuncios que dirigen el tráfico a sitios web, aplicaciones y Messenger.
  • Si seleccionas story, debes utilizar el objeto feed de Facebook o los objetos story y device_platforms: mobile de Instagram, ya que Messenger Stories solo está disponible para móviles. Puedes usar story para formatos de imagen y vídeo únicos en campañas publicitarias con los objetivos CONVERSIONS, TRAFFIC, REACH, BRAND_AWARENESS y APP_INSTALLS de los anuncios que dirigen el tráfico a sitios web y aplicaciones.
  • No puedes usar sponsored_messages con las otras ubicaciones, incluidas las ubicaciones de Facebook o messenger_home.

Lógica

  • La lógica para las opciones del mismo parámetro es OR.
    Por ejemplo, publisher_platforms=['facebook','instagram'] quiere decir que los anuncios se entregan en Facebook e Instagram.
  • La lógica entre parámetros es AND.
    Por ejemplo, publisher_platforms=['facebook']&device_platforms=['mobile'] quiere decir que dichos anuncios se entregan solo en Facebook Móvil.
  • Si la lógica tiene como resultado no dirigirse a nadie, como publisher_platforms=['instagram']& device_platforms=['desktop'], aparecerá un error.

Limitaciones

  • Audience Network no se puede usar de forma independiente, de modo que no se puede seleccionar únicamente publisher_platforms: audience_network.
  • La ubicación audience_network con el objetivo VIDEO_VIEWS se debe usar con el objetivo de optimización THRUPLAYS.
  • No se puede seleccionar únicamente story para facebook_positions. Si se selecciona story para facebook_positions, también se debe seleccionar el objeto feed de Facebook o story de Instagram.
  • No se puede seleccionar únicamente story para messenger_positions. Si se selecciona story para messenger_positions, también se debe seleccionar el objeto feed de Facebook o story de Instagram.
  • Los anuncios del feed web de Instagram utilizan la ubicación stream. Además, se comprueba si cumplen los requisitos web para mostrarlos en los feeds web tanto del ordenador como de dispositivos móviles. Los objetivos compatibles son BRAND_AWARENESS, REACH, LINK_CLICKS, POST_ENGAGEMENT, VIDEO_VIEWS y CONVERSIONS.

Ejemplos

Historias

Para usar Facebook Stories como ubicación:

curl \
  -F 'name=My Ad Set' 
  -F 'optimization_goal=CONVERSIONS' 
  -F 'billing_event=IMPRESSIONS' 
  -F 'bid_amount=2' 
  -F 'daily_budget=1000' 
  -F 'campaign_id=<AD_CAMPAIGN_ID>' 
  -F 'targeting={"geo_locations":{"countries":["US"]}, "publisher_platforms":["messenger", "facebook"], "facebook_positions":["story"], "messenger_positions":["story"]}' 
  -F 'status=ACTIVE'
  -F 'access_token=<ACCESS_TOKEN>' 
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Vídeo in-stream

Para crear un conjunto de anuncios solo con la ubicación instream_video que se dirija a uno de los países admitidos señalados anteriormente:

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["instream_video"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Audience Network

Para dirigirse a la ubicación de un vídeo con premio de Audience Network:

curl \
  -F 'name=My Ad Set' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'is_autobid=true' \
  -F 'daily_budget=40000' \
  -F 'campaign_id=<AD_CAMPAIGN_ID>' \
  -F 'targeting={"app_install_state": "not_installed","geo_locations":{"countries":["US"]},"facebook_positions":["feed"],"device_platforms": ["mobile"],"audience_network_positions": ["classic","rewarded_video"],"user_device": ["Android_Smartphone","Android_Tablet"],"user_os": ["Android_ver_4.4_and_above"]}' \
  -F 'promoted_object={"application_id": "<APPLICATION_ID>","custom_event_type": "PURCHASE","object_store_url": "<OBJECT_STORE_URL>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<APIVERSION>/<AD_ACCOUNT_ID>/adsets

Se devuelve lo siguiente:

{
  "targeting": {
    "audience_network_positions": [
      "classic",
      "rewarded_video"
    ],
    "effective_audience_network_positions": [
      "classic",
      "rewarded_video"
    ]
  },
  "id": "<AD_SET_ID>"
}

Reels

Para usar Facebook Reels como ubicación:

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=CAMPAIGN_ID' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"publisher_platforms":["facebook"], "facebook_positions":["facebook_reels"]}' \
  -F 'status=ACTIVE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/API_VERSION/act_AD_ACCOUNT_ID/adsets

Sección “Explorar” de Instagram

Para crear un conjunto de anuncios con la ubicación explore_home que se dirija a uno de los países admitidos (p. ej., “EE. UU.”):

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "instagram"
       ],
       "instagram_positions": [
         "stream",
         "explore",
         "explore_home"
       ],
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Resultados de búsqueda de Instagram

Para crear un conjunto de anuncios con la ubicación ig_search que se dirija a uno de los países admitidos (p. ej., “EE. UU.”):

curl -X POST \
  -F 'name="My AdSet"' \
  -F 'optimization_goal="LINK_CLICKS"' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'targeting={
       "geo_locations": {
         "countries": [
           "US"
         ]
       },
       "publisher_platforms": [
         "instagram"
       ],
       "instagram_positions": [
         "stream",
         "ig_search"
       ],
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Ubicación efectiva con segmentación

Aunque creas los conjuntos de anuncios con ubicaciones en las especificaciones de segmentación, no siempre sabes si Facebook entregó el anuncio en las ubicaciones indicadas. Esto se debe a que las ubicaciones seleccionadas puede que no se apliquen al objetivo publicitario elegido. Con la API de ubicaciones efectivas para la segmentación, puedes determinar las ubicaciones en las que se entregará el anuncio, según las opciones de segmentación, y recibir mensajes de validación para comprender por qué se excluyen algunas ubicaciones. Si no proporcionas una segmentación, puedes determinar la ubicación efectiva en función de la configuración del conjunto de anuncios y de la campaña publicitaria.

Para leer una ubicación efectiva en función de la segmentación, incluye effective_ antes del nombre del campo de ubicación. Por ejemplo:

curl -G \
  -d "fields=targeting{effective_publisher_platforms,effective_facebook_positions,effective_device_platforms,effective_audience_network_positions,effective_instagram_positions}" \
  -d "access_token=<access_token>" \
  https://graph.facebook.com/<VERSION>/<AD_SET_ID>

Para consultar por qué se excluyen algunas ubicaciones, utiliza el campo recommendation:

curl -G \
  -d "fields=recommendations" \
  -d "access_token=<access_token>" \
  https://graph.facebook.com/<VERSION>/23842573364570019

Las ubicaciones efectivas permiten determinar en qué ubicaciones se entregará el anuncio en función de los campos billing_event, optimization_goal y promoted_object del conjunto de anuncios, así como los campos buying_type y objective de la campaña publicitaria. Todos los parámetros para /ad_campaign_placement incluyen:

  • Valor de account_id del anuncio e identificador de acceso
  • Valores de billing_event; por ejemplo, IMPRESSIONS
  • Tipo de compra; por ejemplo, AUCTION
  • Objetivo; por ejemplo, POST_ENGAGEMENT
  • Objetivo de optimización, que es opcional; por ejemplo, POST_ENGAGEMENT
  • Objeto promocionado; por ejemplo, PIXEL_ID

Todos los parámetros, excepto promoted_object y optimization_goal, son obligatorios. Si proporcionas segmentación, puedes utilizar la API de marketing para determinar una ubicación efectiva a partir de las permitidas para tu configuración. Consulta la documentación Ubicación efectiva con segmentación. Por ejemplo:

curl -G \
-d 'account_id=<ACCOUNT_ID>' \
-d 'billing_event=IMPRESSIONS' \
-d 'buying_type=AUCTION' \
-d 'objective=PAGE_LIKES' \
-d 'optimization_goal=IMPRESSIONS' \
https://graph.facebook.com/<VERSION>/ad_campaign_placement?access_token=<TOKEN>

La llamada devuelve lo siguiente:

{
   "effective_device_platforms": [
      "mobile",
      "desktop"
   ],
   "effective_facebook_positions": [
      "feed",
      "right_hand_column"
   ],
   "effective_publisher_platforms": [
      "facebook"
   ],
   "recommendations": [
      {
         "title": "Placement Not Supported By Objective",
         "message": "Ads with PAGE_LIKES objective do not support facebook.instream_video, facebook.suggested_video, facebook.marketplace, audience_network.classic, audience_network.instream_video, audience_network.rewarded_video, instagram.stream, instagram.story, messenger.messenger_home.",
         "code": 1815609,
         "importance": "LOW",
         "confidence": "HIGH",
         "blame_field": "targeting"
      },
      {
         "title": "Device Platform Not Supported By Objective",
         "message": "Ads with PAGE_LIKES objective do not support connected_tv.",
         "code": 1815610,
         "importance": "LOW",
         "confidence": "HIGH",
         "blame_field": "targeting"
      }
   ],     
   }
}

Puedes utilizar el campo code de este resultado en una llamada a /ad-recommendation para ver un motivo detallado. Por ejemplo, puedes obtener esta información:

[{“code”: 1815610, “summary”: “Device Platform Not Supported By Objective”},]

Para obtener más información, consulta la referencia sobre recomendaciones de anuncios y Ubicación efectiva con segmentación.