Información general sobre el servicio de perfiles

Un perfil es un conjunto de parámetros de segmentación, como el sexo, la edad, la geografía y la frecuencia. Se puede aplicar a varios objetos del sistema, la mayoría de los cuales se enumeran a continuación. El uso más común del servicio de perfiles es ejecutar una campaña; crear un perfil y, posteriormente, asociarlo con el Servicio de campaña. El objeto de campaña incluye campos como fechas de lanzamiento y creatividades asociadas.

• A excepción de la segmentación por segmentos, los parámetros son absolutos. Por ejemplo, si la segmentación geográfica se establece solo para Estados Unidos, solo las impresiones en Estados Unidos recibirán pujas.
• La segmentación por segmento utiliza y/o lógica booleana.
• Los perfiles deben estar asociados a un anunciante o a un editor para poder usarse con otros objetos del sistema, que se enumeran a continuación.

Los perfiles se pueden usar con otros objetos del sistema (enumerados a continuación). Los campos del perfil que no se apliquen al objeto asociado se omitirán.

• Anunciante
• Línea de pedido
• Creatividad
• Campaña
• Regla de pago
• Regla de calidad de anuncios

También es posible hacer referencia a un perfil dentro de un objeto de transacción, mientras que no es necesario que el perfil esté asociado a un anunciante o editor.

API de REST

Método HTTP	Endpoint	Description
POST	https://api.appnexus.com/profile?advertiser_id=ADVERTISER_ID& member_id=MEMBER_ID (perfil JSON)	Agregar un nuevo perfil.
POST	https://api.appnexus.com/profile?advertiser_code=ADVERTISER_CODE (perfil JSON)	Agregar un nuevo perfil.
PUT	https://api.appnexus.com/profile?id=PROFILE_ID& advertiser_id=ADVERTISER_ID&member_id=MEMBER_ID (perfil JSON)	Modificar un perfil existente.
PUT	https://api.appnexus.com/profile?code=PROFILE_CODE& advertiser_code=ADVERTISER_CODE (perfil JSON)	Modificar un perfil existente.
GET	https://api.appnexus.com/profile?advertiser_id=ADVERTISER_ID& member_id=MEMBER_ID	Ver todos los perfiles de uno de tus anunciantes.
GET	https://api.appnexus.com/profile?advertiser_code=ADVERTISER_CODE	Ver todos los perfiles de uno de tus anunciantes.
GET	https://api.appnexus.com/profile?id=PROFILE_ID& advertiser_id=ADVERTISER_ID&member_id=MEMBER_ID	Ver un perfil específico para uno de tus anunciantes.
GET	https://api.appnexus.com/profile?code=PROFILE_CODE& advertiser_code=ADVERTISER_CODE	Ver un perfil específico para uno de tus anunciantes.

Nota:

postal_code_action_include - Para usar este servicio para perfiles de editores, reemplácelo advertiser_id por publisher_id.

Campos JSON

General

Campo	Tipo	Descripción
id	Entero	El id. del perfil. Required:PUT, en la cadena de consulta.
code	string	Código personalizado para el perfil.
description	string	Descripción opcional.
is_template	Booleano	Si true, el perfil se ha guardado como una plantilla de segmentación en. Para obtener perfiles que se dirigen a plantillas, pase is_template=true la cadena de consulta de una GET llamada. Para obtener más información sobre las plantillas de segmentación, consulta "Administración de plantillas de segmentación" en el sistema de ayuda de la aplicación. Valor predeterminado:false
last_modified	marca de tiempo	Hora de la última modificación de este perfil.
is_archived	booleano	Solo lectura. Indica si el perfil se ha archivado automáticamente debido a que su elemento de línea principal no se usa (y, por lo tanto, se ha archivado). Una vez establecido como true, el valor no se puede cambiar y las únicas llamadas que se pueden realizar en el objeto de perfil son GET y .DELETE Nota: Si el elemento primario de un perfil se archiva automáticamente, el perfil también se archivará. Además, una vez archivado, es posible que el perfil no se asocie con ningún elemento de línea o campaña. Valor predeterminado:false
archived_on	marca de tiempo	Solo lectura. La fecha y hora en que se archivó el perfil (es decir, cuando se estableció el is_archived campo en true). Valor predeterminado:null

Frecuencia

Para obtener más información sobre la segmentación por frecuencia y actualidad y los campos siguientes, consulta aquí.

Campo	Tipo	Descripción
max_lifetime_imps	Entero	El número máximo de impresiones por persona. Si se establece, este valor debe estar entre 0 y 255. Valor predeterminado:null
min_session_imps	Entero	El número mínimo de impresiones por persona y por sesión. Si se establece, este valor debe estar entre 0 y 255. Valor predeterminado:null
max_session_imps	Entero	El número máximo de impresiones por persona y sesión. Si se establece, este valor debe estar entre 0 y 255. Valor predeterminado:null
max_day_imps	Entero	El número máximo de impresiones por persona y día. Si se establece, este valor debe estar entre 0 y 255. Valor predeterminado:null
max_hour_imps	Entero	El número máximo de impresiones por persona y por hora. Si se establece, este valor debe estar entre 0 y 255. Valor predeterminado:null
max_week_imps	Entero	El número máximo de impresiones por persona y semana. Si se establece, este valor debe estar entre 0 y 255. Valor predeterminado:null
max_month_imps	Entero	El número máximo de impresiones por persona al mes. Si se establece, este valor debe estar entre 0 y 255. Valor predeterminado:null
min_minutes_per_imp	Entero	El número mínimo de minutos entre impresiones por persona. Es posible que este campo no esté establecido en 0. Valor predeterminado:null
max_page_imps	Entero	El número máximo de impresiones por carga de página (solicitud de anuncio del vendedor). Nota: Solo relevante para subastas de varias etiquetas (por ejemplo: /(ss)vmap). Valor predeterminado:null
require_cookie_for_freq_cap	Booleano	Indica si se servirá exclusivamente a usuarios con identificadores conocidos para mantener la configuración del límite de frecuencia. Establecer este campo en true indica que solo publicarás anuncios a usuarios con identificadores conocidos, por lo que se mantiene la configuración del límite de frecuencia. Establecer este campo en false indica que también atenderá a usuarios anónimos. Si has establecido un límite de frecuencia diario, la administración avanzada de frecuencias controlará las impresiones de los usuarios anónimos mediante el modelado. De lo contrario, la configuración del límite de frecuencia no se aplicará a esos usuarios. Dado que esta marca solo se aplica cuando se ha establecido un límite de frecuencia, establecer este campo en true no requerirá identificadores para un objeto que no tiene una configuración de límite de frecuencia activa. Valor predeterminado: true Nota: Actualmente, la administración avanzada de frecuencias no es compatible con los usuarios de Monetize.

Segmentación

Cuando se configuran varios segmentos, solo apto el inventario que cumple todos los criterios de segmentación. Por ejemplo, si segmenta el público general previsto y los orígenes de inventario x, y y z, el perfil solo segmentará general el inventario de públicos de los orígenes de inventario x, y y z.

Nota:

No puede especificar los campos and segment_group_targets en cualquiera POST de las segment_targets llamadas or PUT (solo se puede especificar uno de los dos).

• Tenga en cuenta que algunos destinos aceptan una matriz de objetos en lugar de enteros o cadenas. El formato se puede encontrar en los ejemplos al final de esta página.
• Para las líneas de pedido de compra garantizada mediante programación:
  • Solo puede dirigirse a un destino de oferta (consulte Destinos de ofertas a continuación) y el allow_unaudited campo debe establecerse en true.
  • No establezca ningún otro campo de segmentación.
• En el caso de las líneas de pedido aumentadas, es obligatorio establecer al menos un país como segmentación geográfica (consulta la segmentación por país a continuación).
• A partir del 30 de agosto de 2021:

  • El gráfico de TapAd proporcionará cobertura global excluyendo Europa.

  • Xandr's Graph proporcionará cobertura para Europa y Estados Unidos.

    Ajuste el código como corresponda.

Campo	Tipo	Descripción
graph_id	Entero	- Null Si la línea de pedido está segmentada, la selección gráfica predeterminada de su asiento de miembro. - 0 Si la línea de pedido no segmenta ningún gráfico. - 3 si la línea de pedido se dirige al gráfico de TapAd. - 4 si la línea de pedido tiene como destino Xandr Graph. Nota: Para los asientos de miembros de EMEA Invest incluidos en el piloto multidispositivo predeterminado, hay un cambio en las expectativas de campo graph_id . Pasar graph_id como Null ahora corresponderá a la selección gráfica predeterminada de su asiento de miembro. Para los miembros de nuestro piloto de EMEA, esto será graph_id = 4. Para deshabilitar la segmentación entre dispositivos, estos puestos de miembro deberán pasar graph_id = 0.
daypart_timezone	string	La zona horaria que se va a utilizar con el daypart_targets. Para obtener más información, consulte Zonas horarias de API. Nota:null es equivalente a la zona horaria del usuario. Valor predeterminado:null
daypart_targets	matriz de objetos	Las partes del día durante las cuales servir a la campaña. Para obtener más detalles, consulte Objetivos de la partición de días más abajo. Nota: Si no establece ningún segmento de día, la campaña se publicará todos los días de la semana en todo momento.
segment_targets	matriz de objetos	Nota: Si usas segment_targets y editas la campaña asociada en nuestra interfaz de usuario, los segmentos se convertirán en un grupo de la segment_group_targets matriz. Por lo tanto, se recomienda su uso segment_group_targets cuando se trabaja a través de la API. Los identificadores de segmento a los destinos, cada uno de los cuales tiene una acción asociada (include o exclude). Defina la lógica booleana entre segmentos con el segment_boolean_operator campo fuera de la matriz. Para obtener más detalles, consulta los segmentos y el ejemplo siguiente.
segment_group_targets	matriz de objetos	Los grupos de segmento a los que se va a dirigir. Mientras que la segment_targets matriz le permite definir la lógica booleana entre segmentos individuales, esta matriz le permite establecer grupos de segmentos, definiendo la lógica booleana entre los grupos, así como entre los segmentos dentro de cada grupo. La lógica booleana se define entre grupos con el segment_boolean_operator campo fuera de la matriz; la lógica booleana se define entre segmentos de un grupo con el boolean_operator campo dentro del objeto de grupo. Para obtener más información, consulte Segmentos de grupos y un ejemplo a continuación. Nota: No se pueden agregar segmentos nulos. No puede agregar null segmentos a esta matriz mediante POST o PUT.
segment_boolean_operator	enumeración	Si se usa segment_targets, esto define la lógica booleana entre los segmentos especificados. Si se usa segment_group_targets, esto define la lógica booleana entre los grupos de segmentos (la lógica booleana entre segmentos de un grupo se define directamente en la segment_group_targets matriz). Valores posibles: and o or. Valor predeterminado:and
age_targets	matriz de objetos	La lista de intervalos de edad a los que quieres dirigirte para este perfil. El allow_unknown campo está disponible como booleano para tener en cuenta las llamadas de anuncios en las que la edad del usuario no está disponible. Para obtener más descripción y ejemplos, consulta la sección Objetivos de edad a continuación.
gender_targets	objeto	Segmentación por sexo usada para el perfil. Los valores posibles para el género son m o f. El allow_unknown campo está disponible como booleano para tener en cuenta las llamadas de anuncios en las que el género del usuario no está disponible. Consulte la sección Objetivos de género a continuación.
country_targets	matriz de objetos	Los identificadores de país que se excluirán o incluirán en un perfil, según se define en el country_action campo. Puede usar el Servicio de país para recuperar una lista de identificadores de país. Para obtener más detalles y formato, consulta Segmentos por país. Requerido:POST/PUT, cuando country_action se incluye.
country_action	enumeración	Acción que debe tomarse en la country_targets lista. Valores posibles: include o exclude. Valor predeterminado:exclude
region_targets	matriz de objetos	Los identificadores de región o estado que se excluirán o incluirán en un perfil, tal como se define en el region_action campo. Puede usar el servicio de región para recuperar una lista de identificadores de región. Para obtener más detalles y formato, consulta Segmentos de región a continuación. Requerido en:POST/PUT, cuando region_action es include.
require_transparency_and_consent_framework_string	booleano	- Si true, solo permita que los objetos asociados compren inventario cuando haya una cadena TCF válida. - Si false, permite que los objetos asociados compren cualquier inventario que se encuentre dentro de las declaraciones de segmentación predefinidas. - Esto solo se admite a nivel de anunciante, ya que la segmentación a otros niveles puede dar lugar a un comportamiento indefinido. Nota: Este parámetro solo es aplicable al tráfico procedente de territorios en los que se aplica el RGPD. Valor predeterminado:false
region_action	enumeración	Acción que debe tomarse en la region_targets lista. Valores posibles: include o exclude. Valor predeterminado:exclude
dma_targets	matriz de objetos	Los identificadores de las áreas de mercado designadas que se excluirán o incluirán en un perfil, según lo definido por el dma_action campo. Puede utilizar el servicio de área de mercado designada para recuperar una lista de identificadores de DMA.
dma_action	enumeración	Acción que debe tomarse en la dma_targets lista. Valores posibles: incluir o excluir. Valor predeterminado:exclude
city_targets	matriz de objetos	Los identificadores de ciudades que se incluirán o excluirán en un perfil, según se definen en el city_action campo. Puede usar el Servicio de Ciudad para recuperar una lista de identificadores de ciudad. Para obtener más detalles y formato, consulta Objetivos de la ciudad a continuación. Requerido en:POST/PUT, cuando city_action es include.
city_action	enumeración	Acción que debe tomarse en la city_targets lista. Valores posibles: include o exclude. Valor predeterminado:exclude
domain_targets	matriz de objetos	Lista de dominios que se incluirán o excluirán en un perfil, tal como se define en el domain_action campo. En cuanto al formato, vea el ejemplo siguiente.
domain_action	enumeración	Acción que debe tomarse en la domain_targets lista. Para obtener más información sobre los dominios, consulte la lista Crear un dominio o una aplicación en la documentación. Valores posibles: include o exclude. Valor predeterminado:exclude
domain_list_targets	matriz de objetos	Los identificadores de las listas de dominios que se van a incluir o excluir en un perfil, según se define en el domain_list_action campo. Puede usar el servicio de lista de dominios para recuperar identificadores de lista de dominios. Consulte el ejemplo siguiente para ver el formato. Nota: No puede usar más de 100 listas de dominios en un único perfil.
domain_list_action	enumeración	Acción que debe tomarse en la domain_list_targets lista. Para obtener más información sobre los dominios, consulte Trabajo con listas de segmentación en la documentación. Valores posibles: include o exclude. Valor predeterminado:exclude
platform_placement_targets	matriz de objetos	RTB o el inventario de otras redes que puedas segmentar. Puedes usar los servicios de inventario revendido o de informes para buscar ubicaciones en la plataforma.
size_targets	matriz de objetos	Lista de tamaños aptos para ser incluidos en el perfil. Los tamaños se encuentran en objetos de tamaño de matriz, cada objeto contiene el ancho y el alto de cada tamaño de destino. Consulte el ejemplo siguiente. Nota: Cuando se activa el roadblocking en una línea de pedido garantizada, este valor se combina con los tamaños creativos de la línea de pedido y de la campaña para elaborar previsiones. El tamaño con el número previsto de impresiones más bajo se devolverá como la capacidad prevista.
seller_member_group_targets	matriz de objetos	Los grupos de miembros vendedores que se excluirán o incluirán en un perfil. Para apuntar al suministro directo de Xandr, consulte el formato a continuación.
member_targets	matriz de objetos	Los ID de miembro del vendedor se excluirán o incluirán en un perfil. El formato específico se puede encontrar en el ejemplo de la parte inferior de la página.
member_default_action	enumeración	En desuso. Valor predeterminado:null
video_targets	objeto	Id. de destino de vídeo que se incluirán en un perfil. Para conocer el formato específico, consulta Segmentos de vídeo a continuación.
engagement_rate_targets	matriz de objetos	Apunte a un inventario específico de alto rendimiento en función del rendimiento histórico. Para obtener más información, consulta Objetivos de la tasa de participación más abajo. Valor predeterminado:null
publisher_targets	matriz de objetos	Identificadores de editor administrados o directos para excluirlos o incluirlos en un perfil.
site_targets	matriz de objetos	Los id. de los sitios que se van a excluir o incluir en un perfil. Excluir o Incluir se hereda del publisher_targets campo. Valor predeterminado: Si no proporciona la acción con site_targets, la acción se usará de NULL forma predeterminada y profile.inventory_action se usará.
placement_targets	matriz de objetos	Los identificadores de ubicación que se excluirán o incluirán en un perfil. Excluir o Incluir se hereda del publisher_targets campo. Valor predeterminado: Si no proporciona acción con placement_targets, la acción tendrá como valor predeterminado NULL y profile.inventory_action se usará.
inventory_action	enumeración	Acción que se realizará en , inventory_targetspublisher_targets, site_targets, y la placement_targets lista. Valores posibles: include o exclude. Si la acción es include, se incluirá cualquier editor, sitio o ubicación de destino. Valor predeterminado:exclude
content_category_targets	Objeto con cadena y matriz	Las categorías de contenido a las que se dirigirá este perfil, así como si se deben permitir categorías desconocidas. Para obtener más detalles y formato, consulta Segmentos de categoría de contenido a continuación. Para recuperar identificadores de categorías de contenido, use el servicio de categoría de contenido.
deal_targets	matriz de objetos	Id. de oferta a los que se dirigirá este perfil. Un acuerdo es un acuerdo entre un vendedor y un comprador que puede proporcionar al comprador precios preferenciales, acceso a inventario exclusivo, competencia reducida en el inventario u otras oportunidades. Para obtener más detalles y formato, consulte los objetivos de acuerdos a continuación. Para obtener más información sobre cómo afectan el valor de este campo y del deal_action_include campo a los resultados de segmentación, vea Resultados de segmentación para deal_action_include campos AND deal_targets más abajo.
deal_list_targets	matriz de objetos	Los ID de lista de ofertas a las que se dirigirá este perfil. Consulte el ejemplo siguiente. Los identificadores de la lista de ofertas se pueden obtener mediante el servicio de lista de ofertas.
platform_publisher_targets	matriz de objetos	Identificadores de editores externos que se excluirán o incluirán en un perfil. Para obtener una lista de identificadores, el servicio de reventa de inventario.
platform_content_category_targets	matriz de objetos	Lista de categorías de contenido revendido en red para segmentar para este perfil. Para obtener una lista de identificadores, consulte el Servicio de reventa de inventario.
use_inventory_attribute_targets	Booleano	Si true, el perfil permitirá el inventario que tenga los atributos confidenciales incluidos en inventory_attribute_targets. Valor predeterminado:false
trust	enumeración	Indica el nivel de auditoría que debe cumplir el inventario para ser elegible. Valores posibles: appnexus o "seller". Si este campo se establece en "appnexus", el allow_unaudited campo debe establecerse en false. Valor predeterminado:seller
allow_unaudited	Booleano	Si true, este perfil permitirá que el inventario no auditado pase la selección de destino. Si el trust campo está establecido en appnexus, debe establecerse en false. Nota: - Esta configuración anula la configuración de confianza del vendedor en el inventory_trust objeto del Servicio al Miembro. - Para los artículos de línea de compra garantizada programática, allow_unaudited debe establecerse en true. Valor predeterminado:false
session_freq_type	enumeración	Indica cómo se cuenta el número de impresiones que ve el usuario durante la sesión de exploración actual. Valores posibles: platform (en todos los editores de la sesión actual) o publisher (para el editor específico). Valor predeterminado:platform
inventory_attribute_targets	matriz de objetos	Identificadores de atributos de inventario a los que se dirigirá para este perfil. Puede utilizar el Servicio de atributos de inventario para recuperar una lista de identificadores.
intended_audience_targets	matriz de cadenas	Los públicos previstos. Valores posibles: general, children, young_adulto mature. Nota: Solo puedes elegir incluir (no excluir) los objetivos de público previstos. Vea el ejemplo. Nota: Para usar la segmentación de público prevista, default_trust under inventory_trust (un atributo debajo del miembro) debe establecerse en seller. Sin esta configuración, no se aplicará la segmentación de público deseada.
language_targets	matriz de objetos	Los identificadores de los idiomas del explorador que se van a incluir o excluir en el perfil, tal como se define en el language_action campo. Puede usar el Servicio de idiomas para recuperar identificadores de idioma.
language_action	enumeración	Acción a tomar en language_targets. Valores posibles: include o exclude. Valor predeterminado:exclude
querystring_targets	matriz de objetos	La cadena de consulta se dirige al include perfil o exclude en el mismo, tal como se define en el querystring_action campo.
querystring_action	enumeración	Acción a tomar en el querystring_targets. Valores posibles: include o exclude. Valor predeterminado:exclude
querystring_boolean_operator	enumeración	Lógica booleana que se aplicará al querystring_targetsarchivo . Valores posibles: and o or. Valor predeterminado:and
postal_code_targets	matriz de objetos	Identificadores de código postal a los que se va a dirigir. Vea el ejemplo. Los identificadores se pueden obtener mediante el servicio de código postal.
postal_code_list_targets	matriz de objetos	Los identificadores de lista de códigos postales a los que se dirigirá. Vea el ejemplo. Los identificadores se pueden obtener mediante el Servicio de lista de códigos postales.
postal_code_action_include	booleano	Si se deben incluir los códigos postales definidos en postal_code_targets, las listas de códigos postales definidas en postal_code_list_targets en su segmentación y los distritos políticos definidos en political_district_targets. Valor predeterminado:true
zip_targets	matriz de objetos	Obsoleto. Úselo postal_code_targets en su lugar.
supply_type_targets	matriz de cadenas	Los tipos de suministro que se incluirán o excluirán de la segmentación, tal y como se define en el supply_type_action campo. Valores posibles: web, mobile_web y mobile_app. Nota: La facebook_sidebar opción ha quedado obsoleta.
supply_type_action	enumeración	Los tipos de suministro son web, mobile_web, y mobile_app. Valores posibles: include o exclude. Si se establece este campo en include, solo se segmentará el inventario de tipos incluidos en supply_type_targets . Si exclude, solo se segmentará el inventario que no está ( supply_type_targets excepto facebook_sidebar, que ha quedado en desuso). Valor predeterminado:exclude
user_group_targets	objeto	Cada usuario se asigna aleatoriamente a 1 de cada 100 grupos de usuarios, ningún grupo tiene ninguna ventaja sobre otro. Puedes usar este campo para dirigirte a un rango específico de estos grupos de usuarios. Además, puede usar el include_cookieless_users campo para incluir o excluir usuarios sin cookies. Para dar formato, vea el ejemplo Ver un perfil a continuación. Nota: El servicio de patrones de grupo de usuarios puede ayudarle a calcular los segmentos del grupo de usuarios. El uso más común para los segmentos de grupos de usuarios es la definición de grupos de usuarios para las pruebas A/B de las estrategias de segmentación de campañas. Así es como funciona: establezca destinos de grupo de usuarios de prueba en un perfil y controle los destinos de grupo de usuarios en otro. A continuación, se aplica la etiqueta de grupo de usuarios a cada campaña afectada, usando la etiqueta para identificar el grupo de usuarios como prueba o control (ver el labels campo en el Servicio de campaña). A continuación, ejecute el informe Análisis de red, Análisis de anunciantes de red o Análisis de anunciantes agrupado para user_group_for_campaign clasificar el rendimiento de las campañas por grupo de usuarios.
position_targets	objeto	Las posiciones de pliegue a destino. Para obtener más detalles, consulta Objetivos de posición a continuación.
browser_targets	matriz de objetos	Los identificadores de los exploradores que se incluirán o excluirán de la segmentación, tal como se define en el browser_action campo. Puede usar el servicio de explorador para recuperar una lista de identificadores de explorador. Para obtener el formato, consulte el ejemplo siguiente.
browser_action	enumeración	Acción a tomar en el browser_targets. Valores posibles: include o exclude. Valor predeterminado:exclude
location_target_latitude	double	La latitud de la ubicación del usuario. Debe estar entre -90 y 90, con hasta 6 decimales, donde sur es negativo y norte es positivo. Un perfil se puede dirigir a una ubicación específica cuando los datos GPS están disponibles desde un dispositivo móvil. Cuando se establece la segmentación de latitud y longitud, los usuarios solo se segmentarán dentro del área definida por el centro (location_target_latitude, location_target_longitude) y el radio location_target_radius. Los usuarios no se dirigirán cuando los datos GPS no estén disponibles para la impresión.
location_target_longitude	double	La longitud de la ubicación del usuario. Debe estar entre -180 y 180, con hasta 6 decimales, donde oeste es negativo y este es positivo. Un perfil se puede dirigir a una ubicación específica cuando los datos GPS están disponibles desde un dispositivo móvil. Cuando se establece la segmentación de latitud y longitud, los usuarios solo se segmentarán dentro del área definida por el centro (location_target_latitude, location_target_longitude) y el radio location_target_radius. Los usuarios no se dirigirán cuando los datos GPS no estén disponibles para la impresión.
location_target_radius	Longitud entera en metros	Para más información, vea location_target_latitude.
device_model_targets	matriz de objetos	Los modelos de dispositivos móviles (es decir, iPhone) que se van a incluir o excluir de la segmentación, según se define en el device_model_action campo. Para obtener una lista completa de los modelos de dispositivos registrados en nuestro sistema, use el Servicio de modelos de dispositivos de solo lectura. Para obtener más detalles y formato, consulta Segmentos de modelos de dispositivos a continuación.
device_model_action	enumeración	Acción a tomar en device_model_targets. Valores posibles: include o exclude. Valor predeterminado:exclude
device_type_targets	matriz de cadenas	Los tipos de dispositivos que puedes incluir o excluir de tu segmentación, tal y como se define en el device_type_action campo. Posibles valores: - phone - tablet - pc - tv - gameconsole - stb - mediaplayer Para el formato, consulta Segmentos de tipo de dispositivo a continuación.
device_type_action	enumeración	Acción a tomar en device_type_targets. Valores posibles: include o exclude. Valor predeterminado:exclude
carrier_targets	matriz de objetos	Los operadores de telefonía móvil que se incluirán o excluirán de la segmentación, tal y como se define en el carrier_action campo. Para obtener una lista completa de los operadores de telefonía móvil registrados en nuestro sistema, utiliza el Servicio de operador de solo lectura. Para obtener más detalles y formato, consulta Carrier Targets a continuación.
carrier_action	enumeración	Acción a tomar en el carrier_targets. Valores posibles: include o exclude. Valor predeterminado:exclude
inventory_url_list_targets	matriz de objetos	Contiene una lista de identificadores de lista de inventario (listas de permitidos o listas de bloqueados). Se usa para adjuntar una sola lista de permitidos o una o más listas de bloqueo al perfil. - La lista de permitidos contiene una lista de dominios o aplicaciones a los que se dirigirá la línea de pedido que usa el perfil. Si se incluye una lista de permitidos, no se segmentarán los dominios y aplicaciones que no estén en la lista de permitidos. - Cada lista de bloqueo contiene una lista de dominios o aplicaciones que se deben excluir de la segmentación por línea de pedido que utiliza el perfil. Para obtener más información, consulta Listas de inventario a continuación.
operating_system_family_targets	matriz de objetos	Los sistemas operativos en su conjunto (por ejemplo, Android, Apple iOS, Windows 7, etc.) que se van a incluir o excluir de la segmentación, según se define en el operating_system_family_action campo. Nota: Este campo se usa para todas las versiones de sistemas operativos, mientras que operating_system_extended_targets se usa para versiones específicas de sistemas operativos. Para obtener más detalles y formato, consulte Destinos de familia del sistema operativo más abajo.
operating_system_family_action	enumeración	Acción a tomar en operating_system_family_targets. Valores posibles: include o exclude. Valor predeterminado:exclude
use_operating_system_extended_targeting	Booleano	Solo lectura. Si true, se respetará el operating_system_extended_targets campo. De forma predeterminada, los perfiles más recientes tendrán este campo establecido en true. Sin embargo, los perfiles más antiguos (y los perfiles "más recientes" creados al duplicarlos) tendrán este campo establecido de false forma predeterminada. No hay ninguna manera de actualizar un perfil anterior (o sus duplicados) para establecer este campo en true. Si quieres agregar la segmentación ampliada del SO a estos perfiles antiguos (o a sus duplicados), debes crear un nuevo perfil y agregar la configuración de segmentación al nuevo perfil. Valor predeterminado:true
operating_system_extended_targets	matriz de objetos	La lista de sistemas operativos específicos que se incluirán o excluirán de la segmentación. Nota: Esta matriz se usa para dirigirse a versiones específicas del sistema operativo, mientras que operating_system_family_targets se usa para dirigirse a todas las versiones de sistemas operativos. Para obtener más detalles y formato, consulte Destinos extendidos del sistema operativo a continuación. Nota: Este campo se respetará solo si use_operating_system_extended_targeting es true.
operating_system_action	enumeración	Obsoleto. Úselo operating_system_extended_targets en su lugar. Valor predeterminado:exclude
operating_system_targets	matriz de objetos	Obsoleto. Úselo operating_system_extended_targets en su lugar.
mobile_app_instance_targets	matriz de objetos	Una lista de instancias de aplicación móvil que le gustaría incluir o excluir de la segmentación. Para obtener definiciones de campo, consulte Destinos de instancia de aplicaciones móviles a continuación. Para obtener más información acerca de qué son las instancias de aplicaciones móviles y cómo funcionan, consulte el servicio de instancia de aplicaciones móviles.
mobile_app_instance_action_include	Booleano	Si se deben incluir las instancias de aplicación móvil definidas en mobile_app_instance_targets en la segmentación de la campaña. Valor predeterminado:false
mobile_app_instance_list_targets	matriz de objetos	Esta lista contiene listas de instancias de aplicaciones móviles (en otras palabras, es una lista de listas). Para obtener definiciones de campo, consulte Destinos de lista de instancias de aplicaciones móviles a continuación. Para obtener más información sobre las listas de instancias de aplicaciones móviles y cómo funcionan, consulte el Servicio de listas de instancias de aplicaciones móviles.
mobile_app_instance_list_action_include	Booleano	Si se deben incluir las listas de instancias de aplicaciones móviles definidas en mobile_app_instance_list_targets la segmentación de la campaña. Valor predeterminado:false
deal_action_include	Booleano	Si se incluyen o excluyen los tratos definidos en deal_targets y las listas de acuerdos definidas en deal_list_targets la segmentación de campañas o líneas de pedido. Cuando se establece en true, se incluirán ofertas y listas de ofertas. Nota: Para segmentar o excluir tratos y listas de tratos, además de establecer este campo en true o false, también debes: - Proporcione una lista de ofertas y listas de ofertas para incluir o excluir en la deal_targets matriz and deal_list_targets . Una lista vacía tendría como destino ningún trato/lista de tratos (si deal_action_include está configurado en true) o como objetivo todos los tratos/listas de tratos (si deal_action_include está configurado en false). - (Solo cuando se usan ALI) Establezca el campo dentro true de la supply_strategiesdeals matriz del servicio de línea de pedido. Para obtener más información sobre cómo afectan el valor de este campo y del campo a los deal_targets resultados de segmentación, vea Resultados de segmentación para deal_action_include campos AND deal_targets . Valor predeterminado:true
ip_range_list_targets	matriz de objetos	Una lista de intervalos de direcciones IP que se incluirán o excluirán de la segmentación de la campaña. Para obtener más información, consulte Destinos de listas de rangos IP a continuación, así como la documentación del servicio de listas de rangos IP.
key_value_targets	matriz de objetos	Una lista de destinos de clave/valor personalizados. Para obtener más información y ejemplos, consulta Destinos de valor clave más abajo.
ad_slot_position_action_include	Booleano	Intención de segmentar espacios específicos en un pod de anuncios. Ten en cuenta que puedes segmentar espacios publicitarios o bumpers de anuncios, pero no ambos. Valor predeterminado:false
ad_slot_position_targets	Array of ints	Las posiciones del espacio publicitario en las que un comprador quiere servir. -1 representa la última posición, 0 representa la primera. De forma predeterminada, cuando ad_slot_position_action_include se establece en false, una matriz vacía significa que se puede gastar en cualquier posición. Establézcala ad_slot_position_action_include en true primero si quiere usar ad_slot_position_targets para especificar las posiciones a las que se dirigirá. Valor predeterminado:empty row
ad_slot_intro_bumper_action_include	Booleano	Esto controla si la creatividad se orientará a las posiciones de introducción de vídeo para las subastas de vídeo VAST. El valor predeterminado es true. Para asegurarse de que su creatividad no se dirige a la posición de intro adpod, establezca este campo en false. Nota: Puedes segmentar espacios publicitarios o bumpers de anuncios, pero no ambos. Valor predeterminado:true
ad_slot_outro_bumper_action_include	Booleano	Esto controla si la creatividad se dirigirá a las posiciones de outro de vídeo para las subastas de vídeo VAST. El valor predeterminado es true. Para asegurarse de que su creatividad no apunte a la posición de adpod de outro, establezca este campo en false. Nota: Puedes segmentar espacios publicitarios o bumpers de anuncios, pero no ambos. Valor predeterminado:true
screen_size_action	string	En desuso. Valor predeterminado:exclude
screen_size_targets	matriz de objetos	En desuso.
optimization_zone_action	string	No se admite actualmente. Valor predeterminado:exclude
optimization_zone_targets	matriz de objetos	No se admite actualmente.
created_on	marca de tiempo	Solo lectura. La fecha y hora en que se creó el perfil.
is_expired	Booleano	Solo lectura. Si true, el objeto asociado al perfil ha expirado. Este parámetro solo se admite para fines internos. Valor predeterminado:false
inventory_network_resold_targets	matriz de objetos	En desuso.
exelate_targets	matriz de objetos	En desuso.
inventory_url_allowlist_settings	objeto	Este objeto contiene campos que se usan para determinar cómo se aplican las listas de permitidos a la compra de artículos de línea. Los usuarios de Curate pueden asegurarse de que las listas de permitidos no estén habilitadas para los acuerdos de vendedor si los acuerdos de vendedor & Open Exchange se seleccionan como estrategias de suministro para garantizar que las listas de permitidos se apliquen específicamente al exchange abierto. Consulte Configuración de la lista de permitidos de URL de inventario.
ads_txt_authorized_only	Booleano	Cuando true, la línea de pedido solo segmentará el inventario web de vendedores autorizados de dominios que tengan un archivo ads.txt. Nota: El ads_txt_authorized_only parámetro de segmentación solo se aplica al inventario abierto de Exchange. No afecta a la segmentación del inventario de ofertas. Tampoco se aplica al inventario de aplicaciones (ya que el sector aún no ha adoptado el uso de un ads.txt archivo para el inventario de aplicaciones). Para obtener más información, consulta Ads.txt Preguntas frecuentes para compradores. Valor predeterminado:false
political_district_targets	matriz de objetos	Identificadores de distrito político a los que se va a dirigir. Vea el ejemplo. Los identificadores se pueden obtener mediante el Servicio de distrito político.
ad_type_targets	matriz	Matriz de objetos, incluidos los identificadores que representan diferentes tipos de medios. Consulte la estructura en el ejemplo a continuación. 1 = banner 2 = vídeo 3 = nativo 4 = audio

dma_targets ejemplo

{
   "dma_targets":[
      {
         "dma":612
      },
      {
         "dma":622
      }
   ]
}

domain_targets ejemplo

{
   "domain_targets":[
      {
         "profile_id":128350561,
         "domain":"telenet.be"
      },
      {
         "profile_id":99898705,
         "domain":"cnn.us"
      }
   ]
}

size_targets ejemplo

{
   "size_targets":[
      {
         "width":190,
         "height":213
      },
      {
         "width":728,
         "height":90
      }
   ]
}

seller_member_group_targets de datos

{
   "seller_member_group_targets":[
      {
         "id":1,
         "action_include":"true/false"
      }
   ]
}

deal_list_targets ejemplo

{
   "profile":{
      "id":1367515,
      "deal_list_targets":[
         {
            "id":"0101"
         },
         {
            "id":"0102"
         }
      ]
   }
}

intended_audience_targets ejemplo

{
   "intended_audience_targets":[
      "children",
      "general"
   ]
}

postal_code_targets ejemplo

{
   "profile":{
      "id":1367515,
      "postal_code_targets":[
         {
            "id":"00135"
         },
         {
            "id":"00136"
         }
      ]
   }
}

postal_code_list_targets ejemplo

{
   "profile":{
      "id":1367515,
      "postal_code_list_targets":[
         {
            "id":"0099"
         },
         {
            "id":"0100"
         }
      ]
   }
}

political_district_targets ejemplo

{
   "profile":{
      "id":130465799,
      "political_district_targets":[
         {
            "id":"139897"
         }
      ]
   }
}

ad_type_targets ejemplo

{
    "profile": {
        "ad_type_targets": [
            {
                "id": 1
            },
            {
                "id": 2
            }
        ]
    }
}

Resultados de destino para deal_action_include campos Y deal_targets

Los siguientes resultados de segmentación se producen para estos valores de los deal_action_include campos AND deal_targets :

deal_action_include	deal_targets	Resultado de la segmentación
true	null	Objetivo de no ofertas
false	null	Segmentar todas las ofertas
true	Contiene objetivos de oferta	Incluye estas ofertas en la segmentación
false	Contiene objetivos de oferta	Excluye estas ofertas en la segmentación

Destinos de instancia de aplicación móvil

Para obtener más información sobre las instancias de aplicaciones móviles, incluidas las instrucciones para agregarlas a su perfil, consulte el Servicio de instancia de aplicaciones móviles.

Campo	Tipo	Descripción
id	Entero	El identificador único de la instancia de la aplicación móvil.
bundle_id	string	El identificador de agrupación de esta instancia de la aplicación móvil.
os_family_id	Entero	El identificador de familia del sistema operativo asociado a esta instancia de la aplicación móvil.

Objetivos de listas de instancias de aplicaciones móviles

Para obtener más información sobre las listas de instancias de aplicaciones móviles, incluidas las instrucciones sobre cómo agregarlas a su perfil, consulte el servicio de lista de instancias de aplicaciones móviles.

Campo	Tipo	Descripción
id	Entero	El identificador único de la lista de instancias de la aplicación móvil.
name	string	El nombre de esta lista de instancias de aplicación móvil.
description	string	Una descripción opcional del propósito o contenido de la lista.

Segmentos de parte diurna

Cada objeto de la daypart_targets matriz incluye los siguientes campos. Para dar formato, vea el ejemplo Ver un perfil a continuación.

Campo	Tipo	Descripción
day	enumeración	El día de la semana. Valores posibles: sunday, monday, tuesday, wednesdaythursday, fridaysaturday, , o all. Nota: Estas cadenas deben estar en minúsculas.
start_hour	Entero	La hora de inicio de la franja horaria. Debe ser un entero entre 0 y .23 La campaña comenzará a servir al comienzo de la hora (6 equivale a "6:00" am).
end_hour	Entero	La hora final de la franja horaria. Debe ser un entero entre 0 y .23 La campaña dejará de servir al final de la hora (23 es equivalente a "23:59").

Segmentar segmentos

La lógica booleana se define entre segmentos con segment_boolean_operator un campo fuera de la matriz. Si segment_boolean_operator es AND, el perfil solo se dirigirá a los usuarios que satisfagan todos los destinos de segmento. Si es segment_boolean_operatorOR, el perfil se dirigirá a los usuarios que satisfagan cualquiera de los segmentos especificados. Para obtener instrucciones detalladas sobre la lógica booleana para la segmentación de segmentos, consulte Segmentar segmentos.

Campo	Tipo	Descripción
id	Entero	El identificador del segmento. Requerido en:POST
code	string	El código personalizado del segmento.
action	enumeración	Valores posibles: include o exclude. Valor predeterminado:include
start_minutes	Entero	El límite inferior para la cantidad de tiempo desde que se agregó un usuario al segmento. Valor predeterminado:0
expire_minutes	Entero	El límite superior para la cantidad de tiempo desde que se agregó un usuario al segmento. Valor predeterminado:-1
other_equals	Entero	El valor del segmento exacto al que se va a dirigir. Nota: Si usa other_in_list, no puede usar este campo. Valor predeterminado:null
other_less	Entero	El límite superior no inclusivo para la segmentación de valores de segmento. Valor predeterminado:null
other_greater	Entero	El límite inferior no inclusivo para la segmentación de valor de segmento. Valor predeterminado:null
other_in_list	matriz	La lista de valores de segmento a destino. Si usa other_equals, no puede usar este campo. Valor predeterminado:null

Nota:

Para other_equals, other_less, other_greater, y other_in_list, el valor de segmento puede ser un "otro" valor pasado por el píxel de segmento o puede estar relacionado con valores de cadena de consulta de segmento (consulte el "querystring_mapped" campo en el Servicio de segmentos). Para obtener ejemplos de cómo dirigir los valores de cadena de consulta en un segmento, vea otros ejemplos a continuación.

En la segmentación por segmentos, debes mantener la coherencia con la configuración de la lógica booleana; de lo contrario, no podrás editar los segmentos en la interfaz de usuario de Microsoft Invest. Para una configuración lógica booleana coherente, debe asegurarse de que:

• segment_boolean_operator se establece como "and" o "or".
• El boolean_operator campo de cada objeto de la matriz de segment_group_targets (Consulte Segmentos de grupo de destino) se establece como "and" o "or". Sin embargo, este valor debería ser el opuesto al establecido anteriormente segment_boolean_operator . Por ejemplo, si el valor establecido en segment_boolean_operator es "or", el valor de boolean_operator para los objetos debe ser "and".
• El valor del campo para todos los objetos de la matriz de boolean_operator segment_group_targets debe ser el mismo. En resumen, no puede tener boolean_operator de un objeto como "and" y otro como "or" en el mismo perfil. Para obtener un ejemplo de JSON coherentes e incoherentes, consulte a continuación.

JSON coherentes

{
   "segment_boolean_operator":"and",
   "segment_group_targets":[
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"1094797",
               "deleted":false,
               "expire_minutes":null,
               "id":19285936,
               "name":"Travel Intender",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3119772",
               "deleted":false,
               "expire_minutes":null,
               "id":19378950,
               "name":"XAS - US HH Demographic - Online Shopping - Travel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"6502105",
               "deleted":false,
               "expire_minutes":null,
               "id":19378951,
               "name":"XAS - US HH Demographic - Online Shopping - Electronics and Gadgets",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3734388",
               "deleted":false,
               "expire_minutes":null,
               "id":19378952,
               "name":"XAS - US HH Demographic - Online Shopping - Apparel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"2137013",
               "deleted":false,
               "expire_minutes":null,
               "id":19378954,
               "name":"XAS - US HH Demographic - Online Shopping - Buy Online",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2272811",
               "deleted":false,
               "expire_minutes":null,
               "id":19378955,
               "name":"XAS - US HH Demographic - Online Shopping - Personal Health",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"4608982",
               "deleted":false,
               "expire_minutes":null,
               "id":21015599,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Attorneys",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2420395",
               "deleted":false,
               "expire_minutes":null,
               "id":21015602,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Accountants/CPA",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      }
   ]
}

JSON incoherentes

{
   "segment_boolean_operator":"and",
   "segment_group_targets":[
      {
         "boolean_operator":[
            "and",
            "- - same as segment_boolean_operator + also all other boolean_operators in the rest of the object is set to",
            "or",
            "therefore this is inconsistent behavior"
         ],
         "segments":[
            {
               "action":"include",
               "code":"1094797",
               "deleted":false,
               "expire_minutes":null,
               "id":19285936,
               "name":"Travel Intender",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3119772",
               "deleted":false,
               "expire_minutes":null,
               "id":19378950,
               "name":"XAS - US HH Demographic - Online Shopping - Travel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"6502105",
               "deleted":false,
               "expire_minutes":null,
               "id":19378951,
               "name":"XAS - US HH Demographic - Online Shopping - Electronics and Gadgets",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"3734388",
               "deleted":false,
               "expire_minutes":null,
               "id":19378952,
               "name":"XAS - US HH Demographic - Online Shopping - Apparel",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"2137013",
               "deleted":false,
               "expire_minutes":null,
               "id":19378954,
               "name":"XAS - US HH Demographic - Online Shopping - Buy Online",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2272811",
               "deleted":false,
               "expire_minutes":null,
               "id":19378955,
               "name":"XAS - US HH Demographic - Online Shopping - Personal Health",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      },
      {
         "boolean_operator":"or",
         "segments":[
            {
               "action":"include",
               "code":"8578372",
               "deleted":false,
               "expire_minutes":null,
               "id":19378957,
               "name":"XAS - US HH Demographic - Online Shopping - Shoes",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"4608982",
               "deleted":false,
               "expire_minutes":null,
               "id":21015599,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Attorneys",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            },
            {
               "action":"include",
               "code":"2420395",
               "deleted":false,
               "expire_minutes":null,
               "id":21015602,
               "name":"Xandr Audiences - Demographic - Occupation - Detail - Accountants/CPA",
               "other_equals":null,
               "other_greater":null,
               "other_in_list":null,
               "other_less":null,
               "start_minutes":null
            }
         ]
      }
   ]
}

Ejemplo de segmentos de segmentación

En este ejemplo, dado que es AND, segment_boolean_operator el perfil se dirigirá solo a los usuarios que se ajusten tanto al segmento 86 como al segmento 202.

{
   "profile":{
      "segment_boolean_operator":"and",
      "segment_targets":[
         {
            "id":86,
            "code":null,
            "name":"Network segment 1",
            "action":"include",
            "start_minutes":0,
            "expire_minutes":-1,
            "other_less":null,
            "other_greater":null,
            "other_equals":null
         },
         {
            "id":202,
            "code":null,
            "name":"Credit Score segment",
            "action":"include",
            "start_minutes":0,
            "expire_minutes":-1,
            "other_less":null,
            "other_greater":null,
            "other_equals":null
         }
      ]
   }
}

Segmentos de grupos de segmentos

Cada objeto de grupo de segmentos contiene los siguientes campos.

Nota:

Usted define la lógica booleana entre grupos con el segment_boolean_operator campo fuera de la matriz y define la lógica booleana entre segmentos de un grupo con el boolean_operator campo dentro del objeto de grupo. Consulta el ejemplo siguiente para ver el formato y un ejemplo de la lógica de la combinación segment_boolean_operator de y boolean_operator. Para obtener instrucciones detalladas sobre la lógica booleana para la segmentación de segmentos, consulte Segmentar segmentos.

No se pueden agregar segmentos nulos.

No puede agregar null segmentos a esta matriz mediante POST o PUT.

Campo	Tipo	Descripción
boolean_operator	enumeración	La lógica booleana entre segmentos de un grupo de segmentos. Valores posibles: and o or. El valor de campo para todos los objetos de boolean_operator la segment_group_targets matriz debe ser el mismo. En resumen, no se puede tener boolean_operator de un objeto como "and" y otro como "or" en el mismo perfil. Valor predeterminado:or Necesario:POST
id	Entero	El identificador del segmento. Necesario:POST
code	string	El código personalizado del segmento.
action	enumeración	Valores posibles: include o exclude. Valor predeterminado:include
start_minutes	Entero	El límite inferior para la cantidad de tiempo desde que se agregó un usuario al segmento. Valor predeterminado:0
expire_minutes	Entero	El límite superior para la cantidad de tiempo desde que se agregó un usuario al segmento. Valor predeterminado:-1
other_equals	string	El valor del segmento exacto al que se va a dirigir. Nota: Si usa other_in_list, no puede usar este campo. Valor predeterminado:null
other_less	Entero	El límite superior no inclusivo para la segmentación de valores de segmento. Valor predeterminado:null
other_greater	Entero	El límite inferior no inclusivo para la segmentación de valor de segmento. Valor predeterminado:null
other_in_list	matriz	La lista de valores de segmento a destino. Nota: Si usa other_equals, no puede usar este campo. Valor predeterminado:null

Nota:

Para other_equals, other_less, other_greater, y other_in_list, el valor de segmento puede ser un "other" valor pasado por el píxel de segmento o puede estar relacionado con valores de cadena de consulta de segmento (consulte el campo en el "querystring_mapped"Servicio de segmentos). Para obtener ejemplos de cómo dirigir los valores de cadena de consulta en un segmento, vea otros ejemplos a continuación.

Ejemplo de segmentos de segmentación

En este ejemplo, dado que el segment_boolean_operator es OR y el para cada grupo es AND, el perfil se dirigirá solo a los usuarios que se ajusten tanto en el segmento 11 como en el boolean_operator segmento 22 o en ambos segmentos 33 y 44.

{
   "profile":{
      "segment_boolean_operator":"or",
      "segment_group_targets":[
         {
            "boolean_operator":"and",
            "segments":[
               {
                  "id":11,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               },
               {
                  "id":22,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               }
            ]
         },
         {
            "boolean_operator":"and",
            "segments":[
               {
                  "id":33,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               },
               {
                  "id":44,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":null,
                  "other_less":null,
                  "other_greater":null
               }
            ]
         }
      ]
   }
}

Objetivos de edad

Campo	Tipo	Descripción
allow_unknown	Booleano	Determina si se incluirán segmentos en los que no se conozca la edad. Valor predeterminado:false
ages	matriz de objetos	Los intervalos de edad a los que se dirige este perfil.

ages objeto

Campo	Tipo	Descripción
low	Entero	El límite inferior del rango de edad (mínimo 13).
high	Entero	El límite superior del rango de edad (máximo 100).

Ejemplo de segmentos por edad

{
   "profile":{
      "age_targets":{
         "allow_unknown":false,
         "ages":[
            {
               "low":20,
               "high":35
            }
         ]
      }
   }
}            
            

Objetivos de género

El gender_targets objeto contiene los siguientes campos.

Campo	Tipo	Descripción
gender	enumeración	El sexo del usuario. Valores posibles: m (hombre) o f (mujer). Valor predeterminado:null Requerido en:POST
allow_unknown	Booleano	Si true, el anuncio de destino llama cuando el género del usuario no está disponible. Valor predeterminado:false

Objetivos de país

Cada objeto de la country_targets matriz contiene los siguientes campos.

Campo	Tipo	Descripción
id	Entero	El Id. del país. Puede usar el Servicio de país para obtener una lista completa de identificadores de país.
name	string	Solo lectura. El nombre del país.
code	string	Solo lectura. El código del país.

Ejemplo de segmentación por país

{
   "profile":{
      "country_action":"include",
      "country_targets":[
         {
            "id":233,
            "name":"United States",
            "code":"US"
         }
      ]
   }
}           
            

Destinos de región

Cada objeto de la region_targets matriz contiene los siguientes campos.

Campo	Tipo	Descripción
id	Entero	El identificador de la región. Puede usar el servicio de región para recuperar una lista de identificadores de región.
name	string	Solo lectura. El nombre de la región.
code	string	Solo lectura. El código de la región.
country_name	string	Solo lectura. Nombre del país al que pertenece la región.
country_code	string	Solo lectura. El código del país al que pertenece la región.

Ejemplo de segmentos por región

{
   "profile":{
      "region_action":"include",
      "region_targets":[
         {
            "id":3950,
            "name":"New York",
            "code":"NY",
            "country_name":"United States",
            "country_code":"US"
         }
      ]
   }
}            
            

Cadena de marco de requerir transparencia y consentimiento

Campo	Tipo	Descripción
require_transparency_and_consent_framework_string	booleano	- Si true, solo permite que los objetos asociados compren inventario cuando haya una cadena TCF válida - Si false, permite que los objetos asociados compren cualquier inventario que se encuentre dentro de las declaraciones de segmentación predefinidas.

Nota:

Este parámetro solo es aplicable al tráfico procedente de territorios en los que se aplica el RGPD.

Ejemplo

{
   "profile":{
      "require_transparency_and_consent_framework_string":"false"
   }
}            
            

Objetivos de la ciudad

Cada objeto de la city_targets matriz contiene los siguientes campos.

Campo	Tipo	Descripción
id	Entero	El identificador de la ciudad de destino. Puede usar el Servicio de Ciudad para recuperar una lista de identificadores de ciudad.
name	Entero	Solo lectura. El nombre de la ciudad a la que se va a dirigir.
region_name	string	Solo lectura. Nombre de la región a la que pertenece la ciudad.
region_code	string	Solo lectura. El código de la región a la que pertenece la ciudad.
country_name	enumeración	Solo lectura. Nombre del país al que pertenece la región.
country_code	enumeración	Solo lectura. El código del país al que pertenece la región.

Ejemplo de destinos urbanos

{
   "profile":{
      "city_action":"include",
      "city_targets":[
         {
            "id":200942,
            "name":"Portland",
            "region_name":"Oregon",
            "region_code":"OR",
            "country_code":"US",
            "country_name":"United States"
         }
      ]
   }
}            
            

Listas de inventario

Cada objeto de la inventory_url_list_targets matriz incluye los siguientes campos.

Campo	Tipo	Descripción
deleted	Booleano	Solo lectura. Indica si se ha eliminado la lista de inventario.
id	Entero	El identificador de la lista de permitidos o de la lista de bloqueados que se va a aplicar. - La lista de permitidos contiene una lista de dominios y aplicaciones a los que se dirigirá el elemento de línea que usa el perfil. - Cada lista de bloqueo contiene una lista de dominios y aplicaciones que se excluirán de la segmentación por la línea de pedido que utiliza el perfil. Requerido en:POST, PUT
list_type	string	Solo lectura. Denota si la lista es una lista de bloqueados o una lista de permitidos. Los valores válidos son allowlist or blocklist. Nota: El servicio de perfiles no usa el list_type campo (usado por el servicio de lista de inventario) para determinar si una lista de inventario está excluida (blocklist) en la segmentación o incluida ().allowlist Para excluir o incluir una lista de inventario en la segmentación, consulte exclude el campo de esta tabla.
name	string	Solo lectura. Nombre de la lista de permitidos o de la lista de bloqueados.
exclude	Booleano	Solo lectura. Si true, la lista de inventario se excluirá de la selección de destino (es decir, se tratará como una lista de bloqueo). Si false, la lista de inventario se incluirá en la segmentación (es decir, se tratará como una lista de permitidos). Este campo depende únicamente del campo de inventario list_type descrito anteriormente.

Ejemplo de listas de inventario

{
   "profile":{
      "id":145,
      "inventory_url_list_targets":[
         {
            "deleted":false,
            "id":51,
            "list_type":"blocklist",
            "name":"Blocklist to exclude medical sites",
            "exclude":true
         },
         {
            "deleted":false,
            "id":53,
            "list_type":"blocklist",
            "name":"Blocklist to exclude military sites",
            "exclude":true
         },
         {
            "deleted":false,
            "id":54,
            "list_type":"blocklist",
            "name":"Line Item - Blocklist - 2017-08-23T21:44:42Z",
            "exclude":true
         },
         {
            "deleted":false,
            "id":66,
            "list_type":"allowlist",
            "name":"Test Allowlist for Targeting",
            "exclude":false
         }
      ]
   }
}            
            

Segmentos de categoría de contenido

El content_category_targets objeto incluye el allow_unknown campo, que es un valor booleano, y la content_category matriz. Cada objeto de la content_category matriz contiene los siguientes campos.

Campo	Tipo	Descripción
id	Entero	El identificador de la categoría de contenido a la que se va a dirigir. Valor predeterminado:null Requerido en:POST
action	núm.	La acción que se debe realizar para esta categoría de contenido. Valores posibles: include o exclude. Si include, entonces la categoría será la dirigida; si exclude, la categoría explícitamente no será la dirigida. Valor predeterminado:exclude

Ejemplo de segmentos de categoría de contenido

{
   "profile":{
      "content_category_targets":{
         "allow_unknown":false,
         "content_categories":[
            {
               "id":3,
               "action":"include"
            }
         ]
      }
   }
}            
            

Segmentos de vídeo

El video_targets objeto contiene los allow_unknown_playback_methodcampos , allow_unknown_context, allow_unknown_player_size y las matrices, , contextsplayback_methodsplayer_sizes . Para Deals, también contiene el deal_creative_duration campo y las video_frameworks matrices.

Campo	Tipo	Descripción
allow_unknown_playback_method	Booleano	Use este campo para dirigirse a los inventarios en los que se desconoce el método de reproducción. Establézcalo en true cuando use los campos de la playback_method matriz para dirigirse a métodos de reproducción específicos Y cuando desee incluir inventario para el que no se ha proporcionado información sobre el método de reproducción. Si no segmentas métodos de reproducción específicos, este campo no tendrá ningún efecto en la segmentación. Valor predeterminado:false
allow_unknown_context	Booleano	Use este campo para dirigirse a un inventario en el que se desconozca el contexto. Establezca este campo cuando true use los campos de la contexts matriz para dirigirse a contextos específicos Y cuando desee incluir inventario para el que no se ha proporcionado información de contexto. Si no segmentas contextos específicos, este campo no tendrá ningún efecto en la segmentación. Valor predeterminado:false
allow_unknown_player_size	Booleano	Usa este campo para segmentar el inventario en el que se desconozca el tamaño del jugador. Establezca este campo cuando true use los campos de la matriz para dirigirse a tamaños de jugadores específicos Y cuando desee incluir inventario para el player_sizes que no se ha proporcionado información sobre el tamaño del jugador. Si no segmentas por tamaños de jugadores específicos, este campo no tendrá ningún efecto en la segmentación. Valor predeterminado:false

Nota:

• Cuando NO establezcas ninguna opción específica de segmentación por vídeo, segmentarás todo el inventario, incluido el inventario no definido.
• Asegúrate de haber elegido incluir o excluir las creatividades de introducción y cierre estableciéndolas en los ad_slot_intro_bumper_action_include campos y ad_slot_outro_bumper_action_include .

Contextos

El valor predeterminado es una matriz vacía y se dirigirá a cualquier posición de balanceo. La contexts matriz contiene objetos con los siguientes campos:

Campo	Tipo	Descripción
id	Entero	Id. del contexto. Posibles valores: - 1: position-pre-roll - 2: posición-balanceo medio - 3: posición-post-rollo - 4: en el artículo - 5: en el banner - 6: en la fuente - 7: intersticial - 8: acacompañing-content-pre-roll - 9: acompañando-contenido-mid-roll - 10: acompañando-contenido-post-roll
name	string	Solo lectura. Valores posibles: pre-roll, mid-roll, post-rollo in-article.

Métodos de reproducción

El valor predeterminado es una matriz vacía y se destinará a cualquier método de reproducción. La playback_methods matriz contiene los siguientes campos:

Campo	Tipo	Descripción
id	Entero	Id. del método de reproducción. Posibles valores: - 1: playback-method-auto-play-sound-on - 2: playback-method-auto-play-sound-off - 3: playback-method-click-to-play - 4: playback-method-mouse-over - 5: playback-method-auto-play-sound-unknown
name	string	Solo lectura. Valores posibles: auto_play_sound_on, auto_play_sound_off, click_to_playmouse_over, o auto_play_sound_unknown.

Tamaños de reproductor

El valor predeterminado es una matriz vacía y se destinará a cualquier tamaño de jugador. La player_sizes matriz contiene objetos con los siguientes campos:

Campo	Tipo	Descripción
id	Entero	El identificador del tamaño del reproductor. Posibles valores: - 1: player-size-sm - 2: player-size-med - 3: player-size-lg
name	string	Solo lectura. Valores posibles: small, mediumo large.
min_width	Entero	Solo lectura. El ancho mínimo del reproductor, en píxeles.
max_width	Entero	Solo lectura. El ancho máximo del reproductor, en píxeles.

Duración de la creatividad

La deal_creative_duration configuración solo la utilizan las líneas de pedido de ofertas de vídeo. Permite que los acuerdos se dirijan a impresiones que permitan al menos una duración creativa determinada, por lo que los creativos de la longitud definida pueden cumplir con éxito un trato sin errores. Agregará solo las impresiones con la configuración ya implementada.

Campo	Tipo	Descripción
deal_creative_duration	Entero	La duración del vídeo creativo en segundos.

Marcos de trabajo de vídeo

La video_frameworks matriz solo la utilizan las líneas de pedido de ofertas de vídeo. Permite que los acuerdos se dirijan a impresiones que permitan un marco de vídeo determinado (por ejemplo, VPAID) para que los creativos de este tipo puedan cumplir con éxito un acuerdo sin errores. Esta configuración no invalidará la configuración de ubicación existente; Agregará solo las impresiones con la configuración dada ya implementada.

Campo	Tipo	Descripción
id	Entero	El identificador del marco de vídeo. Los identificadores incluyen: - VPAID 1.0 - VPAID 2.0 - MRAID-1 - ORMMA - MRAID-2
name	string	El nombre del marco de vídeo. Posibles valores: - vpaid_1_0 - vpaid_2_0 - mraid_1 - ormma - mraid_2

Ejemplo de marcos de vídeo

{
   "profile":{
      "video_targets":{
         "allow_unknown_playback_method":true,
         "allow_unknown_context":true,
         "allow_unknown_player_size":true,
         "contexts":[
            {
               "id":1,
               "name":"pre-roll"
            },
            {
               "id":2,
               "name":"mid-roll"
            },
            {
               "id":4,
               "name":"in-article"
            }
         ],
         "playback_methods":[
            {
               "id":2,
               "name":"auto_play_sound_off"
            },
            {
               "id":3,
               "name":"click_to_play"
            }
         ],
         "player_sizes":[
            {
               "id":1,
               "name":"small",
               "min_width":0,
               "max_width":300
            }
         ],
         "deal_creative_duration":60,
         "video_frameworks":[
            {
               "id":1,
               "name":"vpaid_1_0"
            },
            {
               "id":2,
               "name":"vpaid_2_0"
            }
         ]
      }
   }
}            
            

Objetivos de tasa de participación

La engagement_rate_targets matriz de objetos se usa para dirigirse a un inventario específico de alto rendimiento en función del rendimiento histórico. Puede usar criterios de segmentación para comprar inventario de vídeo con una alta tasa de finalización o un inventario altamente visible, especificando la tasa de finalización de vídeo o la tasa de visibilidad deseadas.

Campo	Tipo	Descripción
engagement_rate_type	enumeración	Los criterios de segmentación. Posibles valores: - 1: video_completion - Tasa de finalización de videos. Predicción de la probabilidad de que una impresión de vídeo se reproduzca por completo (vídeo completo/impresiones totales). - 2: view - Tasa de visibilidad IAB prevista (anteriormente conocida como "Tasa de visualización IAB estimada"). Predicción de la probabilidad de que una impresión de visualización web sea visible (impresiones vistas/medidas), según el estándar de la IAB. - 3: view_over_total - Tasa de visibilidad IAB prevista sobre el total. Predicción de la probabilidad de que una impresión de visualización web sea visible (impresiones vistas/impresiones totales), según el estándar de la IAB. - 4: predicted_iab_video_view_rate - Tasa de visualización de vídeo IAB prevista. Predicción de la probabilidad de que una impresión de vídeo web sea visible (impresiones vistas/medidas), según el estándar de la IAB. - 5: predicted_iab_video_view_rate_over_total - Tasa de visualización de vídeo IAB prevista sobre el total Predicción de la probabilidad de que una impresión de vídeo web sea visible (impresiones vistas/totales), según el estándar de la IAB. - 6: predicted_100pv50pd_video_view_rate - Tasa de visualización de vídeo prevista (100% de visualización, 50% de duración, sonido activado). Predicción de la probabilidad de que una impresión de vídeo web sea visible (impresiones vistas/medidas), según este estándar personalizado (100 % visible, 50 % de duración, sonido activado). - 7: predicted_100pv50pd_video_view_rate_over_total - Tasa de visualización de video prevista sobre el total (100% de vista, 50% de duración, sonido activado). Predicción de la probabilidad de que una impresión de vídeo web sea visible (impresiones vistas/impresiones totales), según este estándar personalizado (100 % visible, 50 % de duración, sonido activado). - 8: predicted_100pv1s_display_view_rate - Tasa de visibilidad prevista (100% de visualización). Predicción de la probabilidad de que una impresión de visualización web sea visible (impresiones vistas/medidas), según este estándar personalizado (100 % visible, 1 segundo). - 9: predicted_100pv1s_display_view_rate_over_total - Tasa de visibilidad prevista sobre el total (100% de visualización). Predicción de la probabilidad de que una impresión de visualización web sea visible (impresiones vistas/totales), según este estándar personalizado (100 % visible, 1 segundo).
engagement_rate_pct	Entero	Valores posibles: 1 - 100.

Objetivos de ofertas

Cada objeto de la deal_targets matriz contiene los siguientes campos.

Nota:

Para segmentar o excluir tratos, además de establecer los campos dentro de esta matriz según sea necesario, también debe:

• Establezca el campo en true o false (dependiendo de la deal_action_include inclusión o exclusión).
• Al usar ALI, establezca el campo dentro true de la dealssupply_strategies matriz del servicio de línea de pedido.
• Las líneas de pedido de compra garantizadas programáticas solo pueden tener un destino de oferta en la deal_targets matriz.

Campo	Tipo	Descripción
id	Entero	El identificador de la oferta. Para recuperar los ID de sus ofertas, utilice el Servicio de acceso de compradores de ofertas.
name	string	Solo lectura. El nombre del trato.
code	string	Solo lectura. El código personalizado de la oferta. Para acuerdos con socios de suministro externos, esta es generalmente la cadena que usará para identificar el trato.

Ejemplo de objetivos de oferta

{
   "profile":{
      "deal_targets":[
         {
            "id":44,
            "name":"Deal with external supply partner",
            "code":"APN-1234-2200f"
         },
         {
            "id":45,
            "name":"Deal with UI seller",
            "code":null
         }
      ]
   }
}            
            

Colocar segmentos

El position_targets objeto contiene los siguientes campos.

Campo	Tipo	Descripción
allow_unknown	Booleano	Si true, el perfil se dirigirá a ubicaciones para las que se desconoce la posición de plegado. Valor predeterminado:false
positions	matriz de objetos	Las posiciones de pliegue a destino. Valores posibles: "above" o "below".

Ejemplo de objetivos de posición

{
   "profile":{
      "position_targets":{
         "allow_unknown":false,
         "positions":[
            {
               "position":"above"
            }
         ]
      }
   }
}            
            

Destinos de modelos de dispositivos

Cada objeto de la device_model_targets matriz contiene los siguientes campos.

Sugerencia

Para recuperar los identificadores de los modelos de dispositivo registrados en nuestro sistema, use el Servicio de modelo de dispositivo.

Campo	Tipo	Descripción
id	Entero	El id. del modelo de dispositivo.
name	string	Solo lectura. El nombre del modelo de dispositivo, es decir, Onetab XST2, , PAD7, A101etc.

Ejemplo de destinos de modelos de dispositivos

{
   "profile":{
      "device_model_action":"include",
      "device_model_targets":[
         {
            "id":1,
            "name":"Onetab XST2"
         },
         {
            "id":2,
            "name":"PAD7"
         },
         {
            "id":3,
            "name":"A101"
         }
      ]
   }
}            
            

Destino de tipo de dispositivo

La device_type_targets matriz puede contener una o varias de las cadenas siguientes:

• phone
• tablet
• pc
• tv
• gameconsole
• stb
• mediaplayer

Ejemplo de destinos de tipo de dispositivo

{
   "profile":{
      "device_type_action":"include",
      "device_type_targets":[
         "phone",
         "tablet"
      ]
   }
}            
            

Destinos de transportistas

Cada objeto de la carrier_targets matriz contiene los siguientes campos.

Nota:

• Para recuperar los ID de los operadores de telefonía móvil registrados en nuestro sistema, utilice el Servicio de operador.

• La capacidad de segmentar por operador hace referencia al hecho de que puedes dirigirte a los dispositivos que usan actualmente la red de ese operador. No puede dirigirse a los suscriptores de la red.

  Por ejemplo, un iPhone de Verizon que usa una red 4G puede ser dirigido como Verizon cuando está en 4G, pero no cuando el usuario está conectado a su wifi doméstico.

Campo	Tipo	Descripción
id	Entero	El id. del operador de telefonía móvil.
name	string	Solo lectura. El nombre del operador de telefonía móvil.
country	enumeración	Solo lectura. El código ISO del país en el que opera el operador.

Ejemplo de destinos de transportistas

{
   "profile":{
      "carrier_action":"include",
      "carrier_targets":[
         {
            "id":14,
            "name":"Verizon - US",
            "country":"US"
         },
         {
            "id":26,
            "name":"Sprint - US",
            "country":"US"
         },
         {
            "id":32,
            "name":"Orange - US",
            "country":"US"
         }
      ]
   }
}            
            

Objetivos de la lista de intervalos IP

Para obtener más información sobre las listas de intervalos IP, consulte el servicio de listas de intervalos IP.

Por perfil, puede seleccionar como destino hasta 10 "include" listas de intervalos IP (include establecida true en la lista de intervalos IP) y no más de 1 "exclude" lista de intervalos IP (include establecida false en la lista de intervalos IP). Los intervalos IP excluidos deben ser un subconjunto de los intervalos IP incluidos.

Campo	Tipo	Descripción
id	Entero	El identificador único de esta lista de intervalos IP.
name	string	Solo lectura. El nombre de esta lista de intervalos IP.
include	Booleano	Solo lectura. Si se incluyen o excluyen los intervalos IP en la lista de intervalos IP. Esto se define en la propia lista de intervalos IP, no en el perfil
description	string	Solo lectura. Una descripción opcional del propósito o contenido de la lista.

Destinos extendidos del sistema operativo

La operating_system_extended_targets matriz especifica las versiones del sistema operativo (por ejemplo, Android 3.x, Apple iOS 6, etc.) que se incluirán o excluirán de la segmentación.

Nota:

operating_system_extended_targets array se usa para dirigirse a versiones específicas del sistema operativo, mientras que operating_system_family_targets se usa para dirigirse a todas las versiones de sistemas operativos.

• Los destinos de familia del sistema operativo y los destinos extendidos del sistema operativo funcionan juntos

  La familia del sistema operativo y los destinos extendidos del sistema operativo son más eficaces cuando se usan juntos. Para obtener ejemplos de cómo usar sus capacidades de segmentación combinadas, consulta el ejemplo Usar juntos los destinos de familia del sistema operativo y los destinos extendidos del sistema operativo a continuación.

• Para usar operating_system_extended_targets, debe establecer use_operating_system_extended_targeting en true. Una vez que se crea un perfil mediante el operating_system_extended_targets, no se le permitirá establecer use_operating_system_extended_targetingfalse o rellenar los operating_system_targets campos en PUT.

Cada objeto de la operating_system_extended_targets matriz contiene los siguientes campos.

Campo	Tipo	Descripción
id	Entero	El Id. de la versión del sistema operativo. Para recuperar los identificadores de las versiones del sistema operativo registradas en nuestro sistema, utilice el servicio extendido del sistema operativo.
name	string	Solo lectura. El nombre de la versión del sistema operativo, por ejemplo, Android 3.x, , Apple iOS 5etc.
action	enumeración	Acción a tomar en id. Valores posibles: include o exclude.

Ejemplo de destinos extendidos del sistema operativo

{
   "profile":{
      "use_operating_system_extended_targeting":true,
      "operating_system_extended_targets":[
         {
            "id":2,
            "name":"Android 2.1",
            "action":"exclude"
         },
         {
            "id":3,
            "name":"Android 2.2",
            "action":"include"
         }
      ]
   }
}
            

Destinos de familia del sistema operativo

La operating_system_family_targets matriz especifica los sistemas operativos en su conjunto (por ejemplo, Android, Apple, iOS, Windows 7, Windows 11, etc.) que se incluirán o excluirán de la segmentación, según se define en el operating_system_family_action campo.

Nota:

operating_system_family_action se usa para dirigirse a todas las versiones de sistemas operativos, mientras que operating_system_targets se usa para seleccionar versiones específicas de sistemas operativos.

Los destinos de familia del sistema operativo y los destinos extendidos del sistema operativo funcionan juntos

La familia del sistema operativo y los destinos extendidos del sistema operativo son más eficaces cuando se usan juntos. Para obtener ejemplos de cómo usar sus capacidades de segmentación combinadas, consulta el ejemplo Usar juntos los destinos de familia del sistema operativo y los destinos extendidos del sistema operativo a continuación.

Cada objeto de la operating_system_family_targets matriz contiene los siguientes campos.

Campo	Tipo	Descripción
id	Entero	El identificador de la familia del sistema operativo. Para recuperar los identificadores de las familias de sistemas operativos registradas en nuestro sistema, utilice el servicio de familia de sistemas operativos.
name	string	Solo lectura. El nombre de la familia del sistema operativo, es decir, Microsoft Windows, , Android, Apple iOSetc.

Ejemplo de destinos de familia de sistemas operativos

{
   "profile":{
      "operating_system_family_action":"exclude",
      "operating_system_family_targets":[
         {
            "id":2,
            "name":"Android"
         },
         {
            "id":3,
            "name":"Apple iOS"
         }
      ]
   }
}            
            

Destinos de valor clave

El key_value_targets campo define la combinación de claves y valores personalizados de destino en este perfil. El campo es una versión analizada de una expresión lógica.

Encontrará más información sobre cómo funciona la segmentación de valores clave y detalles sobre cómo analizar expresiones para el servicio de perfiles en Custom Key Value Targeting.

key_value_targets objeto

Campo	Tipo	Descripción
kv_expression	objeto	Se trata de un objeto contenedor que contiene todos los objetos de destino de clave/valor, incluidos los header objetos and exp .

Campo	Tipo	Descripción
header	objeto	Información de control de versiones usada para evaluar la expresión.
exp	objeto	La expresión regular que define la combinación de clave o valor.

header objeto

Campo	Tipo	Valor	Descripción
an_version	string	1.0	La versión del motor back-end que evalúa la expresión. Current version is 1.0. Este campo es obligatorio en PUT y POST.
client_version	string	1.0	La versión de la implementación orientada al cliente de la expresión (el formato que se muestra en el ejemplo siguiente). Current version is 1.0. Este campo es obligatorio en PUT y POST.

exp objeto

Campo	Tipo	Descripción
typ	string	Los operadores usados en la expresión. Los valores posibles son: - and - or - not - in - eq (igual que) - gt (mayor que) - lt (menor que) - gte (mayor o igual que) - lte (menor o igual que) - neq (distinto de) Los operadores and, or, y not solo se pueden usar con subexpresiones. Los operadores gt, lt, gte y lte solo se pueden usar con valores numéricos. Todos los operadores deben estar en minúsculas.
sbe	objeto exp	Objeto que contiene la subexpresión (los elementos de la expresión).
key	string	El nombre de la clave de segmentación.
vtp	type	Este campo identifica el tipo de datos del valor de expresión. El valor que especifique en este campo debe coincidir con el campo y el tipo del campo de valor correspondiente. Los siguientes valores son válidos: - num: numérico; Se debe proporcionar un valor en el vnm campo. - str: cadena; Se debe proporcionar un valor en el vst campo. - nma: matriz numérica; Se debe proporcionar un valor en el vna campo. - sta: matriz de cadenas; Se debe proporcionar un valor en el vsa campo.
vnm	valor numérico	El valor como un valor flotante con signo de 32 bits (por ejemplo, 25,3). Los números pueden tener hasta 13 dígitos (con un máximo de seis dígitos a la derecha del separador decimal).
vst	string	El valor como una cadena.
vna	Matriz de valores numéricos	Conjunto de valores como una matriz de flotantes.
vsa	matriz de cadenas	Conjunto de valores como una matriz de cadenas.

Ejemplo de destinos de valor clave

{
   "profile":{
      "key_value_targets":{
         "kv_expression":{
            "header":{
               "an_version":"1.0",
               "client_version":"1.0"
            },
            "exp":{
               "typ":"and",
               "sbe":[
                  {
                     "exp":{
                        "typ":"eq",
                        "key":"fruit",
                        "vtp":"str",
                        "vst":"apple"
                     }
                  },
                  {
                     "exp":{
                        "typ":"eq",
                        "key":"city",
                        "vtp":"str",
                        "vst":"NY"
                     }
                  }
               ]
            }
         }
      }
   }
}            
            

Configuración de la lista de permitidos de URL de inventario

Los campos de este objeto se usan para establecer cómo se aplicarán las listas de permitidos adjuntas a un elemento de línea. Todas las listas de permitidos se aplicarán a la compra de RTB de forma predeterminada. Además, puede optar por aplicar las listas de permitidos a las compras administradas.

Campo	Tipo	Descripción
apply_to_managed	booleano	Designa si la lista de permitidos se aplicará a las compras administradas. Si se establece en true, las listas de permitidos asociadas a la línea de pedido se aplicarán a las compras administradas. Nota: Establezca este campo en true si el elemento de línea asociado a este perfil tiene su inventory_type campo establecido en direct. Valor predeterminado:false
apply_to_rtb	booleano	Solo lectura. Todas las listas de permitidos asociadas a la línea de pedido se aplicarán a la compra de RTB. Valor predeterminado:false

Ejemplo de configuración de la lista de permitidos de URL de inventario

{
   "inventory_url_allowlist_settings":{
      "apply_to_managed":true,
      "apply_to_rtb":true
   }
}            
            

Ejemplos

Ver un perfil

Este es un ejemplo de un servicio de perfiles.

Nota:

En aras de la demostración, este perfil tiene una estrategia de orientación poco realista.

$ curl -b cookies -c cookies 'https://api.appnexus.com/profile?id=439&advertiser_id=8&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "start_element":0,
      "num_elements":100,
      "profile":{
         "id":37291837,
         "code":null,
         "description":null,
         "country_action":"include",
         "region_action":"exclude",
         "city_action":"exclude",
         "browser_action":"exclude",
         "ads_txt_authorized_only":false,
         "use_inventory_attribute_targets":true,
         "last_modified":"2015-07-17 20:01:56",
         "daypart_timezone":null,
         "dma_action":"exclude",
         "domain_action":"exclude",
         "domain_list_action":"include",
         "inventory_action":"exclude",
         "language_action":"include",
         "segment_boolean_operator":"or",
         "min_session_imps":null,
         "session_freq_type":"platform",
         "carrier_action":"exclude",
         "supply_type_action":"exclude",
         "device_type_action":"exclude",
         "screen_size_action":"exclude",
         "device_model_action":"exclude",
         "location_target_radius":null,
         "location_target_latitude":null,
         "location_target_longitude":null,
         "querystring_action":"exclude",
         "querystring_boolean_operator":"and",
         "is_expired":false,
         "non_audited_url_action":"include",
         "daypart_bitmap":"000000000000000000000000111111111111111111111000111111111111111111111000111111111111111111111000111111111111111111111000111111111111111111111000000000000000000000000000",
         "optimization_zone_action":"exclude",
         "advertiser_id":16401,
         "publisher_id":null,
         "max_session_imps":null,
         "max_day_imps":null,
         "max_lifetime_imps":100,
         "max_page_imps":null,
         "min_minutes_per_imp":30,
         "venue_action":"exclude",
         "operating_system_action":"exclude",
         "require_cookie_for_freq_cap":true,
         "trust":"seller",
         "allow_unaudited":false,
         "is_template":false,
         "created_on":"2015-07-17 20:01:56",
         "operating_system_family_action":"exclude",
         "use_operating_system_extended_targeting":true,
         "mobile_app_instance_action_include":false,
         "mobile_app_instance_list_action_include":true,
         "user_group_targets":{
            "include_cookieless_users":false,
            "groups":[
               {
                  "low":0,
                  "high":49
               }
            ]
         },
         "country_targets":[
            {
               "id":233,
               "name":"United States",
               "code":"US"
            }
         ],
         "region_targets":[
            {
               "id":3950,
               "name":"New York",
               "code":"NY",
               "country_name":"United States",
               "country_code":"US"
            }
         ],
         "city_targets":null,
         "inv_class_targets":null,
         "inventory_attribute_targets":[
            {
               "id":2,
               "name":"Political",
               "deleted":false
            },
            {
               "id":4,
               "name":"Social media",
               "deleted":false
            },
            {
               "id":6,
               "name":"Photo and video sharing",
               "deleted":false
            },
            {
               "id":8,
               "name":"Forums (moderated)",
               "deleted":false
            },
            {
               "id":10,
               "name":"Forums (unmoderated)",
               "deleted":false
            },
            {
               "id":12,
               "name":"Incentivized clicks",
               "deleted":false
            },
            {
               "id":14,
               "name":"Non-english languages",
               "deleted":false
            },
            {
               "id":16,
               "name":"Streaming media",
               "deleted":false
            },
            {
               "id":17,
               "name":"Toolbars, plugins, or extensions",
               "deleted":false
            },
            {
               "id":29,
               "name":"Contextual Nudity",
               "deleted":false
            }
         ],
         "age_targets":{
            "allow_unknown":false,
            "ages":[
               {
                  "low":18,
                  "high":24
               },
               {
                  "low":25,
                  "high":34
               },
               {
                  "low":35,
                  "high":44
               }
            ]
         },
         "daypart_targets":[
            {
               "day":"monday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"tuesday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"wednesday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"thursday",
               "start_hour":0,
               "end_hour":20
            },
            {
               "day":"friday",
               "start_hour":0,
               "end_hour":20
            }
         ],
         "browser_targets":[
            {
               "id":4,
               "name":"Internet Explorer (other versions)",
               "deleted":false
            },
            {
               "id":11,
               "name":"Opera (all versions)",
               "deleted":false
            }
         ],
         "dma_targets":null,
         "domain_targets":[
            {
               "profile_id":37291837,
               "domain":"test.com"
            }
         ],
         "domain_list_targets":[
            {
               "id":3905,
               "name":"Test Domain List 1",
               "description":"",
               "type":"white",
               "deleted":false
            }
         ],
         "language_targets":[
            {
               "id":1,
               "name":"English",
               "code":"EN",
               "deleted":false
            }
         ],
         "size_targets":null,
         "zip_targets":null,
         "member_targets":[
            {
               "id":1185,
               "action":"include",
               "third_party_auditor_id":null,
               "billing_name":"AppNexus Demo"
            }
         ],
         "video_targets":null,
         "segment_group_targets":[
            {
               "boolean_operator":"and",
               "segments":[
                  {
                     "id":465381,
                     "action":"include",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  },
                  {
                     "id":465382,
                     "action":"include",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  }
               ]
            },
            {
               "boolean_operator":"and",
               "segments":[
                  {
                     "id":514839,
                     "action":"exclude",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  },
                  {
                     "id":523129,
                     "action":"include",
                     "start_minutes":null,
                     "expire_minutes":null,
                     "other_less":null,
                     "other_greater":null,
                     "other_equals":null,
                     "code":null,
                     "name":null,
                     "deleted":false,
                     "other_in_list":null
                  }
               ]
            }
         ],
         "carrier_targets":null,
         "supply_type_targets":null,
         "device_type_targets":null,
         "screen_size_targets":null,
         "device_model_targets":null,
         "querystring_targets":null,
         "gender_targets":null,
         "intended_audience_targets":[
            "general",
            "children",
            "young_adult"
         ],
         "inventory_network_resold_targets":null,
         "operating_system_targets":null,
         "operating_system_family_targets":[
            {
               "id":6,
               "name":"BlackBerry OS"
            },
            {
               "id":8,
               "name":"Linux"
            }
         ],
         "position_targets":{
            "allow_unknown":true,
            "positions":null
         },
         "site_targets":null,
         "venue_targets":null,
         "operating_system_extended_targets":null,
         "mobile_app_instance_targets":null,
         "mobile_app_instance_list_targets":[
            {
               "id":3,
               "name":"Mopub iOS Apps 1-100",
               "description":"",
               "deleted":false
            }
         ],
         "optimization_zone_targets":null,
         "content_category_targets":{
            "allow_unknown":false,
            "content_categories":[
               {
                  "id":7,
                  "action":"exclude",
                  "name":"Beauty and Personal Care",
                  "is_system":true,
                  "deleted":false
               },
               {
                  "id":10,
                  "action":"include",
                  "name":"Arts and Entertainment",
                  "is_system":true,
                  "deleted":false
               },
               {
                  "id":20344,
                  "action":"exclude",
                  "name":"",
                  "is_system":false,
                  "deleted":false
               },
               {
                  "id":22224,
                  "action":"include",
                  "name":"",
                  "is_system":false,
                  "deleted":false
               }
            ]
         },
         "deal_targets":null,
         "placement_targets":null,
         "platform_content_category_targets":null,
         "platform_placement_targets":null,
         "platform_publisher_targets":[
            {
               "id":500070,
               "action":"exclude",
               "name":"Mediaset",
               "deleted":false
            }
         ],
         "publisher_targets":null,
         "segment_targets":null,
         "exelate_targets":null,
         "ip_range_list_targets":null
      }
   }
}

Destino de un intervalo de valores de cadena de consulta

Escenario: Dos editores automáticos le indicaron que esperara "car year" datos en las cadenas de consulta de sus ubicaciones. El primero pasa el año con el "car_year" parámetro, y el segundo pasa el año con el "car_YYYY" parámetro. Para segmentar esta información en su campaña, ha agregado el "car_year" parámetro al segmento 25 y el "car_YYYY" parámetro al segmento 26. Ahora quiere actualizar el perfil de la campaña para segmentar ubicaciones que incluyan cualquiera de los parámetros cuando el parámetro supere cualquier año entre "car_year=2009" y , "car_year=2012"por lo que cree el siguiente JSON y realice una PUT llamada para actualizar el perfil.

$ cat profile_update

{
   "profile":{
      "segment_group_targets":[
         {
            "boolean_operator":"or",
            "segments":[
               {
                  "id":25,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_less":2012,
                  "other_greater":2009
               },
               {
                  "id":26,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_less":2012,
                  "other_greater":2009
               }
            ]
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api.appnexus.com/profile?id=9&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":9
   }
}

Destino de una lista de valores de cadena de consulta

Escenario: Un editor automático le indicó que esperara cualquiera de los siguientes pares clave-valor en las cadenas de consulta de sus ubicaciones: "car_make=ford", , "car_make=honda"o "car_make=toyota". Para orientar dicha información, agregó el parámetro y los valores al segmento 12. Ahora quiere actualizar el perfil de la campaña para orientarla a esos valores, por lo que crea el siguiente JSON y realiza una PUT llamada para actualizar el perfil.

$ cat profile_update

{
   "profile":{
      "segment_group_targets":[
         {
            "segments":[
               {
                  "id":12,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_in_list":[
                     "ford",
                     "honda",
                     "toyota"
                  ]
               }
            ]
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

Destino de un valor de cadena de consulta exacto

Escenario: Un editor automático le indicó que esperara los siguientes pares clave-valor en las cadenas de consulta de sus ubicaciones: car_color=red, , car_color=blueo car_color=black. Para orientar dicha información, agregó el parámetro y los valores al segmento 15. Ahora quiere actualizar el perfil de la campaña para que tenga como destino un valor de cadena de consulta específico, blackpor lo que cree el siguiente JSON y realice una PUT llamada para actualizar el perfil.

$ cat profile_update

{
   "profile":{
      "segment_group_targets":[
         {
            "segments":[
               {
                  "id":15,
                  "code":null,
                  "action":"include",
                  "start_minutes":0,
                  "expire_minutes":-1,
                  "other_equals":"black"
               }
            ]
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

Segmentar países específicos

Escenario: quiere dirigir su perfil a la Estados Unidos y Canadá. Esto requiere establecer country_action en include y country_targets en US y CA, por lo que crea el siguiente JSON y realiza una PUT llamada para actualizar el perfil.

$ cat profile_update

{
   "profile":{
      "country_action":"include",
      "country_targets":[
         {
            "id":233
         },
         {
            "id":39
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

Dirigirse a un estado específico pero excluir un DMA

Escenario: quiere dirigir su perfil al estado de Nueva York, excluyendo el área de la ciudad de Nueva York. Esto requiere establecer region_action en include, region_targets en US:NY, dma_action en exclude, y en 501, que dma_targets es el código DMA de la ciudad de Nueva York. Por lo tanto, crea el siguiente JSON y realiza una PUT llamada para actualizar el perfil.

$ cat profile_update

{
   "profile":{
      "region_action":"include",
      "region_targets":[
         {
            "id":1
         }
      ],
      "dma_action":"exclude",
      "dma_targets":[
         {
            "dma":501
         }
      ]
   }
}

$ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api..com/profile?id=10&advertiser_id=210&member_id=123'

{
   "response":{
      "status":"OK",
      "count":1,
      "id":10
   }
}

Segmentar una oferta

Escenario: Ha negociado un trato con un vendedor que le otorga acceso a un inventario que no está disponible para otros compradores (es decir, una subasta privada). Para aprovechar esta oferta, debe usar el Servicio de acceso al comprador de ofertas para encontrar el identificador de oferta y, a continuación, actualizar la matriz de su deal_targets perfil para dirigirse a ese identificador.

1. Para encontrar la identificación de su oferta, realice una GET llamada al Servicio de acceso de compradores de ofertas e identifique la oferta correcta. Alternativamente, si conoce la ID de miembro del vendedor, puede pasarla en la cadena de consulta para recuperar solo las ofertas que tiene con ese vendedor, como se muestra a continuación.

   $ curl -b cookies -c cookies 'https://api.appnexus.com/deal-buyer-access?seller_member_id=814'
   
   {
      "response":{
         "status":"OK",
         "count":1,
         "start_element":0,
         "num_elements":100,
         "deals":[
            {
               "id":65,
               "code":null,
               "name":"Private deal for buyer 1085 with floor of 2.5",
               "description":null,
               "active":true,
               "seller_member_id":814,
               "start_date":"2013-12-01 00:00:00",
               "end_date":"2013-12-31 23:59:59",
               "profile_id":null,
               "floor_price":2.5,
               "currency":"USD",
               "use_deal_floor":true,
               "last_modified":"2013-12-04 22:37:49",
               "buyer":{
                  "id":1085,
                  "bidder_id":2
               },
               "type":{
                  "id":2,
                  "name":"Private Auction"
               },
               "brands":[
                  {
                     "id":1
                  }
               ]
            }
         ]
      }
   }
   

2. A continuación, crea el archivo JSON con deal_targets el ID de la oferta.

   $ cat profile_update
   
   {
      "profile":{
         "deal_targets":[
            {
               "id":65
            }
         ]
      }
   }
   

3. Finalmente, realiza una PUT llamada para actualizar el perfil.

   $ curl -b cookies -c cookies -X PUT -d @profile_update 'https://api.appnexus.com/profile?id=22&advertiser_id=210&member_id=123'
   
   {
      "response":{
         "status":"OK",
         "count":1,
         "id":22
      }
   }
   

Usar juntos los destinos de familia del sistema operativo y los destinos extendidos del sistema operativo

Los destinos del sistema operativo extendido y de familia del sistema operativo funcionan en conjunto para permitir diferentes escenarios de selección de destino para familias de sistemas operativos específicas. Esta funcionalidad se representa mejor mediante ejemplos de uso. Esta sección contiene los siguientes ejemplos (desplácese hacia abajo o busque para verlos).

• Dirigirse a dispositivos iOS 7.0; todas las demás familias de sistemas operativos y otras versiones de iOS no servirán.
• Dirigirse a todos los dispositivos iOS, independientemente de la versión; todas las demás familias del sistema operativo no servirán.
• Dirigirse a todos los sistemas operativos que no sean Desconocido, Linux o Symbian.
• Dirigirse a todos los dispositivos Android, junto con iOS 7.0.
• Segmentar todos los dispositivos Android, iOS y Windows Mobile.
• Target Mac OS 10.8 (Mountain Lion) and MS Windows 8.0.
• Objetivo Mac OS X 10.8 (Mountain Lion) y todos los escritorios de Windows excepto XP y 2000.
• Dirígete a todos los sistemas operativos iOS excepto 2.0 y 2.1.
• Configuración no válida: no se puede incluir una familia de sistemas operativos ni excluir a sus miembros.
• Configuración no válida: no se pueden incluir ni excluir miembros de la misma familia del sistema operativo.
• Configuración no válida: no se pueden incluir miembros de una familia de sistemas operativos excluida.

Dirigirse a dispositivos iOS 7.0; todas las demás familias de sistemas operativos y otras versiones de iOS no servirán

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":{
         "id":80,
         "name":"iOS 7.0",
         "action":"include"
      }
   }
}            
            

Dirigirse a todos los dispositivos iOS, independientemente de la versión; todas las demás familias de SO no servirán

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         "id":3,
         "name":"Apple iOS"
      }
   },
   "operating_system_extended_targets":{
      
   }
}            
            

Dirigirse a todos los sistemas operativos que no sean Desconocido, Linux o Symbian

En otras palabras, sirve en cualquier dispositivo Android, iOS, MacOS, Windows, Blackberry o Windows Mobile.

{
   "profile":{
      "operating_system_family_action":"exclude",
      "operating_system_family_targets":[
         {
            "id":0,
            "name":"Unknown"
         },
         {
            "id":8,
            "name":"Linux"
         },
         {
            "id":9,
            "name":"Symbian OS"
         }
      ]
   }
}            
            

Segmentar todos los dispositivos Android, junto con iOS 7.0

Todas las demás versiones de iOS no servirán y todos los dispositivos que no sean Android no servirán.

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         "id":2,
         "name":"Android"
      }
   },
   "operating_system_extended_targets":[
      {
         "id":80,
         "name":"iOS 7.0",
         "action":"include"
      }
   ]
}            
            

Segmentar todos los dispositivos Android, iOS y Windows Mobile

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":2,
            "name":"Android"
         },
         {
            "id":3,
            "name":"Apple iOS"
         },
         {
            "id":7,
            "name":"Microsoft Mobile"
         }
      ],
      "operating_system_extended_targets":{
         
      }
   }
}            
            

Target Mac OS 10.8 (Mountain Lion) y MS Windows 8.0

En este ejemplo se combinan destinos extendidos del sistema operativo de diferentes familias de sistemas operativos.

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":[
         {
            "id":81,
            "name":"10.8 Mountain Lion",
            "action":"include"
         },
         {
            "id":93,
            "name":"Windows 8",
            "action":"include"
         }
      ]
   }
}            
            

Destino: Mac OS X 10.8 (Mountain Lion) y todos los escritorios de Windows excepto XP y 2000

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":[
         {
            "id":80,
            "name":"10.8 Mountain Lion",
            "action":"include"
         },
         {
            "id":89,
            "name":"Windows 2000",
            "action":"exclude"
         },
         {
            "id":90,
            "name":"Windows XP",
            "action":"exclude"
         }
      ]
   }
}            
            

Segmentar todos los sistemas operativos iOS excepto 2.0 y 2.1

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":3,
            "name":"Apple iOS"
         }
      ],
      "operating_system_extended_targets":[
         {
            "id":47,
            "action":"include",
            "name":"iOS 2.0"
         },
         {
            "id":48,
            "action":"include",
            "name":"iOS 2.1"
         }
      ]
   }
}            
            

Las siguientes configuraciones de segmentación de perfiles no son válidas y pueden dar lugar a un comportamiento inesperado.

Configuración no válida: no se puede incluir una familia de sistemas operativos ni excluir a sus miembros

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":3,
            "name":"Apple iOS"
         }
      ],
      "operating_system_extended_targets":[
         {
            "id":47,
            "action":"include",
            "name":"iOS 2.0"
         },
         {
            "id":48,
            "action":"include",
            "name":"iOS 2.1"
         }
      ]
   }
}            
            

Configuración no válida: no se puede incluir ni excluir miembros de la misma familia del sistema operativo

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":{
         
      },
      "operating_system_extended_targets":[
         {
            "id":47,
            "name":"iOS 2.0",
            "action":"include"
         },
         {
            "id":48,
            "name":"iOS 2.1",
            "action":"exclude"
         }
      ]
   }
}            
            

Configuración no válida: no se pueden incluir miembros de una familia de sistemas operativos excluida

{
   "profile":{
      "operating_system_family_action":"include",
      "operating_system_family_targets":[
         {
            "id":3,
            "name":"Apple iOS"
         }
      ],
      "operating_system_extended_targets":[
         {
            "id":47,
            "action":"include",
            "name":"iOS 2.0"
         },
         {
            "id":48,
            "action":"include",
            "name":"iOS 2.1"
         }
      ]
   }
}            
            

Segmentar posiciones de pod de anuncios

Segmentar posiciones específicas de espacios publicitarios (última, primera, tercera)

{
   "profile":{
      "ad_slot_intro_bumper_action_include":false,
      "ad_slot_outro_bumper_action_include":false,
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[
         -1,
         0,
         2
      ]
   }
}            
            

Segmentar solo las posiciones de los botones superiores (intro y outro)

{
   "profile":{
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":true,
      "ad_slot_outro_bumper_action_include":true
   }
}            
            

Segmentar cualquier espacio de pod de anuncios

{
   "profile":{
      "ad_slot_position_action_include":false,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":false,
      "ad_slot_outro_bumper_action_include":false
   }
}            
            

Excluir todas las ranuras y botones superiores de pod de anuncios

Este comportamiento no es algo que desee replicar; no servirás en nada.

{
   "profile":{
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":false,
      "ad_slot_outro_bumper_action_include":false
   }
}            
            

Segmentar solo el botón superior de intro

{
   "profile":{
      "ad_slot_position_action_include":true,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":true,
      "ad_slot_outro_bumper_action_include":false
   }
}            
            

Las siguientes configuraciones de segmentación de perfiles no son válidas y pueden dar lugar a un comportamiento inesperado.

Configuración no válida: no se puede segmentar todos los espacios publicitarios y todas las posiciones de los parachoques

{
   "profile":{
      "ad_slot_position_action_include":false,
      "ad_slot_position_targets":[],
      "ad_slot_intro_bumper_action_include":true,
      "ad_slot_outro_bumper_action_include":true
   }
}            
            

Apunte a una oferta garantizada mediante programación

Escenario: Ha negociado un acuerdo programático garantizado (acuerdo PG) con un vendedor y le gustaría orientar este trato con un elemento de línea de compra PG. Tendrás que crear un perfil de oferta de PG utilizando el ID de oferta de PG. A continuación, debe asociar este perfil a una línea de pedido de compra de PG para segmentar la oferta (consulte el ejemplo de Crear una línea de pedido de compra de PG en Servicio ALI de artículo de línea).

1. Crea un JSON de perfil de oferta de PG que incluya el identificador de destino de la oferta.

   Nota:

   Para las líneas de pedido de compra de PG, solo puede tener un objetivo de oferta en la deal_targets matriz.

   $ cat pg_deal_profile
   
   {
      "profile":{
         "deal_targets":[
            {
               "id":456
            }
         ],
         "allow_unaudited":true
      }
   }
   

2. Realice una POST solicitud al https://api.appnexus.com/profile punto de conexión con este perfil de oferta de PG JSON y un advertiser_idarchivo .

   $ curl -b cookies -c cookies -X POST -d @pg_deal_profile 'https://api.appnexus.com/profile?advertiser_id=123'
   
   {
      "response":{
         "status":"OK",
         "count":1,
         "id":123456,
         "start_element":0,
         "num_elements":100,
         "profile":{
            "id":123456,
            "code":null,
            "description":null,
            "country_action":"exclude",
            "region_action":"exclude",
            "city_action":"exclude",
            "browser_action":"exclude",
            "use_inventory_attribute_targets":false,
            "last_modified":"2019-08-07 19:43:12",
            "daypart_timezone":null,
            "dma_action":"exclude",
            "domain_action":"exclude",
            "domain_list_action":"exclude",
            "inventory_action":"exclude",
            "language_action":"exclude",
            "segment_boolean_operator":"and",
            "min_session_imps":null,
            "session_freq_type":"platform",
            "carrier_action":"exclude",
            "supply_type_action":"exclude",
            "device_type_action":"exclude",
            "screen_size_action":"exclude",
            "device_model_action":"exclude",
            "location_target_radius":null,
            "location_target_latitude":null,
            "location_target_longitude":null,
            "querystring_action":"exclude",
            "querystring_boolean_operator":"and",
            "is_expired":false,
            "non_audited_url_action":"include",
            "daypart_bitmap":null,
            "is_archived":false,
            "archived_on":null,
            "advertiser_id":123,
            "publisher_id":null,
            "max_session_imps":null,
            "max_day_imps":null,
            "max_lifetime_imps":null,
            "max_page_imps":null,
            "min_minutes_per_imp":null,
            "venue_action":"exclude",
            "operating_system_action":"exclude",
            "require_cookie_for_freq_cap":true,
            "trust":"seller",
            "allow_unaudited":true,
            "is_template":false,
            "created_on":"2019-08-07 19:43:12",
            "operating_system_family_action":"exclude",
            "use_operating_system_extended_targeting":true,
            "mobile_app_instance_action_include":false,
            "mobile_app_instance_list_action_include":false,
            "inventory_prefer_direct":false,
            "deal_action_include":true,
            "exclude_unknown_seller_member_group":false,
            "ad_slot_position_action_include":false,
            "ad_slot_intro_bumper_action_include":true,
            "ad_slot_outro_bumper_action_include":true,
            "graph_id":null,
            "media_subtype_action_include":false,
            "ads_txt_authorized_only":false,
            "inventory_url_allowlist_settings":{
               "apply_to_rtb":true,
               "apply_to_managed":true
            },
            "user_group_targets":null,
            "country_targets":null,
            "region_targets":null,
            "city_targets":null,
            "inventory_attribute_targets":null,
            "placement_type_targets":null,
            "age_targets":null,
            "daypart_targets":null,
            "browser_targets":null,
            "dma_targets":null,
            "domain_targets":null,
            "domain_list_targets":null,
            "language_targets":null,
            "size_targets":null,
            "zip_targets":null,
            "member_targets":null,
            "video_targets":{
               "allow_unknown_playback_method":false,
               "allow_unknown_context":false,
               "allow_unknown_player_size":false
            },
            "engagement_rate_targets":null,
            "segment_group_targets":null,
            "carrier_targets":null,
            "supply_type_targets":null,
            "device_type_targets":null,
            "screen_size_targets":null,
            "device_model_targets":null,
            "querystring_targets":null,
            "gender_targets":null,
            "intended_audience_targets":null,
            "inventory_network_resold_targets":null,
            "operating_system_targets":null,
            "operating_system_family_targets":null,
            "position_targets":null,
            "site_targets":null,
            "venue_targets":null,
            "operating_system_extended_targets":null,
            "postal_code_targets":null,
            "seller_member_group_targets":null,
            "cross_device":null,
            "key_value_targets":null,
            "media_subtype_targets":null,
            "content_category_targets":null,
            "deal_targets":[
               {
                  "id":456,
                  "name":"PG Deal 123",
                  "code":"PGD_123",
                  "deleted":false
               }
            ],
            "placement_targets":null,
            "platform_content_category_targets":null,
            "platform_placement_targets":null,
            "platform_publisher_targets":null,
            "publisher_targets":null,
            "ip_range_list_targets":null,
            "mobile_app_instance_targets":null,
            "mobile_app_instance_list_targets":null,
            "ad_slot_position_targets":null,
            "inventory_url_list_targets":null,
            "max_hour_imps":null,
            "max_week_imps":null,
            "max_month_imps":null
         },
         "dbg_info":{
            "warnings":[
   
            ],
            "version":"1.18.1247",
            "output_term":"profile"
         }
      }
   }
   

3. Crea una línea de pedido de compra de PG y asóciala al ID del perfil de oferta de PG recién creado (consulta el ejemplo de Crear una línea de pedido de compra de PG en Servicio ALI de artículo de línea).

   Apuntar a un distrito político específico

   {
      "profile":{
         "political_district_targets":[
            {
               "id":"139897"
            }
         ]
      }
   }                        
   
   

Temas relacionados

• Procedimientos recomendados de API
• Semántica de API
• Servicio de Distrito Político