Información general sobre el servicio de perfiles

Un perfil es un conjunto de parámetros de destino, 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 perfil es ejecutar una campaña; cree un perfil y, a continuación, asócielo al Servicio de campaña. El objeto de campaña incluye campos como fechas de vuelo y creatividades asociadas.

• Excepto para la segmentación de destino, los parámetros son absolutos. Por ejemplo, si el destino geográfico se establece solo en el Estados Unidos, SOLO las impresiones basadas en EE. UU. recibirán ofertas.
• La segmentación de destino usa o lógica booleana.
• Los perfiles deben estar asociados con un anunciante o un publicador, para poder usarse con otros objetos del sistema, que se enumeran a continuación.

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

• Anunciante
• Elemento de línea
• 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 oferta, aunque no es necesario que el perfil esté asociado a un anunciante o publicador.

API de REST

Http (método)	Endpoint	Description
POST	https://api.appnexus.com/profile?advertiser_id=ADVERTISER_ID& member_id=MEMBER_ID (JSON de perfil)	Agregue un nuevo perfil.
POST	https://api.appnexus.com/profile?advertiser_code=ADVERTISER_CODE (JSON de perfil)	Agregue un nuevo perfil.
PUT	https://api.appnexus.com/profile?id=PROFILE_ID& advertiser_id=ADVERTISER_ID&member_id=MEMBER_ID (JSON de perfil)	Modificar un perfil existente.
PUT	https://api.appnexus.com/profile?code=PROFILE_CODE& advertiser_code=ADVERTISER_CODE (JSON de perfil)	Modificar un perfil existente.
GET	https://api.appnexus.com/profile?advertiser_id=ADVERTISER_ID& member_id=MEMBER_ID	Consulta todos los perfiles de uno de tus anunciantes.
GET	https://api.appnexus.com/profile?advertiser_code=ADVERTISER_CODE	Consulta 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 publicador, reemplace por advertiser_idpublisher_id.

Campos JSON

General

Campo	Tipo	Descripción
id	Entero	Identificador 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 truees , el perfil se ha guardado como una plantilla de destino en . Para obtener perfiles que tienen como destino plantillas, pase is_template=true la cadena de consulta de una GET llamada. Para obtener más información sobre las plantillas de destino en, consulta "Administrar plantillas de destino" en el sistema de ayuda de la aplicación. Predeterminado:false
last_modified	Timestamp	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 está usando (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 esté asociado a ningún elemento de línea o campaña. Predeterminado:false
archived_on	Timestamp	Solo lectura. Fecha y hora en que se archivó el perfil (es decir, cuando el is_archived campo se estableció en true). Predeterminado:null

Frecuencia

Para obtener más información sobre la selección de destinos de frecuencia y recencia y los campos siguientes, consulte aquí.

Campo	Tipo	Descripción
max_lifetime_imps	Entero	Número máximo de impresiones por persona. Si se establece, este valor debe estar entre 0 y 255. Predeterminado:null
min_session_imps	Entero	Número mínimo de impresiones por persona y sesión. Si se establece, este valor debe estar entre 0 y 255. Predeterminado:null
max_session_imps	Entero	Número máximo de impresiones por persona y sesión. Si se establece, este valor debe estar entre 0 y 255. Predeterminado:null
max_day_imps	Entero	Número máximo de impresiones por persona y día. Si se establece, este valor debe estar entre 0 y 255. Predeterminado:null
max_hour_imps	Entero	Número máximo de impresiones por persona y hora. Si se establece, este valor debe estar entre 0 y 255. Predeterminado:null
max_week_imps	Entero	Número máximo de impresiones por persona y semana. Si se establece, este valor debe estar entre 0 y 255. Predeterminado:null
max_month_imps	Entero	Número máximo de impresiones por persona y mes. Si se establece, este valor debe estar entre 0 y 255. Predeterminado:null
min_minutes_per_imp	Entero	Número mínimo de minutos entre impresiones por persona. Es posible que este campo no se establezca en 0. Predeterminado:null
max_page_imps	Entero	Número máximo de impresiones por carga de página (solicitud de anuncio del vendedor). Nota: Solo es relevante para las subastas de varias etiquetas (por ejemplo: /(ss)vmap). Predeterminado:null
require_cookie_for_freq_cap	Booleano	Indica si va a servir exclusivamente a los usuarios con identificadores conocidos para mantener la configuración del límite de frecuencia. Establecer este campo en true indica que solo se ofrecerán anuncios a los usuarios con identificadores conocidos, lo que mantiene la configuración del límite de frecuencia. Establecer este campo en false indica que también servirá a usuarios anónimos. Si ha 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 de 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 true en no requerirá identificadores para un objeto que no tenga ninguna configuración activa de límite de frecuencia. Valor predeterminado: true Nota: La administración avanzada de frecuencias no se admite actualmente para monetizar usuarios.

Orientación

Cuando se establecen varios destinos, solo se puede usar el inventario que satisfaga todos los criterios de destino. Por ejemplo, si tiene como destino los orígenes de audiencia general e inventario previstos x, y y z, el perfil solo general se dirigirá al inventario de público de los orígenes de inventario x, y y z.

Nota:

No puede especificar los segment_targets campos y segment_group_targets en ninguna POST llamada o 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 de la parte inferior de esta página.
• Para artículos de línea de compra garantizados mediante programación:
  • Solo puede tener como destino un destino de oferta (consulte Destinos de la oferta a continuación) y el allow_unaudited campo debe establecerse en true.
  • No establezca ningún otro campo de destino.
• En el caso de los elementos de línea aumentadas, es obligatorio establecer al menos un país como destino geográfico (vea Destinos de país a continuación).
• A partir del 30 de agosto de 2021:

  • TapAd's Graph proporcionará cobertura global excepto Europa.

  • El gráfico de Xandr proporcionará cobertura para Europa y el Estados Unidos.

    Ajuste el código en consecuencia.

Campo	Tipo	Descripción
graph_id	Entero	- Null si el elemento de línea está destinado a la selección de gráficos predeterminada del asiento miembro. - 0 si el elemento de línea no tiene como destino ningún gráfico. - 3 si el elemento de línea tiene como destino el gráfico de TapAd. - 4 si el elemento de línea tiene como destino el gráfico Xandr. Nota: Para seleccionar los asientos miembro de EMEA Invest incluidos en el piloto de dispositivo cruzado predeterminado, hay un cambio en las expectativas de graph_id campo. Pasar graph_id como Null ahora se corresponderá con la selección de gráfico predeterminada del asiento del miembro. Para los miembros de nuestro piloto de EMEA, será graph_id = 4. Para deshabilitar la selección de destino entre dispositivos, estos puestos miembros deberán pasar graph_id = 0.
daypart_timezone	string	Zona horaria que se va a usar con daypart_targets. Para obtener más información, consulte Zonas horarias de API. Nota:null es equivalente a la zona horaria del usuario. Predeterminado:null
daypart_targets	matriz de objetos	Partes del día durante las cuales servir a la campaña. Para obtener más información, consulte Objetivos de Daypart a continuación. Nota: Si no estableces ningún objetivo de daypart, la campaña servirá todos los días de la semana en todo momento.
segment_targets	matriz de objetos	Nota: Si usa segment_targets y edita 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 usar segment_group_targets al trabajar a través de la API. Los identificadores de segmento de destino, cada uno de los cuales tiene una acción asociada (include o exclude). La lógica booleana se define entre segmentos con el segment_boolean_operator campo fuera de la matriz. Para obtener más información, consulte Segmentación de destinos y ejemplo a continuación.
segment_group_targets	matriz de objetos	Grupos de segmentos de destino. Mientras que la segment_targets matriz permite definir lógica booleana entre segmentos individuales, esta matriz permite establecer grupos de segmentos, definiendo lógica booleana entre los grupos, así como entre los segmentos de cada grupo. Defina la lógica booleana entre grupos con el segment_boolean_operator campo fuera de la matriz; defina la lógica booleana entre los segmentos de un grupo con el boolean_operator campo dentro del objeto de grupo. Para obtener más información, vea Segmentar destinos de grupo y un ejemplo a continuación. Nota: No se pueden agregar segmentos NULL. No puede agregar null segmentos a esta matriz mediante POST o PUT.
segment_boolean_operator	enumeración	Si usa segment_targets, define la lógica booleana entre los segmentos especificados. Si usa segment_group_targets, 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. Predeterminado:and
age_targets	matriz de objetos	Lista de intervalos de edades que se destinan a este perfil. El allow_unknown campo está disponible como booleano para tener en cuenta las llamadas de anuncios en las que la antigüedad del usuario no está disponible. Para obtener más descripción y ejemplos, consulte la sección Objetivos de edad a continuación.
gender_targets	objeto	La segmentación de género que se usa 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 sexo 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, tal como se define en el country_action campo. Puede usar country service para recuperar una lista de identificadores de país. Para obtener más detalles y formato, consulte Destinos de país. Obligatorio:POST/PUT, cuando country_action se incluye.
country_action	enumeración	Acción que se va a realizar en la country_targets lista. Valores posibles: include o exclude. 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, consulte Destinos de región a continuación. Obligatorio en:POST/PUT , cuando region_action es include.
require_transparency_and_consent_framework_string	booleano	- Si truees , solo permite que los objetos asociados compren inventario donde esté presente una cadena TCF válida. - Si falsees , permita que los objetos asociados compren cualquier inventario que se encuentre dentro de las declaraciones de destino predefinidas. - Esto solo se admite en el nivel de anunciante, ya que dirigirse a otros niveles puede dar lugar a un comportamiento indefinido. Nota: Este parámetro solo se aplica al tráfico procedente de territorios en los que se aplica el RGPD. Predeterminado:false
region_action	enumeración	Acción que se va a realizar en la region_targets lista. Valores posibles: include o exclude. 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, tal como se define en el dma_action campo. Puede usar el Servicio de área de mercado designada para recuperar una lista de identificadores DMA. Vea el ejemplo de formato.
dma_action	enumeración	Acción que se va a realizar en la dma_targets lista. Valores posibles: incluir o excluir. Predeterminado:exclude
city_targets	matriz de objetos	Los identificadores de ciudades que se incluirán o excluirán en un perfil, tal como se define en el city_action campo. Puede usar city service para recuperar una lista de identificadores de ciudad. Para obtener más detalles y formato, consulte Destinos de ciudad a continuación. Obligatorio en:POST/PUT , cuando city_action es include.
city_action	enumeración	Acción que se va a realizar en la city_targets lista. Valores posibles: include o exclude. 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 . Para obtener formato, consulte el ejemplo siguiente.
domain_action	enumeración	Acción que se va a realizar en la domain_targets lista. Para obtener más información sobre los dominios, consulte la documentación Crear un dominio o una lista de aplicaciones. Valores posibles: include o exclude. 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, tal como se define en el domain_list_action campo. Puede usar Domain List Service para recuperar identificadores de lista de dominios. Consulte el ejemplo siguiente para obtener formato. Nota: No puede usar más de 100 listas de dominios en un solo perfil.
domain_list_action	enumeración	Acción que se va a realizar en la domain_list_targets lista. Para obtener más información sobre los dominios, consulte Trabajar con Listas de destino en la documentación. Valores posibles: include o exclude. Predeterminado:exclude
platform_placement_targets	matriz de objetos	RTB u otro inventario de redes al que puede dirigirse. Puede usar Inventory Resold o Reporting Services para buscar ubicaciones de plataforma.
size_targets	matriz de objetos	Lista de tamaños válidos que se incluirán en el perfil. Los tamaños están en objetos de tamaño de matriz, cada objeto que contiene el ancho y el alto de cada tamaño de destino. Vea el ejemplo siguiente. Nota: Al habilitar el bloqueo de carretera en un elemento de línea garantizado, este valor se combina con tamaños creativos en el elemento de línea y la campaña para generar previsión. El tamaño con el menor número previsto de impresiones se devolverá como la capacidad prevista.
seller_member_group_targets	matriz de objetos	Los grupos de miembros del vendedor que se excluirán o incluirán en un perfil. Para establecer como destino el suministro directo de Xandr, consulte el formato siguiente.
member_targets	matriz de objetos	Identificadores de miembros del vendedor que 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	Obsolescente. Predeterminado:null
video_targets	objeto	Identificadores de destino de vídeo que se incluirán en un perfil. Para obtener el formato específico, consulte Destinos de vídeo a continuación.
engagement_rate_targets	matriz de objetos	Seleccione un inventario específico y de alto rendimiento en función del rendimiento histórico. Para obtener más información, consulte Objetivos de velocidad de interacción a continuación. Predeterminado:null
publisher_targets	matriz de objetos	Identificadores de publicador administrados o directos que se excluirán o incluirán en un perfil.
site_targets	matriz de objetos	Identificadores de sitios que se excluirán o incluirán en un perfil. Excluir o incluir se hereda del publisher_targets campo. Predeterminado: Si no proporciona acción con site_targets, la acción se usará de forma predeterminada en NULL y profile.inventory_action .
placement_targets	matriz de objetos	Identificadores de ubicación que se excluirán o incluirán en un perfil. Excluir o incluir se hereda del publisher_targets campo. Predeterminado: Si no proporciona ninguna 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 va a realizar en la inventory_targetslista , publisher_targets, site_targetsy placement_targets . Valores posibles: include o exclude. Si la acción es include, se incluirá cualquier publicador, sitio o ubicación de destino. Predeterminado:exclude
content_category_targets	objeto con cadena y matriz	Categorías de contenido destinadas a este perfil, así como si se permiten categorías desconocidas. Para obtener más detalles y formato, vea Destinos de categoría de contenido a continuación. Para recuperar los identificadores de categoría de contenido, use el servicio categoría de contenido.
deal_targets	matriz de objetos	Los identificadores de la oferta que se van a dirigir a 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, vea Destinos de la oferta a continuación. Para obtener más información sobre cómo afecta el valor de este campo y el campo a los deal_action_include resultados de destino, vea Resultados de destino para deal_action_include los campos AND deal_targets a continuación.
deal_list_targets	matriz de objetos	Los identificadores de lista de ofertas a los que se dirigirá este perfil. Vea el ejemplo siguiente. Los identificadores de lista de ofertas se pueden capturar mediante el servicio de lista de ofertas.
platform_publisher_targets	matriz de objetos	Identificadores de publicador de terceros 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 de reventa de red destinadas a este perfil. Para obtener una lista de identificadores, consulte el Servicio de reventa de inventario.
use_inventory_attribute_targets	Booleano	Si truees , el perfil permitirá el inventario que tiene los atributos confidenciales incluidos en inventory_attribute_targets. Predeterminado:false
trust	enumeración	Indica el nivel de auditoría que debe cumplir el inventario para poder ser apto. Valores posibles: appnexus o "seller". Si este campo se establece en "appnexus", el allow_unaudited campo debe establecerse en false. Predeterminado:seller
allow_unaudited	Booleano	Si truees , este perfil permitirá que el inventario no auditado pase el destino. Si el trust campo está establecido en appnexus, debe establecerse en false. Nota: - Esta configuración invalida la configuración de confianza del vendedor en el inventory_trust objeto del servicio miembro. - Para los artículos de línea de compra garantizados mediante programación, allow_unaudited debe establecerse en true. Predeterminado:false
session_freq_type	enumeración	Indica cómo se cuenta el número de impresiones que ha visto el usuario durante la sesión de exploración actual. Valores posibles: platform (en todos los publicadores de la sesión actual) o publisher (para el publicador específico). Predeterminado:platform
inventory_attribute_targets	matriz de objetos	Identificadores de atributos de inventario que se van a dirigir a este perfil. Puede usar el Servicio de atributos de inventario para recuperar una lista de identificadores.
intended_audience_targets	matriz de cadenas	Destinos de audiencia previstos. Valores posibles: general, children, young_adulto mature. Nota: Solo puede elegir incluir (no excluir) los destinos de audiencia previstos. Vea el ejemplo. Nota: Para usar el destino de audiencia previsto, default_trust en inventory_trust (un atributo bajo el miembro) debe establecerse en seller. Sin esta configuración, no se aplicará la segmentación de audiencia prevista.
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 language service para recuperar identificadores de idioma.
language_action	enumeración	Acción que se va a realizar en language_targets. Valores posibles: include o exclude. Predeterminado:exclude
querystring_targets	matriz de objetos	La cadena de consulta tiene como destino include o exclude en el perfil, tal como se define en el querystring_action campo .
querystring_action	enumeración	Acción que se va a realizar en .querystring_targets Valores posibles: include o exclude. Predeterminado:exclude
querystring_boolean_operator	enumeración	Lógica booleana que se va a aplicar a querystring_targets. Valores posibles: and o or. Predeterminado:and
postal_code_targets	matriz de objetos	Identificadores de código postal de destino. Vea el ejemplo. Los identificadores se pueden capturar 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 va a dirigir. Vea el ejemplo. Los identificadores se pueden capturar 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 la selección de destino y los distritos políticos definidos en political_district_targets. Predeterminado:true
zip_targets	matriz de objetos	Obsoleto. Use postal_code_targets en su lugar.
supply_type_targets	matriz de cadenas	Los tipos de suministro que se van a incluir o excluir de la selección de destino, tal 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 en desuso.
supply_type_action	enumeración	Los tipos de suministro son web, mobile_weby mobile_app. Valores posibles: include o exclude. Si este campo está establecido en include, solo se establecerá como destino el inventario de tipos incluidos en supply_type_targets . Si excludees , solo se destinará el inventario no en (excepto facebook_sidebar, que ha quedado en supply_type_targets desuso). Predeterminado:exclude
user_group_targets	objeto	Cada usuario se asigna aleatoriamente a 1 de 100 grupos de usuarios, sin ningún grupo que tenga ninguna ventaja sobre otro. Puede usar este campo para dirigirse a un intervalo específico de estos grupos de usuarios. Además, puede usar el include_cookieless_users campo para incluir o excluir usuarios sin cookies. Para obtener formato, vea el ejemplo Ver un perfil a continuación. Nota: El servicio de patrón de grupo de usuarios puede ayudarle a calcular los destinos del grupo de usuarios. El uso más común para los destinos de grupo de usuarios es definir grupos de usuarios para las pruebas A/B de estrategias de segmentación de campañas. Este es el funcionamiento: establezca destinos de grupo de usuarios de prueba en un perfil y controle los destinos de grupo de usuarios en otro. A continuación, 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 (consulte el labels campo en el Servicio de campaña). A continuación, ejecuta el informe Análisis de redes, Análisis de anunciantes de red o Análisis de anunciantes agrupado por user_group_for_campaign para clasificar cómo realizan las campañas el grupo de usuarios.
position_targets	objeto	Las posiciones de plegado que se van a dirigir. Para obtener más información, vea Objetivos de posición a continuación.
browser_targets	matriz de objetos	Los identificadores de los exploradores que se van a incluir o excluir de la selección de destino, tal como se define en el browser_action campo. Puede usar el servicio browser para recuperar una lista de identificadores de explorador. Para obtener el formato, vea el ejemplo siguiente.
browser_action	enumeración	Acción que se va a realizar en .browser_targets Valores posibles: include o exclude. Predeterminado:exclude
location_target_latitude	double	Latitud de la ubicación del usuario. Debe estar entre -90 y 90, con hasta 6 posiciones decimales, donde el sur es negativo y el 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 larga o lat, los usuarios solo se dirigirán al área definida por el centro (location_target_latitude, location_target_longitude) y el radio location_target_radius. Los usuarios no estarán destinados cuando los datos GPS no estén disponibles para la impresión.
location_target_longitude	double	Longitud de la ubicación del usuario. Debe estar entre -180 y 180, con hasta 6 posiciones 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 larga o lat, los usuarios solo se dirigirán al área definida por el centro (location_target_latitude, location_target_longitude) y el radio location_target_radius. Los usuarios no estarán destinados cuando los datos GPS no estén disponibles para la impresión.
location_target_radius	longitud de entero 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) para incluir o excluir de la segmentación, tal como se define en el device_model_action campo. Para recuperar una lista completa de modelos de dispositivo registrados en nuestro sistema, use el servicio device model de solo lectura. Para obtener más detalles y formato, consulte Destinos del modelo de dispositivo a continuación.
device_model_action	enumeración	Acción que se va a realizar en device_model_targets. Valores posibles: include o exclude. Predeterminado:exclude
device_type_targets	matriz de cadenas	Los tipos de dispositivos que se van a incluir o excluir de la selección de destino, tal como se define en el device_type_action campo . Posibles valores: - phone - tablet - pc - tv - gameconsole - stb - mediaplayer Para obtener formato, consulte Destinos de tipo de dispositivo a continuación.
device_type_action	enumeración	Acción que se va a realizar en device_type_targets. Valores posibles: include o exclude. Predeterminado:exclude
carrier_targets	matriz de objetos	Los operadores móviles que se incluirán o excluirán de la segmentación, tal como se define en el carrier_action campo . Para recuperar una lista completa de operadores de telefonía móvil registrados en nuestro sistema, use el Servicio de operador de solo lectura. Para obtener más detalles y formato, consulte Destinos del operador a continuación.
carrier_action	enumeración	Acción que se va a realizar en .carrier_targets Valores posibles: include o exclude. Predeterminado:exclude
inventory_url_list_targets	matriz de objetos	Contiene una lista de identificadores de lista de inventario (listas de permitidos o listas de bloqueo). Se usa para adjuntar una sola lista de permitidos o una o varias listas de bloqueo al perfil. - La lista de permitidos contiene una lista de dominios o aplicaciones a los que el elemento de línea debe dirigirse mediante el perfil. Si se incluye una lista de permitidos, los dominios y las aplicaciones que no están en la lista de permitidos no se dirigirán a ellos. - Cada lista de bloqueos contiene una lista de dominios o aplicaciones que se van a excluir de la selección de destino por elemento de línea que usa el perfil. Para obtener más información, vea Inventario Listas a continuación.
operating_system_family_targets	matriz de objetos	Los sistemas operativos en su conjunto (por ejemplo, Android, Apple iOS, Windows 7, etc.) para incluir o excluir de la segmentación, tal como se define en el operating_system_family_action campo. Nota: Este campo se usa para dirigirse a todas las versiones de sistemas operativos, mientras que operating_system_extended_targets se usa para dirigirse a versiones específicas de sistemas operativos. Para obtener más detalles y formato, consulte Los destinos de la familia del sistema operativo a continuación.
operating_system_family_action	enumeración	Acción que se va a realizar en operating_system_family_targets. Valores posibles: include o exclude. Predeterminado:exclude
use_operating_system_extended_targeting	Booleano	Solo lectura. Si truees , 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 mediante la duplicación de ellos) tendrán este campo establecido false en de forma predeterminada. No hay ninguna manera de actualizar un perfil anterior (o sus duplicados) para establecer este campo en true. Si desea agregar la segmentación extendida del sistema operativo a estos perfiles antiguos (o sus duplicados), debe crear un nuevo perfil y agregar la configuración de destino al nuevo perfil. Predeterminado:true
operating_system_extended_targets	matriz de objetos	Lista de sistemas operativos específicos que se incluirán o excluirán de la selección de destino. 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 los sistemas operativos. Para obtener más detalles y formato, consulte Destinos extendidos del sistema operativo a continuación. Nota: Este campo solo se respetará si use_operating_system_extended_targeting es true.
operating_system_action	enumeración	Obsoleto. Use operating_system_extended_targets en su lugar. Predeterminado:exclude
operating_system_targets	matriz de objetos	Obsoleto. Use operating_system_extended_targets en su lugar.
mobile_app_instance_targets	matriz de objetos	Lista de instancias de aplicaciones móviles que le gustaría incluir o excluir de la selección de destino. Para obtener definiciones de campo, consulte Destinos de instancia de aplicación móvil a continuación. Para obtener más información sobre qué son las instancias de aplicaciones móviles y cómo funcionan, consulte Mobile App Instance Service.
mobile_app_instance_action_include	Booleano	Si se deben incluir las instancias de aplicación móvil definidas en en mobile_app_instance_targets el destino de la campaña. Predeterminado:false
mobile_app_instance_list_targets	matriz de objetos	Esta lista contiene listas de instancias de aplicaciones móviles (es decir, es una lista de listas). Para obtener definiciones de campo, consulte Destinos de lista de instancias de aplicación móvil a continuación. Para obtener más información sobre las listas de instancias de aplicaciones móviles y cómo funcionan, consulte Mobile App Instance List Service.
mobile_app_instance_list_action_include	Booleano	Si se deben incluir las listas de instancias de aplicación móvil definidas en en mobile_app_instance_list_targets el destino de la campaña. Predeterminado:false
deal_action_include	Booleano	Ya sea para incluir o excluir ofertas definidas en deal_targets y listas de ofertas definidas en deal_list_targets la campaña o en la selección de destino de artículos de línea. Cuando se establece en true, se incluirán las ofertas y las listas de ofertas. Nota: Para establecer como destino o excluir ofertas y listas de ofertas, además de establecer este campo true en o false, también debe: - Proporcione una lista de ofertas y listas de ofertas para incluir o excluir en la deal_targets matriz y deal_list_targets . Una lista vacía no tendría como destino ninguna lista de ofertas o ofertas (si deal_action_include está establecida en ) o se dirigiría a truetodas las listas de ofertas o ofertas (si deal_action_include está establecida en false). - (Solo cuando se usan ALIs) Establezca el deals campo true en dentro de la supply_strategies matriz del servicio de elementos de línea. Para obtener más información sobre cómo afectan el valor de este campo y el campo a los deal_targets resultados de destino, vea Resultados de destino para deal_action_include campos AND deal_targets . Predeterminado:true
ip_range_list_targets	matriz de objetos	Lista de intervalos de direcciones IP que se incluirán o excluirán de la segmentación de campaña. Para obtener más información, consulte Destinos de lista de intervalos IP a continuación, así como la documentación de IP Range List Service.
key_value_targets	matriz de objetos	Lista de destinos de clave/valor personalizados. Para obtener detalles y ejemplos, vea Destinos de valor clave a continuación.
ad_slot_position_action_include	Booleano	Intención de dirigirse a ranuras específicas en un pod de anuncio. Ten en cuenta que puedes dirigirte a espacios de anuncios o parachoques de anuncios, pero no a ambos. Predeterminado:false
ad_slot_position_targets	matriz de ints	La ranura del anuncio coloca a un comprador que quiere servir en. -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 el gasto puede producirse en cualquier posición. true Establezca ad_slot_position_action_include en first si desea usar ad_slot_position_targets para especificar las posiciones de destino. Predeterminado:empty row
ad_slot_intro_bumper_action_include	Booleano	Esto controla si la creatividad se dirigirá 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 la creatividad no tiene como destino la posición del adpod de introducción, establezca este campo en false. Nota: Puedes dirigirte a espacios de anuncios o parachoques de anuncios, pero no a ambos. Predeterminado:true
ad_slot_outro_bumper_action_include	Booleano	Esto controla si la creatividad se dirigirá a las posiciones de salida de vídeo para las subastas de vídeo VAST. El valor predeterminado es true. Para asegurarse de que la creatividad no tiene como destino la posición del adpod outro, establezca este campo en false. Nota: Puedes dirigirte a espacios de anuncios o parachoques de anuncios, pero no a ambos. Predeterminado:true
screen_size_action	string	Obsolescente. Predeterminado:exclude
screen_size_targets	matriz de objetos	Obsolescente.
optimization_zone_action	string	No se admite actualmente. Predeterminado:exclude
optimization_zone_targets	matriz de objetos	No se admite actualmente.
created_on	Timestamp	Solo lectura. Fecha y hora en que se creó el perfil.
is_expired	Booleano	Solo lectura. Si truees , el objeto asociado al perfil ha expirado. Este parámetro solo se admite para fines internos. Predeterminado:false
inventory_network_resold_targets	matriz de objetos	Obsolescente.
exelate_targets	matriz de objetos	Obsolescente.
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. Consulte Configuración de lista de permitidos de dirección URL de inventario.
ads_txt_authorized_only	Booleano	Cuando true, el elemento de línea solo tendrá como destino el inventario web de los vendedores autorizados de dominios que tienen un archivo ads.txt. Nota: El ads_txt_authorized_only parámetro de destino solo se aplica al inventario de Open 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, consulte Ads.txt preguntas más frecuentes para compradores. Predeterminado:false
political_district_targets	matriz de objetos	Los identificadores de distrito político que se van a dirigir. Vea el ejemplo. Los identificadores se pueden capturar mediante el Servicio de Distrito Político.

dma_targets formato

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

domain_targets formato

{
   "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 formato

{
   "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"
         }
      ]
   }
}

Resultados de destino para deal_action_include campos AND deal_targets

Los siguientes resultados de destino se producen para estos valores de los deal_action_include campos AND deal_targets :

deal_action_include	deal_targets	Resultado de la selección de destino
true	null	Destino sin ofertas
false	null	Dirigirse a todas las ofertas
true	Contiene los destinos de la oferta	Incluir estas ofertas en la selección de destino
false	Contiene los destinos de la oferta	Excluir estas ofertas en la selección de destino

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 Mobile App Instance Service.

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

Destinos de lista de instancias de aplicaciones móviles

Para obtener más información sobre las listas de instancias de aplicaciones móviles, incluidas las instrucciones para agregarlas a su perfil, consulte Mobile App Instance List Service.

Campo	Tipo	Descripción
id	Entero	Identificador único de la lista de instancias de aplicación móvil.
name	string	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.

Destinos de daypart

Cada objeto de la daypart_targets matriz incluye los campos siguientes. Para obtener 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, wednesday, thursday, friday, o saturdayall. Nota: Estas cadenas deben estar en minúsculas.
start_hour	Entero	Hora de inicio de la parte del día. Debe ser un entero entre 0 y 23. La campaña comenzará a servir al principio de la hora (6 es equivalente a am "6:00" ).
end_hour	Entero	Hora de finalización de la parte del día. 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").

Destinos de segmento

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 cumplan todos los destinos de segmento. segment_boolean_operator Si es OR, el perfil se dirigirá a los usuarios que cumplan cualquiera de los segmentos especificados. Para obtener instrucciones detalladas sobre la lógica booleana para la segmentación de destino, consulte Segmentación de destino.

Campo	Tipo	Descripción
id	Entero	Identificador del segmento. Obligatorio activado:POST
code	string	Código personalizado para el segmento.
action	enumeración	Valores posibles: include o exclude. Predeterminado:include
start_minutes	Entero	Límite inferior durante el período de tiempo transcurrido desde que se agregó un usuario al segmento. Predeterminado:0
expire_minutes	Entero	Límite superior durante el período de tiempo transcurrido desde que se agregó un usuario al segmento. Predeterminado:-1
other_equals	Entero	Valor exacto del segmento de destino. Nota: Si usa other_in_list, no puede usar este campo. Predeterminado:null
other_less	Entero	Límite superior no inclusivo para la segmentación de destino de valores. Predeterminado:null
other_greater	Entero	Límite inferior no inclusivo para la segmentación de destino de valores. Predeterminado:null
other_in_list	matriz	Lista de valores de segmento de destino. Si usa other_equals, no puede usar este campo. Predeterminado:null

Nota:

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

En la segmentación de destino, debe mantener la configuración de la lógica booleana coherente; de lo contrario, no podría 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 field se establece como "and" o "or".
• El boolean_operator campo de cada objeto de la matriz de segment_group_targets (vea Destinos de grupo de segmentos) se establece como "and" o "or". Sin embargo, este valor debe ser lo contrario de lo que se ha establecido anteriormente segment_boolean_operator . Por ejemplo, si el valor establecido en segment_boolean_operator es "or", el valor de para boolean_operator los objetos debe ser "and".
• El valor del boolean_operator campo para todos los objetos de la matriz 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 destinos de segmento

En este ejemplo, dado que segment_boolean_operator es AND, el perfil solo se dirigirá a los usuarios que caben en el segmento 86 y el 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
         }
      ]
   }
}

Destinos de grupo de segmentos

Cada objeto de grupo de segmentos contiene los campos siguientes.

Nota:

Defina la lógica booleana entre grupos con el segment_boolean_operator campo fuera de la matriz y defina la lógica booleana entre los segmentos de un grupo con el boolean_operator campo dentro del objeto de grupo. Vea el ejemplo siguiente para obtener formato y para obtener un ejemplo de la lógica de combinación segment_boolean_operator y boolean_operator. Para obtener instrucciones detalladas sobre la lógica booleana para la segmentación de destino, consulte Segmentación de destino.

No se pueden agregar segmentos NULL.

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

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

Nota:

Para other_equals, other_less, other_greatery other_in_list, el valor del segmento puede ser un "other" valor pasado por el píxel del segmento o puede estar relacionado con los valores de cadena de consulta de segmento (vea el "querystring_mapped" campo en el servicio segment). Para obtener ejemplos de cómo establecer como destino los valores de cadena de consulta en un segmento, consulte otros ejemplos a continuación.

Ejemplo de destinos de grupo de segmentos

En este ejemplo, dado que es segment_boolean_operatorOR y boolean_operator para cada grupo es AND, el perfil solo se dirigirá a los usuarios que caben en el segmento 11 y el segmento 22 o en el segmento 33 y el segmento 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 deben incluir destinos en los que no se conozca la edad. Predeterminado:false
ages	matriz de objetos	Intervalos de edad destinados a este perfil.

ages objeto

Campo	Tipo	Descripción
low	Entero	Límite inferior del intervalo de edad (min 13).
high	Entero	Límite superior del intervalo de edad (máximo 100).

Ejemplo de destinos de edad

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

Objetivos de género

El gender_targets objeto contiene los campos siguientes.

Campo	Tipo	Descripción
gender	enumeración	El sexo del usuario. Valores posibles: m (macho) o f (hembra). Predeterminado:null Obligatorio activado:POST
allow_unknown	Booleano	Si truees , las llamadas de anuncios de destino en las que el sexo del usuario no está disponible. Predeterminado:false

Destinos de país

Cada objeto de la country_targets matriz contiene los campos siguientes.

Campo	Tipo	Descripción
id	Entero	El identificador del país. Puede usar country service para recuperar una lista completa de identificadores de país.
name	string	Solo lectura. Nombre del país.
code	string	Solo lectura. Código del país.

Ejemplo de destinos de 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 campos siguientes.

Campo	Tipo	Descripción
id	Entero	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. Nombre de la región.
code	string	Solo lectura. 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. Código del país al que pertenece la región.

Ejemplo de destinos de región

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

Requerir transparencia y cadena de marco de consentimiento

Campo	Tipo	Descripción
require_transparency_and_consent_framework_string	booleano	- Si truees , solo permite que los objetos asociados compren inventario cuando esté presente una cadena TCF válida. - Si falsees , permita que los objetos asociados compren cualquier inventario que se encuentre dentro de las declaraciones de destino predefinidas.

Nota:

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

Ejemplo

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

Destinos de ciudad

Cada objeto de la city_targets matriz contiene los campos siguientes.

Campo	Tipo	Descripción
id	Entero	Identificador de la ciudad de destino. Puede usar city service para recuperar una lista de identificadores de ciudad.
name	Entero	Solo lectura. Nombre de la ciudad de destino.
region_name	string	Solo lectura. Nombre de la región a la que pertenece la ciudad.
region_code	string	Solo lectura. 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. Código del país al que pertenece la región.

Ejemplo de destinos de ciudad

{
   "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 campos siguientes.

Campo	Tipo	Descripción
deleted	Booleano	Solo lectura. Indica si se ha eliminado la lista de inventario.
id	Entero	Identificador de la lista de permitidos o de la lista de bloqueos que se va a aplicar. - La lista de permitidos contiene una lista de dominios y aplicaciones a los que debe dirigirse el elemento de línea que usa el perfil. - Cada lista de bloqueos contiene una lista de dominios y aplicaciones que el elemento de línea que usa el perfil excluirá del destino. Obligatorio en:POST , PUT
list_type	string	Solo lectura. Indica si la lista es una lista de bloqueos o una lista de permitidos. Los valores válidos son allowlist o blocklist. Nota: El list_type servicio de perfiles no usa el campo (utilizado por el servicio de lista de inventario) para determinar si una lista de inventario se excluye (blocklist) en la selección de destino o se incluye ().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 bloqueos.
exclude	Booleano	Solo lectura. Si truees , la lista de inventario se excluirá de la selección de destino (es decir, se tratará como una lista de bloqueos). Si falsees , 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
         }
      ]
   }
}            
            

Destinos 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 campos siguientes.

Campo	Tipo	Descripción
id	Entero	Identificador de la categoría de contenido de destino. Predeterminado:null Obligatorio activado:POST
action	Num	Acción que se va a realizar para esta categoría de contenido. Valores posibles: include o exclude. Si includees , se dirigirá a la categoría; si excludees , la categoría no se dirigirá explícitamente. Predeterminado:exclude

Ejemplo de destinos de categoría de contenido

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

Destinos de vídeo

El video_targets objeto contiene las allow_unknown_playback_methodmatrices , allow_unknown_context, , allow_unknown_player_size y playback_methods, contexts. player_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 al inventario donde se desconoce el método de reproducción. Establezca este campo true en cuando use los campos de la playback_method matriz para dirigirse a métodos de reproducción específicos Y cuando desee incluir un inventario para el que no se haya proporcionado información del método de reproducción. Si no tiene como destino métodos de reproducción específicos, este campo no tendrá ningún efecto en la selección de destino. Predeterminado:false
allow_unknown_context	Booleano	Use este campo para dirigirse al inventario donde el contexto es desconocido. Establezca este campo true en cuando use los campos de la contexts matriz para dirigirse a contextos específicos Y cuando desee incluir un inventario para el que no se haya proporcionado información de contexto. Si no tiene como destino contextos específicos, este campo no tendrá ningún efecto en la selección de destino. Predeterminado:false
allow_unknown_player_size	Booleano	Use este campo para dirigirse al inventario en el que se desconoce el tamaño del jugador. Establezca este campo true en cuando use los campos de la player_sizes matriz para dirigirse a tamaños de reproductor específicos Y cuando quiera incluir un inventario para el que no se haya proporcionado información sobre el tamaño del jugador. Si no tienes como destino tamaños de jugador específicos, este campo no tendrá ningún efecto en la selección de destino. Predeterminado:false

Nota:

• Si NO establece ninguna opción de destino de vídeo específica, se dirigirá a todo el inventario, incluido el inventario no definido.
• Asegúrese de que ha elegido incluir o excluir las creatividades de introducción y salida estableciendolas 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 tendrá como destino cualquier posición de lanzamiento. La contexts matriz contiene objetos con los campos siguientes:

Campo	Tipo	Descripción
id	Entero	Identificador del contexto. Posibles valores: - 1: position-pre-roll - 2: position-mid-roll - 3: position-post-roll - 4: outstream
name	string	Solo lectura. Valores posibles: pre-roll, mid-roll, post-rollo outstream.

Métodos de reproducción

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

Campo	Tipo	Descripción
id	Entero	Identificador 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_play, mouse_overo auto_play_sound_unknown.

Tamaños de reproductor

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

Campo	Tipo	Descripción
id	Entero	Identificador del tamaño del jugador. 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. Ancho mínimo del reproductor, en píxeles.
max_width	Entero	Solo lectura. Ancho máximo del reproductor, en píxeles.

Duración de la creatividad

La deal_creative_duration configuración solo la usan los elementos de línea de la oferta de vídeo. Permite tratar las impresiones de destino que permiten al menos una duración creativa determinada, por lo que las creatividades de la longitud definida pueden servir correctamente a través de una transacción sin errores. Solo agregará las impresiones con la configuración especificada ya en su lugar.

Campo	Tipo	Descripción
deal_creative_duration	Entero	Duración de la creatividad de vídeo en segundos.

Marcos de vídeo

La video_frameworks matriz solo la usan los elementos de línea de la oferta de vídeo. Permite tratar las impresiones de destino que permiten un marco de vídeo determinado (por ejemplo, VPAID) para que las creatividades de este tipo puedan servir correctamente a través de una oferta sin errores. Esta configuración no invalidará la configuración de selección de ubicación existente; solo agregará las impresiones con la configuración especificada ya en su lugar.

Campo	Tipo	Descripción
id	Entero	Identificador del marco de vídeo. Los identificadores incluyen: - VPAID 1.0 - VPAID 2.0 - MRAID-1 - ORMMA - MRAID-2
name	string	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":"outstream"
            }
         ],
         "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 velocidad de interacción

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

Campo	Tipo	Descripción
engagement_rate_type	enumeración	Criterios de destino. Posibles valores: - 1: video_completion - Velocidad de finalización de vídeo. Una predicción de la probabilidad de que una impresión de vídeo se reproduzca por completo (el vídeo se completa/total de impresiones). - 2: view - Tasa de visualización de IAB prevista (anteriormente conocida como "Tasa de visualización estimada de IAB"). Una predicción de la probabilidad de que se pueda ver una impresión de pantalla web (impresiones vistas o medidas), juzgadas por el estándar IAB. - 3: view_over_total - Tasa de visualización de IAB prevista sobre total. Una predicción de la probabilidad de que se pueda ver una impresión de pantalla web (vistas o totales), que se evalúa según el estándar IAB. - 4: predicted_iab_video_view_rate - Tasa de visualización de vídeo de IAB prevista. Una predicción de la probabilidad de que se pueda ver una impresión de vídeo web (impresiones vistas o medidas), evaluadas por el estándar IAB. - 5: predicted_iab_video_view_rate_over_total - Tasa de visualización de vídeo de IAB prevista sobre total Una predicción de la probabilidad de que una impresión de vídeo web sea visible (impresiones visualizadas o totales), valoradas por el estándar IAB. - 6: predicted_100pv50pd_video_view_rate - Velocidad de visualización de vídeo prevista (100 % de vista, 50 % de duración, sonido activado). Una predicción de la probabilidad de que una impresión de vídeo web sea visible (impresiones vistas o medidas), que se juzgue según este estándar personalizado (100 % visible, 50 % de duración, sonido activado). - 7: predicted_100pv50pd_video_view_rate_over_total - Velocidad de visualización de vídeo prevista sobre el total (100 % de vista, 50 % de duración, sonido activado). Una predicción de la probabilidad de que se pueda ver una impresión de vídeo web (impresiones visualizadas o totales), juzgada por este estándar personalizado (100 % visible, 50 % de duración, sonido activado). - 8: predicted_100pv1s_display_view_rate - Tasa de visualización prevista (vista del 100 %). Una predicción de la probabilidad de que una impresión de pantalla web sea visible (impresiones vistas o medidas), que se juzgue según este estándar personalizado (100 % visible, 1 segundo). - 9: predicted_100pv1s_display_view_rate_over_total - Tasa de visualización prevista sobre el total (100 % de vista). Una predicción de la probabilidad de que una impresión de pantalla web sea visible (vistas o totales), que se juzgue según este estándar personalizado (100 % visible, 1 segundo).
engagement_rate_pct	Entero	Valores posibles: 1 - 100.

Destinos de la oferta

Cada objeto de la deal_targets matriz contiene los campos siguientes.

Nota:

Para establecer como destino o excluir ofertas, además de establecer los campos de esta matriz según sea necesario, también debe:

• Establezca el deal_action_include campo true en o false (en función de la inclusión o exclusión).
• Al usar ALIs, establezca el deals campo true en dentro de la supply_strategies matriz del servicio de elementos de línea.
• Los artículos de línea de compra garantizados mediante programación solo pueden tener un destino de oferta en la deal_targets matriz.

Campo	Tipo	Descripción
id	Entero	El identificador de la transacción. Para recuperar los identificadores de las ofertas, use el Servicio de acceso al comprador de ofertas.
name	string	Solo lectura. Nombre de la oferta.
code	string	Solo lectura. Código personalizado para la oferta. En el caso de las ofertas con asociados de suministro externos, esta suele ser la cadena que usará para identificar la oferta.

Ejemplo de destinos de la 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
         }
      ]
   }
}            
            

Posición de destinos

El position_targets objeto contiene los campos siguientes.

Campo	Tipo	Descripción
allow_unknown	Booleano	Si truees , el perfil se dirigirá a ubicaciones para las que no se conoce la posición de plegado. Predeterminado:false
positions	matriz de objetos	Las posiciones de plegado que se van a dirigir. Valores posibles: "above" o "below".

Ejemplo de destinos de posición

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

Destinos del modelo de dispositivo

Cada objeto de la device_model_targets matriz contiene los campos siguientes.

Sugerencia

Para recuperar los identificadores de los modelos de dispositivo registrados en nuestro sistema, use el servicio device model.

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

Ejemplo de destinos del modelo de dispositivo

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

Destinos 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 del operador

Cada objeto de la carrier_targets matriz contiene los campos siguientes.

Nota:

• Para recuperar los identificadores de las compañías de telefonía móvil registradas en nuestro sistema, use el Servicio de operador.

• La capacidad de dirigirse por operador hace referencia al hecho de que puede dirigirse 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	Identificador del operador de telefonía móvil.
name	string	Solo lectura. 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 operador

{
   "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"
         }
      ]
   }
}            
            

Destinos de lista de intervalos IP

Para obtener más información sobre las listas de intervalos IP, consulte ip range list service.

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

Campo	Tipo	Descripción
id	Entero	Identificador único de esta lista de intervalos IP.
name	string	Solo lectura. Nombre de esta lista de intervalos IP.
include	Booleano	Solo lectura. Si desea incluir o excluir 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.) para incluir o excluir de la selección de destino.

Nota:

operating_system_extended_targets la 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 los sistemas operativos.

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

  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 destino combinadas, consulte el ejemplo Uso de destinos de familia del sistema operativo y destinos extendidos del sistema operativo juntos a continuación.

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

Cada objeto de la operating_system_extended_targets matriz contiene los campos siguientes.

Campo	Tipo	Descripción
id	Entero	Identificador de la versión del sistema operativo. Para recuperar los identificadores de las versiones del sistema operativo registradas en nuestro sistema, use el servicio extendido del sistema operativo.
name	string	Solo lectura. Nombre de la versión del sistema operativo, por ejemplo, , Android 3.xApple iOS 5, etc.
action	enumeración	Acción que se va a realizar 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 la familia de sistemas operativos

La operating_system_family_targets matriz especifica los sistemas operativos en su conjunto (por ejemplo, Android, Apple iOS, Windows 7, Windows 11, etc.) para incluir o excluir de la selección de destino, tal como se define en el operating_system_family_action campo .

Nota:

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

Los destinos de la 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 destino combinadas, consulte el ejemplo Uso de destinos de familia del sistema operativo y destinos extendidos del sistema operativo juntos a continuación.

Cada objeto de la operating_system_family_targets matriz contiene los campos siguientes.

Campo	Tipo	Descripción
id	Entero	Identificador de la familia del sistema operativo. Para recuperar los identificadores de las familias de sistemas operativos registradas en nuestro sistema, use el Servicio familiar del sistema operativo.
name	string	Solo lectura. Nombre de la familia del sistema operativo, es decir, Microsoft Windows, Android, Apple iOS, etc.

Ejemplo de destinos de la 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 personalizadas y valores destinados a este perfil. El campo es una versión analizada de una expresión lógica.

Puede 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 perfil en Destino de valor de clave personalizada.

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 y exp .

Campo	Tipo	Descripción
header	objeto	Información de control de versiones que se usa para evaluar la expresión.
exp	objeto	Expresión regular que define la combinación de clave/valores.

header objeto

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

exp objeto

Campo	Tipo	Descripción
typ	string	Operadores usados en la expresión . Los valores posibles son: - and - or - not - in - eq (igual a) - gt (mayor que) - lt (menor que) - gte (mayor o igual que) - lte (menor o igual que) - neq (no es igual a) Los operadores and, ory not solo se pueden usar con subexpresión. Los operadores gt, gtelty lte solo se pueden usar con valores numéricos. Todos los operadores deben estar en minúsculas.
sbe	exp (objeto)	Objeto que contiene la subexpresión (los elementos de la expresión).
key	string	Nombre de la clave de destino.
vtp	type	Este campo identifica el tipo de datos del valor de expresión. El valor especificado en este campo debe coincidir con el campo y el tipo del campo de valor correspondiente. Los valores siguientes son válidos: - num: numérico; Debe proporcionarse un valor en el vnm campo . - str: cadena; Debe proporcionarse un valor en el vst campo . - nma: matriz numérica; Debe proporcionarse un valor en el vna campo . - sta: matriz de cadenas; Debe proporcionarse un valor en el vsa campo .
vnm	valor numérico	Valor como un float con signo de 32 bits (por ejemplo, 25,3). Los números pueden ser de hasta 13 dígitos (con un máximo de seis dígitos a la derecha del separador decimal).
vst	string	Valor como una cadena.
vna	matriz de valores numéricos	Conjunto de valores como una matriz de floats.
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 dirección URL de inventario

Los campos de este objeto se usan para establecer cómo se aplicarán las listas de permitidos asociadas a un elemento de línea. Todas las listas de permitidos se aplicarán a la compra de RTB de forma predeterminada. También puede optar por aplicar las listas de permitidos a la compra administrada.

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

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

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

Ejemplos

Visualización de un perfil

Este es un ejemplo de un servicio de perfil.

Nota:

En aras de la demostración, este perfil tiene una estrategia de segmentació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 publicadores 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 dirigir esta información a la 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 a las ubicaciones de destino que incluyan cualquiera de los parámetros cuando el parámetro pase cualquier año entre "car_year=2009" y "car_year=2012", de modo 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 publicador automático le dijo que esperara cualquiera de los siguientes valores clave-valor en las cadenas de consulta de sus ubicaciones: "car_make=ford", "car_make=honda"o "car_make=toyota". Para dirigirse a esta información, agregó el parámetro y los valores al segmento 12. Ahora quiere actualizar el perfil de la campaña para que tenga como destino esos valores, de modo que cree el siguiente JSON y realice 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 publicador automático le dijo que esperara los siguientes valores de clave en las cadenas de consulta de sus ubicaciones: car_color=red, car_color=blueo car_color=black. Para dirigirse a esta 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, black, de modo 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
   }
}

Dirigirse a 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 se crea el siguiente JSON y se 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 Nueva York. Esto requiere establecer en region_actioninclude, region_targets en US:NY, dma_action en excludey dma_targets en 501, que es el código DMA de la ciudad de Nueva York. Por lo tanto, cree el siguiente JSON y realice 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
   }
}

Dirigirse a una oferta

Escenario: ha negociado un acuerdo con un vendedor que le concede acceso al 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 la oferta para buscar el identificador de la oferta y, a continuación, actualizar la deal_targets matriz de su perfil para que tenga como destino ese identificador.

1. Para encontrar el identificador de su oferta, realice una GET llamada al Servicio de acceso al comprador de la oferta e identifique la oferta correcta. Como alternativa, si conoce el identificador de miembro del vendedor, puede pasarlo 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, cree el archivo JSON con deal_targets establecido en el identificador de la oferta.

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

3. Por último, realice 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
      }
   }
   

Uso conjunto de destinos de familia del sistema operativo y destinos extendidos del sistema operativo

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

• Dispositivos iOS 7.0 de destino; todas las demás familias de so 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 son Desconocido, Linux o Symbian.
• Se dirige a todos los dispositivos Android, junto con iOS 7.0.
• El destino es todo Android y todos los iOS y todo Windows Mobile.
• Mac OS 10.8 (Mountain Lion) y MS Windows 8.0.
• Mac OS X 10.8 (Mountain Lion) y todo Windows Desktop excepto XP y 2000.
• Se dirige a todos los sistemas operativos iOS excepto 2.0 y 2.1.
• Configuración no válida: no se puede incluir una familia de so y excluir a sus miembros.
• Configuración no válida: no se pueden incluir y excluir miembros de la misma familia del sistema operativo.
• Configuración no válida: no se pueden incluir miembros de una familia de so excluida.

Dispositivos iOS 7.0 de destino; todas las demás familias del sistema operativo 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 del sistema operativo no servirán

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

Destino de todos los sistemas operativos que no son 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"
         }
      ]
   }
}            
            

Dirigirse a 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"
      }
   ]
}            
            

Dirigirse a todo Android y a todos los iOS y a todos los dispositivos 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":{
         
      }
   }
}            
            

Mac OS 10.8 (Mountain Lion) y MS Windows 8.0

En este ejemplo se combinan los destinos extendidos del sistema operativo de diferentes familias de so.

{
   "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"
         }
      ]
   }
}            
            

Mac OS X 10.8 (Mountain Lion) y todo Windows Desktop 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"
         }
      ]
   }
}            
            

Dirigirse a 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 destino de perfil no son válidas y pueden dar lugar a un comportamiento inesperado.

Configuración no válida: no se puede incluir una familia del sistema operativo y 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 pueden incluir y 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 so 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"
         }
      ]
   }
}            
            

Posiciones de pod de anuncios de destino

Dirigirse a posiciones específicas de ranuras de anuncios (ú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
      ]
   }
}            
            

Posiciones de solo parachoques de destino (introducción y salida)

{
   "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
   }
}            
            

Dirigirse a cualquier ranura 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 parachoques del pod de anuncios

Este comportamiento no es algo que quiera 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
   }
}            
            

Dirigirse solo al parachoques de introducción

{
   "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 destino de perfil no son válidas y pueden dar lugar a un comportamiento inesperado.

Configuración no válida: no se puede dirigir a todas las ranuras de anuncios y todas las posiciones de 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
   }
}            
            

Dirigirse a un acuerdo garantizado mediante programación

Escenario: ha negociado una oferta de garantía mediante programación (acuerdo PG) con un vendedor y le gustaría dirigirse a este acuerdo con un artículo de línea de compra de PG. Tendrá que crear un perfil de oferta PG con el identificador de la oferta PG. A continuación, debe asociar este perfil a un artículo de línea de compra de PG para dirigirse a la oferta (consulte el ejemplo Crear un artículo de línea de compra de PG en el servicio ALI de artículo de línea).

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

   Nota:

   En el caso de los artículos de línea de compra de PG, solo puede tener un destino 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 punto de https://api.appnexus.com/profile conexión con este json de perfil de oferta PG y un valor adecuado advertiser_id.

   $ 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. Cree un elemento de línea de compra de PG y asócielo con el identificador del perfil de oferta PG recién creado (consulte el ejemplo Crear un artículo de línea de compra de PG en el servicio ALI de artículo de línea).

   Dirigirse 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