Servicio de perfiles de visibilidad

Si revende su inventario, el Servicio de Perfil de Visibilidad le permite controlar el nivel de detalle que pasa a los compradores en sus solicitudes de oferta. En concreto, puede exponer u ocultar los identificadores y nombres del editor, los identificadores y nombres de ubicación, los datos de edad y sexo proporcionados por el editor, la categorización universal y personalizada del inventario, las direcciones URL de inventario, la información de ubicación y mucho más.

La configuración predeterminada de su perfil (es decir, expose_age_default, expose_gender_default, etc.) se aplica a todos los compradores de la plataforma y los licitadores externos, pero puede invalidar la configuración predeterminada para compradores de plataforma específicos y licitadores externos mediante las buyer_members matrices and bidders . Por ejemplo, puede ocultar los datos del inventario de forma predeterminada y, después, exponer los datos solo a miembros de compras específicos con los que tenga una relación comercial especial. Alternativamente, puede exponer los datos de inventario a todos, excepto a los miembros de compra específicos que considere competidores.

Además de afectar a los datos que los compradores ven en las solicitudes de puja, la configuración de visibilidad afecta a los datos que ven los compradores cuando informan de las impresiones compradas. Por ejemplo, si oculta los ID y nombres de editor de un comprador, ese comprador no verá sus ID y nombres de editor en los informes.

Nota:

Aunque puede crear varios perfiles de visibilidad, solo puede adjuntar uno a su miembro (consulte el campo en Servicio visibility_profile_id al miembro). Si te interesa adjuntar perfiles de visibilidad directamente a los editores, ponte en contacto con el representante de tu cuenta.

API de REST

Método HTTP Endpoint Description
POST https://api.appnexus.com/visibility-profile
visibility_profile(JSON)		 Agregar un perfil de visibilidad.
PUT https://api.appnexus.com/visibility-profile?id=VISIBILITY_PROFILE_ID
visibility_profile(JSON)		 Modificar un perfil de visibilidad.
DELETE https://api.appnexus.com/visibility-profile?id=VISIBILITY_PROFILE_ID Eliminar un perfil de visibilidad.
GET https://api.appnexus.com/visibility-profile Ver todos los perfiles de visibilidad.
GET https://api.appnexus.com/visibility-profile?id=VISIBILITY_PROFILE_ID Ver un perfil de visibilidad específico.
GET https://api.appnexus.com/visibility-profile?id=1,2,3 Ver varios perfiles de visibilidad por identificador mediante una lista separada por comas.
GET https://api.appnexus.com/visibility-profile/meta Obtenga información sobre los campos por los que puede filtrar y ordenar.

Campos JSON

Campo Tipo Descripción
id Entero Solo lectura. El identificador del perfil de visibilidad.
Valor predeterminado: Número generado automáticamente (es decir, 123).
Requerido el:PUT, en la cadena de consulta.
member_id Entero Solo lectura. El identificador del miembro propietario del perfil de visibilidad.
name string Nombre del perfil de visibilidad.
Requerido en:POST
notes string Información adicional sobre el perfil de visibilidad.
expose_publishers_default Booleano No lo uses.
No está disponible para todos los clientes. Si true, se pasan identificadores de editor en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_tags_default Booleano No lo uses.
No está disponible para todos los clientes. Si true, los identificadores de ubicación se pasan en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_age_default Booleano Si true, se pasan datos de edad proporcionados por el editor en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_gender_default Booleano Si true, los datos de género proporcionados por el editor se pasan en sus solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_universal_categories_default Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_custom_categories_default enumeración La visibilidad de las categorías de contenido personalizado en las solicitudes de puja.
Posibles valores:
- none: no se pasan categorías personalizadas en las solicitudes de puja.
- all: Todas las categorías personalizadas se pasan en las solicitudes de puja.
- list: las categorías personalizadas enumeradas en la matriz se pasan en las custom_categories solicitudes de licitación.
Valor predeterminado:none
url_exposure_default enumeración La visibilidad de las URL de inventario en las solicitudes de puja.
Posibles valores:
- full: Se pasan direcciones URL completas en las solicitudes de puja.
- domain: Solo se pasan dominios de direcciones URL en las solicitudes de oferta.
- hidden: Las direcciones URL no se pasan en las solicitudes de puja.
Valor predeterminado:full
expose_bid_requests_default Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_auction_id_default Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_locale_default Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_ecp_default Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_reserve_price_default Booleano Si true, los precios de reserva proporcionados por el editor se pasan en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_user_id_default Booleano Si true, se pasan identificadores de usuario proporcionados por el editor en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_ip_default Booleano Si true, se pasan direcciones IP proporcionadas por el editor en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_venue_id_default Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_user_agent_default Booleano Si true, los agentes de usuario proporcionados por el editor se pasan en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_city_default Booleano Si true, las ciudades proporcionadas por el editor están disponibles para la segmentación y los informes para los compradores que usan Microsoft Invest. Esto se aplica a todos los miembros y licitadores de Microsoft Invest que no se establezcan por separado en las buyer_members matrices and bidders siguientes.
Si true este perfil de visibilidad está asociado a una oferta mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que segmenten la oferta no podrán dirigirse a las ciudades. Para obtener más detalles, consulte el Servicio de ofertas.
Los compradores en DSP externos pueden dirigirse a las ciudades e informar sobre ellas independientemente de esta configuración.
Valor predeterminado:true
expose_state_default Booleano Si true, los estados proporcionados por el editor están disponibles para la segmentación y los informes para los compradores que usan Microsoft Invest. Esto se aplica a todos los miembros y licitadores de Microsoft Invest que no se establezcan por separado en las buyer_members matrices and bidders siguientes.
Si true este perfil de visibilidad está asociado a una oferta mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que segmenten la oferta no podrán dirigirse a estados. Para obtener más detalles, consulte el Servicio de ofertas.
Los compradores de DSP externos pueden dirigirse a los estados e informar sobre ellos independientemente de esta configuración.
Valor predeterminado:true
expose_dma_default Booleano Si true, los DMA proporcionados por el editor están disponibles para la segmentación y los informes para los compradores que usan Microsoft Invest. Esto se aplica a todos los miembros y licitadores de Microsoft Invest que no se establezcan por separado en las buyer_members matrices and bidders siguientes.
Si true este perfil de visibilidad está asociado a una oferta mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que segmenten la oferta no podrán dirigirse a los DMA. Para obtener más detalles, consulte el Servicio de ofertas.
Los compradores de DSP externos pueden dirigirse a los DMA e informar sobre ellos independientemente de esta configuración.
Valor predeterminado:true
expose_postal_code_default Booleano Si true, los códigos postales proporcionados por el editor se pasan en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_geo_lat_lon_default Booleano Si true, la información de latitud y longitud proporcionada por el editor se pasa en sus solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_device_id_default Booleano Si true, los identificadores de dispositivo proporcionados por el editor se pasan en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_device_model_id_default Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_querystring_default Booleano Si true, se pasan cadenas de consulta proporcionadas por el editor en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_application_id_default Booleano Si true, los identificadores de aplicación móvil Android o iOS proporcionados por el editor se pasan en sus solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_site_id_default Booleano Si true, los identificadores de grupo de ubicación (sitio) proporcionados por el editor se pasan en sus solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma y postores que no se establezcan por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_datetime_default Booleano No lo uses. Este campo se omite.
expose_multiformat_banner_default Booleano Si es verdadero, las solicitudes de oferta de oRTB multiformato expondrán el banner media_type a los compradores, si el banner media_type es parte de la solicitud de oferta. Ten en cuenta que las solicitudes de pujas multiformato deben estar habilitadas para que estos campos sean aplicables. Sin embargo, antes de solicitar la habilitación del multiformato, revisa las prácticas recomendadas para los vendedores y habla con tu gestor de cuentas. Esto se aplica a todos los miembros de la plataforma, los postores y los matrices no se establecen por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_multiformat_video_default Booleano Si es verdadero, las solicitudes de oferta de oRTB multiformato expondrán el vídeo media_type a los compradores, si el vídeo media_type es parte de la solicitud de oferta. Ten en cuenta que las solicitudes de pujas multiformato deben estar habilitadas para que estos campos sean aplicables. Sin embargo, antes de solicitar la habilitación del multiformato, revisa las prácticas recomendadas para los vendedores y habla con tu gestor de cuentas). Esto se aplica a todos los miembros de la plataforma, los postores y los matrices no se establecen por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_multiformat_audio_default Booleano Si es verdadero, las solicitudes de oferta de oRTB multiformato mostrarán el audio media_type a los compradores, si media_type nativo es parte de la solicitud de oferta. Ten en cuenta que las solicitudes de pujas multiformato deben estar habilitadas para que estos campos sean aplicables. Sin embargo, antes de solicitar la habilitación del multiformato, revisa las prácticas recomendadas para los vendedores y habla con tu gestor de cuentas). Esto se aplica a todos los miembros de la plataforma, los postores y los matrices no se establecen por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
expose_multiformat_native_default Booleano Si es verdadero, las solicitudes de oferta de oRTB multiformato expondrán lo nativo media_type a los compradores, si lo nativo media_type es parte de la solicitud de oferta. Ten en cuenta que las solicitudes de pujas multiformato deben estar habilitadas para que estos campos sean aplicables. Sin embargo, antes de solicitar la habilitación del multiformato, revisa las prácticas recomendadas para los vendedores y habla con tu gestor de cuentas). Esto se aplica a todos los miembros de la plataforma, los postores y los matrices no se establecen por separado en las buyer_members matrices and bidders a continuación.
Valor predeterminado:true
buyer_members matriz de objetos Las reglas de visibilidad para miembros específicos de la plataforma Xandr. Para obtener más detalles, consulte Miembros compradores a continuación.
Valor predeterminado:true
bidders matriz de objetos Las reglas de visibilidad para licitadores externos específicos y/o proveedores de datos contextuales. Para obtener más detalles, consulte los licitadores a continuación.
custom_categories matriz de objetos Las categorías de contenido personalizado que se pasan en las solicitudes de puja. Para obtener más información, consulte Categorías personalizadas a continuación.
Requerido en:POST, si expose_custom_categories_default es list.
last_modified marca de tiempo Solo lectura. La fecha y hora en que se modificó por última vez el perfil de visibilidad.
expose_device_type_targets Booleano Si true este perfil de visibilidad está asociado a una oferta mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que segmenten no podrán dirigirse a los tipos de dispositivos. Para obtener más detalles, consulte el Servicio de ofertas.
expose_segment_groups_default Booleano Si true este perfil de visibilidad está asociado a una oferta mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que segmenten la oferta no podrán dirigirse a segmentos. Para obtener más detalles, consulte el Servicio de ofertas.
expose_video_context_default Booleano Si true este perfil de visibilidad está asociado a una oferta mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que segmenten la oferta no podrán dirigirse a contextos de vídeo (por ejemplo, pre-roll). Para obtener más detalles, consulte el Servicio de ofertas.
expose_video_content_genres_default Booleano Si true este perfil de visibilidad está asociado a un acuerdo mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que se dirijan al acuerdo no podrán dirigirse a géneros de contenido de vídeo (por ejemplo, comedia). Para obtener más detalles, consulte el Servicio de ofertas.
expose_video_program_types_default Booleano Si true este perfil de visibilidad está asociado a una oferta mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que segmenten la oferta no podrán dirigirse a tipos de programas de vídeo (por ejemplo, series). Para obtener más detalles, consulte el Servicio de ofertas.
expose_video_content_ratings_default Booleano Si true este perfil de visibilidad está asociado a una oferta mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que segmenten la oferta no podrán segmentar las clasificaciones de contenido de vídeo. Para obtener más detalles, consulte el Servicio de ofertas.
expose_video_content_duration_default Booleano Si true este perfil de visibilidad está asociado a un acuerdo mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que se dirijan al acuerdo no podrán dirigirse a duraciones de contenido de vídeo (por ejemplo, formato corto). Para obtener más detalles, consulte el Servicio de ofertas.
expose_video_content_networks_default Booleano Si true este perfil de visibilidad está asociado a una oferta mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que segmenten no podrán dirigirse a redes de contenido de vídeo. Para obtener más detalles, consulte el Servicio de ofertas.
expose_video_delivery_types_default Booleano Si true el perfil de visibilidad está asociado a una oferta mediante la segmentación restringida del vendedor, los compradores de Microsoft Invest que segmenten no podrán dirigirse a los tipos de entrega de vídeo (por ejemplo, VOD). Para obtener más detalles, consulte el Servicio de ofertas.

Categorías personalizadas

Si expose_custom_categories_default se establece en list, use esta matriz para especificar las categorías personalizadas que desea pasar en las solicitudes de licitación. Cada objeto de la matriz representa una única categoría personalizada y contiene los siguientes campos. En cuanto al formato, consulte los ejemplos siguientes.

Sugerencia

Puede usar el servicio de categorías de contenido para obtener los identificadores de las categorías de contenido personalizadas.

Campo Tipo Descripción
id Entero El identificador de la categoría de contenido personalizado que se pasa en las solicitudes de puja.
name string Solo lectura. Nombre de la categoría de contenido personalizado.

Miembros compradores

Esta matriz se usa para definir reglas de visibilidad para miembros específicos de la plataforma Xandr. Cada objeto de la matriz representa un único miembro y contiene los siguientes campos. En cuanto al formato, consulte los ejemplos siguientes.

Sugerencia

Puedes usar el Servicio para miembros de la plataforma para obtener las identificaciones de los miembros de la plataforma Xandr.

Campo Tipo Descripción
id Entero El identificador del miembro de la plataforma Xandr al que quieres aplicar reglas de visibilidad específicas.
Requerido en:POST
name string Solo lectura. El nombre del miembro de la plataforma Xandr.
expose_publishers Booleano No lo uses. Este campo se omite.
Para clientes seleccionados: Si true, los identificadores de editor se pasan en las solicitudes de oferta al miembro.
Valor predeterminado:true
expose_tags Booleano No lo uses. Este campo se omite.
Para clientes seleccionados: Si true, los identificadores de ubicación se pasan en las solicitudes de oferta al miembro.
Valor predeterminado:true
expose_age Booleano Si true, los datos de edad se pasan en sus solicitudes de oferta al miembro.
Valor predeterminado:true
expose_gender Booleano Si true, los datos de género se pasan en sus solicitudes de oferta al miembro.
Valor predeterminado:true
expose_universal_categories Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_custom_categories enumeración La visibilidad de las categorías de contenido personalizadas en las solicitudes de puja al miembro. Posibles valores:
- none: no se pasan categorías personalizadas en las solicitudes de puja.
- all: Todas las categorías personalizadas se pasan en las solicitudes de puja.
- list: las categorías personalizadas enumeradas en la matriz se pasan en las custom_categories solicitudes de licitación.
Valor predeterminado:none
custom_categories matriz de objetos Las categorías de contenido personalizado que se pasan en las solicitudes de puja al miembro. Para los campos de esta matriz, consulte Categorías personalizadas arriba.
Requerido en:POST, si expose_custom_categories_default es list.
url_exposure enumeración La visibilidad de las URL de inventario en las solicitudes de puja al miembro. Posibles valores:
- full: Se pasan direcciones URL completas en las solicitudes de puja.
- domain: Solo se pasan dominios de direcciones URL en las solicitudes de oferta.
- hidden: Las direcciones URL no se pasan en las solicitudes de puja.
Valor predeterminado:full
expose_bid_requests Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_auction_id Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_locale Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_ecp Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_reserve_price Booleano Si true, los precios de reserva están expuestos al miembro propietario.
Valor predeterminado:true
expose_user_id Booleano Si true, los id. de usuario se exponen al miembro propietario.
Valor predeterminado:true
expose_ip Booleano Si true, las direcciones IP se exponen al miembro propietario.
Valor predeterminado:true
expose_venue_id Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_user_agent Booleano Si true, los agentes de usuario se exponen al miembro propietario.
Valor predeterminado:true
expose_city Booleano Si true, las ciudades están disponibles para la selección de destino y los informes para el comprador de Microsoft Invest.
Valor predeterminado:true
expose_state Booleano Si true, los estados están disponibles para la segmentación y los informes para el comprador de Microsoft Invest.
Valor predeterminado:true
expose_dma Booleano Si true, los DMA están disponibles para la segmentación y los informes para el comprador de Microsoft Invest.
Valor predeterminado:true
expose_postal_code Booleano Si true, los códigos postales están expuestos al miembro propietario.
Valor predeterminado:true
expose_geo_lat_lon Booleano Si true, la información de latitud y longitud se expone al miembro propietario.
Valor predeterminado:true
expose_device_id Booleano Si true, los id. de dispositivo se exponen al miembro propietario.
Valor predeterminado:true
expose_device_model_id Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_querystring Booleano Si true, las cadenas de consulta se exponen al miembro propietario.
Valor predeterminado:true
expose_application_id Booleano Si true, los Id. de aplicaciones móviles Android o iOS se exponen al miembro propietario.
Valor predeterminado:true
expose_site_id Booleano Si true, los identificadores de grupo (sitio) de ubicación se exponen al miembro propietario.
Valor predeterminado:true
expose_datetime Booleano No lo uses. Este campo se omite.
Valor predeterminado:true

Licitadores

Utilice esta matriz para definir reglas de visibilidad para licitadores externos específicos o proveedores de datos contextuales. Cada objeto de la matriz representa un único postor y contiene los siguientes campos. En cuanto al formato, consulte los ejemplos siguientes.

Sugerencia

No existe un servicio para obtener directamente identificaciones de licitadores externos; sin embargo, el Servicio para Miembros de la Plataforma le brinda información sobre los miembros de la plataforma, incluidos los postores que están utilizando.

Campo Tipo Descripción
id Entero El identificador del ofertante externo al que quiere aplicar reglas de visibilidad específicas.
Requerido en:POST
name string Solo lectura. El nombre del licitador externo.
expose_publishers Booleano No lo uses. Este campo se omite.
Para clientes seleccionados: Si true, los identificadores de editor se pasan en sus solicitudes de oferta al ofertante.
Valor predeterminado:true
expose_tags Booleano No lo uses. Este campo se omite.
Para clientes seleccionados: Si true, los identificadores de ubicación se pasan en sus solicitudes de oferta al licitante.
Valor predeterminado:true
expose_age Booleano Si true, los datos de antigüedad se pasan en sus solicitudes de oferta al licitante.
Valor predeterminado:true
expose_gender Booleano Si true, los datos de género se pasan en sus solicitudes de oferta al licitador.
Valor predeterminado:true
expose_universal_categories Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_custom_categories enumeración La visibilidad de las categorías de contenido personalizadas en las solicitudes de puja al licitante.
Posibles valores:
- none: no se pasan categorías personalizadas en las solicitudes de puja.
- all: Todas las categorías personalizadas se pasan en las solicitudes de puja.
- list: las categorías personalizadas enumeradas en la matriz se pasan en las custom_categories solicitudes de licitación.
Valor predeterminado:none
custom_categories matriz de objetos Las categorías de contenido personalizado que se pasan en las solicitudes de licitación al licitante. Para los campos de esta matriz, consulte Categorías personalizadas arriba.
Requerido en:POST, si expose_custom_categories_default es list.
url_exposure enumeración La visibilidad de las URL de inventario en las solicitudes de puja al licitante.
Posibles valores:
- full: Se pasan direcciones URL completas en las solicitudes de puja.
- domain: Solo se pasan dominios de direcciones URL en las solicitudes de oferta.
- hidden: Las direcciones URL no se pasan en las solicitudes de puja.
Valor predeterminado:full
expose_bid_requests Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_auction_id Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_locale Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_ecp Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_reserve_price Booleano Si true, los precios de reserva se pasan en sus solicitudes de oferta al licitante.
Valor predeterminado:true
expose_user_id Booleano Si true, se pasan identificadores de usuario en sus solicitudes de oferta al licitante.
Valor predeterminado:true
expose_ip Booleano Si true, se pasan direcciones IP en sus solicitudes de oferta al licitante.
Valor predeterminado:true
expose_venue_id Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_user_agent Booleano Si true, los agentes de usuario pasaron sus solicitudes de oferta al licitante.
Valor predeterminado:true
expose_city Booleano Si true, las ciudades están disponibles para la selección de destino y los informes para el postor de Microsoft Invest.
Valor predeterminado:true
expose_state Booleano Si true, los estados están disponibles para la segmentación y los informes para el postor de Microsoft Invest.
Valor predeterminado:true
expose_dma Booleano Si true, los DMA están disponibles para la segmentación y los informes para el postor de Microsoft Invest.
Valor predeterminado:true
expose_postal_code Booleano Si true, los códigos postales se pasan en sus solicitudes de licitación al licitante.
Valor predeterminado:true
expose_geo_lat_lon Booleano Si true, se pasa información de latitud y longitud en sus solicitudes de oferta al licitante.
Valor predeterminado:true
expose_device_id Booleano Si true, los identificadores de dispositivo se pasan en sus solicitudes de oferta al ofertante.
Valor predeterminado:true
expose_device_model_id Booleano No lo uses. Este campo se omite.
Valor predeterminado:true
expose_querystring Booleano Si true, se pasan cadenas de consulta en sus solicitudes de oferta al licitante.
Valor predeterminado:true
expose_application_id Booleano Si true, se pasan identificadores de aplicaciones móviles Android o iOS en sus solicitudes de oferta al licitante.
Valor predeterminado:true
expose_site_id Booleano Si true, los identificadores de grupo de ubicación (sitio) se pasan en sus solicitudes de oferta al licitante.
Valor predeterminado:true
expose_datetime Booleano No lo uses. Este campo se omite.
Valor predeterminado:true

Ejemplos

Agregar un perfil de visibilidad: mostrar datos de inventario a todos los compradores excepto al miembro 9

En este ejemplo, la solicitud crea un perfil de visibilidad que permite a todos los miembros de la plataforma Xandr y postores externos, excepto el miembro 9, ver la información del editor, la ubicación, la POST edad, el sexo, la categoría y la URL en tus solicitudes de oferta.

$ cat visibility_profile

{
    "visibility-profile": {
        "name": "Test Visibility Profile",
        "expose_age_default": true,
        "expose_gender_default": true,
        "expose_custom_categories_default": "all",
        "url_exposure_default": "full",
        "expose_reserve_price_default": true,
        "expose_user_id_default": true,
        "expose_ip_default": true,
        "expose_user_agent_default": true,
        "expose_postal_code_default": true,
        "expose_geo_lat_lon_default": true,
        "expose_device_id_default": true,
        "expose_querystring_default": true,
        "expose_application_id_default": true,
        "expose_site_id_default": true,
        "buyer_members": [
            {
                "id": 9,
                "expose_age": false,
                "expose_gender": false,
                "expose_custom_categories": "none",
                "url_exposure": "hidden"
            }
        ]
    }
}

$ curl -b cookies -X POST -d @visibility_profile 'https://api.appnexus.com/visibility-profile'
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 1818,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1818,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": true,
            "expose_gender_default": true,
            "expose_custom_categories_default": "all",
            "url_exposure_default": "full",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:18:54",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": false,
                    "expose_gender": false,
                    "expose_custom_categories": "none",
                    "url_exposure": "hidden",
                    "expose_bid_requests": true,
                    "expose_reserve_price": true,
                    "expose_user_id": true,
                    "expose_ip": true,
                    "expose_user_agent": true,
                    "expose_postal_code": true,
                    "expose_geo_lat_lon": true,
                    "expose_device_id": true,
                    "expose_querystring": true,
                    "expose_application_id": true,
                    "expose_site_id": true,
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": null
        }
    }
}

Agregar un perfil de visibilidad - Ocultar datos de inventario de todos los compradores excepto el miembro 9

En este ejemplo, la solicitud crea un perfil de visibilidad que impide que todos los miembros de la plataforma Xandr y los postores externos, excepto el miembro 9, vean la información del editor, la ubicación, la POST edad, el sexo, la categoría y la dirección URL en las solicitudes de oferta.

$ cat visibility_profile

{
    "visibility-profile": {
        "name": "Test Visibility Profile",
        "expose_age_default": false,
        "expose_gender_default": false,
        "expose_custom_categories_default": "none",
        "url_exposure_default": "hidden",
        "expose_reserve_price_default": true,
        "expose_user_id_default": true,
        "expose_ip_default": true,
        "expose_user_agent_default": true,
        "expose_postal_code_default": true,
        "expose_geo_lat_lon_default": true,
        "expose_device_id_default": true,
        "expose_querystring_default": true,
        "expose_application_id_default": true,
        "expose_site_id_default": true,
        "buyer_members": [
            {
                "id": 9,
                "expose_age": true,
                "expose_gender": true,
                "expose_custom_categories": "all",
                "url_exposure": "full",
                "expose_bid_requests": true,
                "expose_reserve_price": true,
                "expose_user_id": true,
                "expose_ip": true,
                "expose_user_agent": true,
                "expose_postal_code": true,
                "expose_geo_lat_lon": true,
                "expose_device_id": true,
                "expose_querystring": true,
                "expose_application_id": true,
                "expose_site_id": true,
            }
        ]
    }

$ curl -b cookies -X POST -d @visibility_profile 'https://api.appnexus.com/visibility-profile'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 1819,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1819,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": false,
            "expose_gender_default": false,
            "expose_custom_categories_default": "none",
            "url_exposure_default": "hidden",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:57:13",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": true,
                    "expose_gender": true,
                    "expose_custom_categories": "all",
                    "url_exposure": "full",
                    "expose_reserve_price": true,
                    "expose_user_id": true,
                    "expose_ip": true,
                    "expose_user_agent": true,
                    "expose_postal_code": true,
                    "expose_geo_lat_lon": true,
                    "expose_device_id": true,
                    "expose_querystring": true,
                    "expose_application_id": true,
                    "expose_site_id": true,
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": null
        }
    }
}

Modificar perfil de visibilidad 1818

En este ejemplo, la solicitud actualiza el PUT perfil de visibilidad 1818 para permitir que solo se pase la categoría de contenido personalizado 24214 en las solicitudes de oferta. Esto se aplica a todos los miembros de la plataforma Xandr y a los licitadores externos, excepto el miembro de la plataforma 9, cuya visibilidad se define por separado (ver {{buyer_members}} matriz en la respuesta).

$ cat visibility_profile_update

{
    "visibility-profile": {
        "expose_custom_categories_default": "list",
        "custom_categories": [
            {
                "id": 24214
            }
        ]
    }
}

$ curl -b cookies -X PUT -d @visibility_profile_update 'https://api.appnexus.com/visibility-profile?id=1818'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "1818",
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1818,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": true,
            "expose_gender_default": true,
            "expose_custom_categories_default": "list",
            "url_exposure_default": "full",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:24:43",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": false,
                    "expose_gender": false,
                    "expose_custom_categories": "none",
                    "url_exposure": "hidden",
                    "expose_reserve_price": true,
                    "expose_user_id": true,
                    "expose_ip": true,
                    "expose_user_agent": true,
                    "expose_postal_code": true,
                    "expose_geo_lat_lon": true,
                    "expose_device_id": true,
                    "expose_querystring": true,
                    "expose_application_id": true,
                    "expose_site_id": true,
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": [
                {
                    "id": 24214,
                    "name": "TEST"
                }
            ]
        }
    }
}

Ver todos los perfiles de visibilidad

$ curl -b cookies 'https://api.appnexus.com/visibility-profile'

{
    "response": {
        "status": "OK",
        "count": 2,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profiles": [
            {
                "id": 1816,
                "member_id": 1066,
                "name": "Test Visibility Profile",
                "notes": null,
                "expose_age_default": true,
                "expose_gender_default": true,
                "expose_custom_categories_default": "list",
                "url_exposure_default": "full",
                "expose_reserve_price_default": true,
                "expose_user_id_default": true,
                "expose_ip_default": true,
                "expose_user_agent_default": true,
                "expose_postal_code_default": true,
                "expose_geo_lat_lon_default": true,
                "expose_device_id_default": true,
                "expose_querystring_default": true,
                "expose_application_id_default": true,
                "expose_site_id_default": true,
                "last_modified": "2015-08-31 18:14:45",
                "buyer_members": [
                    {
                        "id": 9,
                        "expose_age": true,
                        "expose_gender": true,
                        "expose_custom_categories": "none",
                        "url_exposure": "full",
                        "expose_reserve_price": true,
                        "expose_user_id": true,
                        "expose_ip": true,
                        "expose_user_agent": true,
                        "expose_postal_code": true,
                        "expose_geo_lat_lon": true,
                        "expose_device_id": true,
                        "expose_querystring": true,
                        "expose_application_id": true,
                        "expose_site_id": true,
                        "name": "DisplayWords Bidder - member 9",
                        "custom_categories": null
                    }
                ],
                "bidders": [
                    {
                        "id": 6,
                        "expose_age": true,
                        "expose_gender": true,
                        "expose_custom_categories": "none",
                        "url_exposure": "full",
                        "expose_reserve_price": true,
                        "expose_user_id": true,
                        "expose_ip": true,
                        "expose_user_agent": true,
                        "expose_postal_code": true,
                        "expose_geo_lat_lon": true,
                        "expose_device_id": true,
                        "expose_querystring": true,
                        "expose_application_id": true,
                        "expose_site_id": true,
                        "name": "Dilling HBF Test New",
                        "custom_categories": null
                    }
                ],
                "custom_categories": [
                    {
                        "id": 24214,
                        "name": "TEST"
                    }
                ]
            },
            {
                "id": 1818,
                "member_id": 1066,
                "name": "Test Visibility Profile",
                "notes": null,
                "expose_age_default": true,
                "expose_gender_default": true,
                "expose_custom_categories_default": "list",
                "url_exposure_default": "full",
                "expose_reserve_price_default": true,
                "expose_user_id_default": true,
                "expose_ip_default": true,
                "expose_user_agent_default": true,
                "expose_postal_code_default": true,
                "expose_geo_lat_lon_default": true,
                "expose_device_id_default": true,
                "expose_querystring_default": true,
                "expose_application_id_default": true,
                "expose_site_id_default": true,
                "last_modified": "2015-08-31 21:24:43",
                "buyer_members": [
                    {
                        "id": 9,
                        "expose_age": false,
                        "expose_gender": false,
                        "expose_custom_categories": "none",
                        "url_exposure": "hidden",
                        "expose_reserve_price": true,
                        "expose_user_id": true,
                        "expose_ip": true,
                        "expose_user_agent": true,
                        "expose_postal_code": true,
                        "expose_geo_lat_lon": true,
                        "expose_device_id": true,
                        "expose_querystring": true,
                        "expose_application_id": true,
                        "expose_site_id": true,
                        "name": "DisplayWords Bidder - member 9",
                        "custom_categories": null
                    }
                ],
                "bidders": null,
                "custom_categories": [
                    {
                        "id": 24214,
                        "name": "TEST"
                    }
                ]
            }
        ]
    }
}

Ver perfil de visibilidad 1818

$ curl -b cookies 'https://api.appnexus.com/visibility-profile?id=1818'

{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "visibility-profile": {
            "id": 1818,
            "member_id": 1066,
            "name": "Test Visibility Profile",
            "notes": null,
            "expose_age_default": true,
            "expose_gender_default": true,
            "expose_custom_categories_default": "list",
            "url_exposure_default": "full",
            "expose_reserve_price_default": true,
            "expose_user_id_default": true,
            "expose_ip_default": true,
            "expose_user_agent_default": true,
            "expose_postal_code_default": true,
            "expose_geo_lat_lon_default": true,
            "expose_device_id_default": true,
            "expose_querystring_default": true,
            "expose_application_id_default": true,
            "expose_site_id_default": true,
            "last_modified": "2015-08-31 21:24:43",
            "buyer_members": [
                {
                    "id": 9,
                    "expose_age": false,
                    "expose_gender": false,
                    "expose_custom_categories": "none",
                    "url_exposure": "hidden",
                    "name": "DisplayWords Bidder - member 9",
                    "custom_categories": null
                }
            ],
            "bidders": null,
            "custom_categories": [
                {
                    "id": 24214,
                    "name": "TEST"
                }
            ]
        }
    }
}
  • Last updated on