Segmentación por ubicación

Entrega anuncios en ubicaciones específicas, por ejemplo, el feed de la computadora o el feed del celular y el video con premio de Audience Network. Solo puedes usar determinadas opciones de ubicación según el 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/v21.0/act_<AD_ACCOUNT_ID>/adsets


Si no especificas nada en un determinado campo de ubicación, Facebook considera todas las posiciones predeterminadas posibles para ese campo. Por ejemplo: si configuras publisher_platforms en facebook, pero no seleccionas nada en facebook_positions, Facebook considera todas las posiciones predeterminadas de Facebook, como feed, right_hand_column, etc. O, si no seleccionas ninguna opción en publisher_platforms, Facebook tiene en cuenta todas las publisher_platforms predeterminadas. Facebook también podría tener en cuenta, de manera automática, todas las nuevas posiciones y plataformas a medida que estén disponibles.

En Audience Network, puedes limitar qué editores pueden mostrar tus anuncios. Excluye editores por categoría o crea una lista personalizada de URL de tiendas de apps o URL de dominio que deseas excluir.

No puedes usar solamente right_hand_column como ubicación de anuncios de video, colección o Canvas.

El filtro de inventario te ayuda a determinar si tus anuncios se muestran junto a diferentes tipos de contenido en relación con los anuncios en el contenido (videos instream de Facebook, anuncios en Facebook Reels y anuncios en Instagram Reels), anuncios en Audience Network y anuncios en el feed (feed de Facebook, feed de Instagram, feed de Facebook Reels y feed de Instagram Reels). Para obtener más información sobre estas categorías de contenido, consulta el servicio de ayuda para anunciantes, filtro de inventario. Puedes elegir valores distintos para anuncios en el contenido, en Audience Network y en el feed. Las opciones son Expanded, Moderate y Limited. Para obtener más información, consulta a continuación brand_safety_content_filter_levels:

Nombre Descripción

brand_safety_content_filter_levels

matriz <string>

En el caso de los anuncios en el contenido (instream de Facebook y anuncios en Facebook Reels), permitimos estos valores:

  • EXPANDED: FACEBOOK_RELAXED
  • MODERATE: FACEBOOK_STANDARD
  • LIMITED: FACEBOOK_STRICT

Permitimos estos valores de Audience Network:

  • EXPANDED: AN_RELAXED
  • MODERATE: AN_STANDARD
  • LIMITED: AN_STRICT

En el caso de anuncios en el feed (feed de Facebook, feed de Instagram, feed de Facebook Reels y feed de Instagram Reels), permitimos estos valores:

  • EXPANDED: FEED_RELAXED
  • MODERATE: FEED_STANDARD
  • LIMITED: FEED_STRICT

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

Nota: Cuando se aplique un filtro en el nivel de la cuenta publicitaria, solo habrá opciones más restrictivas disponibles en el nivel de campaña. Por ejemplo, si la cuenta se configuró en MODERATE, el usuario solo podrá seleccionar MODERATE o LIMITED en una campaña. No habrá opciones menos restrictivas (en este ejemplo, EXPANDED) disponibles.

excluded_publisher_categories

matriz <string>

Incluye: dating y gambling

excluded_publisher_list_ids

matriz de <cadenas numéricas>

Cada cadena es un identificador de lista con exclusiones. Crea listas personalizadas en el administrador de anuncios o en la 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 Audience Network, y videos instream, 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.
Predeterminado: todos
Los tipos de dispositivos con los que cuenta una persona que ve tu anuncio.

publisher_platforms: facebook, instagram, messenger, audience_network

Opcional.
Predeterminado: todos
El canal de publicación de tu anuncio. Puedes establecer la posición del canal de publicación configurándola 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, facebook_reels_overlay, profile_feed

Opcional.
Predeterminada: todos


Notas:

  • Si proporcionas el parámetro publisher_platforms, este debe incluir facebook; si lo omites, se seleccionarán todos los canales de forma predeterminada.
  • feed incluye el feed en las computadoras y los dispositivos móviles.
  • En relación con las campañas que segmentan a Estados Unidos (US), Reino Unido (GB), Francia (FR), España (ES), Alemania (DE), México (MX), India (IN) y Tailandia (TH), puedes seleccionar instream_video sin feed para los objetivos VIDEO_VIEWS y POST_ENGAGEMENT. No se admite instream_video para el objetivo CONVERSIONS.
  • Si seleccionas story, debes usar feed de Facebook o story y device_platforms: mobile de Instagram, porque Facebook Stories solo está disponible en dispositivos móviles.
  • Si seleccionas marketplace, search o profile_feed, debes utilizar feed.
  • A partir de la versión 3.0, right_hand_column solo estará disponible para una imagen sola, un video solo y formatos por secuencia de los objetivos TRAFFIC, CONVERSIONS y PRODUCT_CATALOG_SALES.

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

Opcional.
Predeterminado: todos
Puedes segmentar anuncios por secuencia de Instagram en stream, story o ig_search de Instagram. Si utilizas contenido de secuencia automática en las historias, no puedes seleccionar ambas opciones para el mismo conjunto de anuncios.
Los anuncios que usan story se mostrarán en feeds web de Instagram para computadoras y dispositivos móviles.

audience_network_positions: classic, rewarded_video

Opcional.
Predeterminado: Todo
De manera predeterminada, no mostramos effective_audience_network_positions cuando lees la especificación de segmentación de un conjunto de anuncios. Es posible que esto difiera de las audience_network_positions que configuraste. Si estableciste una posición que no se admite en un determinado objetivo, aparece en la lista de posiciones configuradas, pero no en la de las posiciones efectivas.

messenger_positions: messenger_home, sponsored_messages, story

Opcional.
Predeterminado: messenger_home, story


Notas:

  • Si seleccionas messenger_home, también debes seleccionar Facebook en el parámetro publisher_platform y feed en el parámetro facebook_positions.
  • messenger_home está disponible para una sola imagen y para secuencia en los objetivos LINK_CLICKS, CONVERSIONS, MESSAGES, APP_INSTALLS y PRODUCT_CATALOG_SALES de los anuncios que generan tráfico a los sitios web, a las apps y a Messenger.
  • Si seleccionas story, debes usar feed de Facebook o story y device_platforms: mobile de Instagram, porque Messenger Stories solo está disponible en dispositivos móviles. Puedes usar story para los formatos de imagen sola y video en campañas de anuncios con los objetivos CONVERSIONS, TRAFFIC, REACH, BRAND_AWARENESS y APP_INSTALLS de anuncios que generan tráfico a sitios web y apps.
  • No puedes usar sponsored_messages con otras ubicaciones; tampoco messenger_home o ubicaciones de Facebook.

Lógica

  • La lógica de las opciones en el mismo parámetro es OR.
    Por ejemplo, publisher_platforms=['facebook','instagram'] significa "entregar anuncios en Facebook e Instagram".
  • La lógica entre los parámetros es AND.
    Por ejemplo, publisher_platforms=['facebook']&device_platforms=['mobile'] significa "entregar estos anuncios solo en Facebook para celulares".
  • Si la lógica no segmenta a nadie, como publisher_platforms=['instagram']& device_platforms=['desktop'], se mostrará un error.

Limitaciones

  • No puedes usar únicamente Audience Network, por lo que publisher_platforms: audience_network no se puede seleccionar por sí solo.
  • La ubicación audience_network con el objetivo VIDEO_VIEWS se debe usar con el objetivo de optimización THRUPLAYS.
  • No puedes seleccionar story para facebook_positions por sí solo. Si seleccionas story para facebook_positions, también debes seleccionar feed de Facebook o story de Instagram.
  • No puedes seleccionar story para messenger_positions por sí solo. Si seleccionas story para messenger_positions, también debes seleccionar feed de Facebook o story de Instagram.
  • Los anuncios de feed web de Instagram usan la ubicación stream. Además, se comprueba su elegibilidad web para entregarse a feeds web en computadoras y celulares. Los objetivos compatibles son BRAND_AWARENESS, REACH, LINK_CLICKS, POST_ENGAGEMENT, VIDEO_VIEWS y CONVERSIONS.

Ejemplos

Historias

Para usar Facebook Stories como tu 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

Video instream

Para crear un conjunto de anuncios con instream_video como única ubicación que se dirija a uno de los países admitidos mencionados 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 entregar los anuncios en la ubicación de videos 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 tu 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

Inicio de "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., "US"):

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/v21.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., "US"):

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/v21.0/act_<AD_ACCOUNT_ID>/adsets

Ubicación efectiva con segmentación

Puedes crear conjuntos de anuncios con ubicaciones en la especificación de segmentación; sin embargo, no siempre sabes si Facebook entregó tu anuncio en las ubicaciones especificadas. Esto se debe a que es posible que la ubicación que seleccionaste no se aplique al objetivo publicitario que elegiste. Con la API de ubicaciones efectivas para segmentación, puedes determinar en qué ubicaciones se entregará tu anuncio según las opciones de segmentación que indicaste, y recibir mensajes de validación para que puedas comprender por qué algunas ubicaciones quedan excluidas. Si no proporcionas segmentación, de todos modos puedes determinar la ubicación efectiva en función de la configuración del conjunto de anuncios y la campaña publicitaria.

Para leer una campaña efectiva según tu segmentación, coloca effective_ delante 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 ver por qué algunas ubicaciones quedaron excluidas, usa el campo recommendation:

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

Con las publicaciones eficaces, puedes determinar en qué ubicaciones se entrega tu anuncio, en función del billing_event, el optimization_goal y el promoted_object del conjunto de anuncios, y también del buying_type y el objective de la campaña. Los parámetros de /ad_campaign_placement incluyen:

  • account_id de la cuenta publicitaria y token de acceso
  • billing_event, como IMPRESSIONS
  • Tipo de compra, como AUCTION
  • Objetivo, como POST_ENGAGEMENT
  • Objetivo de optimización, que es opcional, como POST_ENGAGEMENT
  • Objeto promocionado, como PIXEL_ID

Se necesitan todos los parámetros, con excepción de promoted_object y optimization_goal. Si especificas la segmentación, puedes usar la API de marketing para determinar la ubicación eficaz en función de aquellas compatibles con tu configuración. Consulta Ubicación eficaz 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 usar el campo code del resultado en una llamada a /ad-recommendation para acceder a una explicación detallada. Por ejemplo, puedes obtener esta información:

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

Si quieres obtener más información, consulta Recomendación de anuncios, Referencia y Ubicación eficaz con segmentación.