Servicio de perfil de visibilidad

Si vuelve a vender el inventario, el Servicio de perfil de visibilidad le permite controlar el nivel de detalle que se pasa a los compradores en las solicitudes de puja. En concreto, puede exponer u ocultar los identificadores y nombres del publicador, los identificadores y nombres de ubicación, los datos de edad y género proporcionados por el publicador, la categorización universal y personalizada del inventario, las direcciones URL de inventario, la información de ubicación, etc.

La configuración predeterminada del perfil (es decir, expose_age_default, , expose_gender_defaultetc.) se aplica a todos los compradores de plataforma y a los licitadores externos, pero puede invalidar la configuración predeterminada para compradores de plataformas específicos y licitadores externos mediante las buyer_members matrices y bidders . Por ejemplo, puede ocultar los datos de inventario de forma predeterminada y, a continuación, exponer los datos solo a miembros de compra específicos con los que tiene una relación empresarial especial. Como alternativa, puede exponer los datos de inventario a todos los usuarios excepto a los miembros de compra específicos que considere que son 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 los compradores ven cuando informan sobre las impresiones compradas. Por ejemplo, si oculta los identificadores y nombres del publicador a un comprador, ese comprador no verá los identificadores y nombres del publicador en los informes.

Nota:

Aunque puede crear varios perfiles de visibilidad, solo puede adjuntar uno a su miembro (consulte el visibility_profile_id campo en el servicio de miembros). Si está interesado en adjuntar perfiles de visibilidad directamente a los publicadores, póngase en contacto con su representante de cuenta.

API de REST

Http (método)	Endpoint	Description
POST	https://api.appnexus.com/visibility-profile (visibility_profile JSON)	Agregue 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	Elimine 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	Vea varios perfiles de visibilidad por identificador mediante una lista separada por comas.
GET	https://api.appnexus.com/visibility-profile/meta	Averigüe por qué campos puede filtrar y ordenar.

Campos JSON

Campo	Tipo	Descripción
id	Entero	Solo lectura. Identificador del perfil de visibilidad. Predeterminado: Número generado automáticamente (es decir, 123). Obligatorio On:PUT, en la cadena de consulta.
member_id	Entero	Solo lectura. Identificador del miembro propietario del perfil de visibilidad.
name	string	Nombre del perfil de visibilidad. Obligatorio activado:POST
notes	string	Información adicional sobre el perfil de visibilidad.
expose_publishers_default	Booleano	No usar. No está disponible para todos los clientes. Si truees , los identificadores del publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_tags_default	Booleano	No usar. No está disponible para todos los clientes. Si truees , los identificadores de ubicación se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_age_default	Booleano	Si truees , los datos de antigüedad proporcionados por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_gender_default	Booleano	Si truees , los datos de género proporcionados por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_universal_categories_default	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_custom_categories_default	enumeración	Visibilidad de las categorías de contenido personalizadas 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 custom_categories matriz se pasan en las solicitudes de puja. Predeterminado:none
url_exposure_default	enumeración	Visibilidad de las direcciones URL de inventario en las solicitudes de puja. Posibles valores: - full: las direcciones URL completas se pasan en las solicitudes de puja. - domain: solo se pasan dominios de direcciones URL en las solicitudes de puja. - hidden: las direcciones URL no se pasan en las solicitudes de puja. Predeterminado:full
expose_bid_requests_default	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_auction_id_default	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_locale_default	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_ecp_default	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_reserve_price_default	Booleano	Si truees , los precios de reserva proporcionados por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_user_id_default	Booleano	Si truees , los identificadores de usuario proporcionados por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_ip_default	Booleano	Si truees , las direcciones IP proporcionadas por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_venue_id_default	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_user_agent_default	Booleano	Si truees , los agentes de usuario proporcionados por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_city_default	Booleano	Si truees , las ciudades proporcionadas por el publicador están disponibles para dirigirse e informar a los compradores mediante Microsoft Invest. Esto se aplica a todos los miembros y pujadores de Microsoft Invest que no se establezcan por separado en las buyer_members matrices y bidders siguientes. Si true y este perfil de visibilidad están asociados a un acuerdo con la segmentación restringida de vendedores, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a ciudades. Para obtener más información, consulte el servicio Deal. Los compradores de DSP externos pueden dirigirse e informar sobre ciudades independientemente de esta configuración. Predeterminado:true
expose_state_default	Booleano	Si truees , los estados proporcionados por el publicador están disponibles para la segmentación y la generación de informes para los compradores que usan Microsoft Invest. Esto se aplica a todos los miembros y pujadores de Microsoft Invest que no se establezcan por separado en las buyer_members matrices y bidders siguientes. Si true y este perfil de visibilidad están asociados a una oferta con la segmentación restringida del vendedor, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a los estados. Para obtener más información, consulte el servicio Deal. Los compradores de csp externos pueden dirigirse a estados e informar de ellos, independientemente de esta configuración. Predeterminado:true
expose_dma_default	Booleano	Si truees , las DMA proporcionadas por el publicador están disponibles para dirigirse e informar a los compradores mediante Microsoft Invest. Esto se aplica a todos los miembros y pujadores de Microsoft Invest que no se establezcan por separado en las buyer_members matrices y bidders siguientes. Si true y este perfil de visibilidad están asociados a un acuerdo con la segmentación restringida del vendedor, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a las DMA. Para obtener más información, consulte el servicio Deal. Los compradores de DSP externos pueden dirigirse e informar sobre las DMA independientemente de esta configuración. Predeterminado:true
expose_postal_code_default	Booleano	Si truees , los códigos postales proporcionados por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_geo_lat_lon_default	Booleano	Si truees , la información de latitud y longitud proporcionada por el publicador se pasa en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_device_id_default	Booleano	Si truees , los identificadores de dispositivo proporcionados por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_device_model_id_default	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_querystring_default	Booleano	Si truees , las cadenas de consulta proporcionadas por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_application_id_default	Booleano	Si truees , los identificadores de aplicación móvil android o iOS proporcionados por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_site_id_default	Booleano	Si truees , los identificadores de grupo de selección de ubicación (sitio) proporcionados por el publicador se pasan en las solicitudes de puja. Esto se aplica a todos los miembros y pujadores de la plataforma que no se establecen por separado en las buyer_members matrices y bidders siguientes. Predeterminado:true
expose_datetime_default	Booleano	No usar. Este campo se omite.
buyer_members	matriz de objetos	Reglas de visibilidad para miembros específicos de la plataforma Xandr. Para obtener más información, consulte Miembros compradores a continuación. Predeterminado:true
bidders	matriz de objetos	Reglas de visibilidad para licitadores externos específicos o proveedores de datos contextuales. Para obtener más información, consulte Los licitadores a continuación.
custom_categories	matriz de objetos	Categorías de contenido personalizadas que se pasan en las solicitudes de puja. Para obtener más información, vea Categorías personalizadas a continuación. Obligatorio en:POST, si expose_custom_categories_default es list.
last_modified	Timestamp	Solo lectura. Fecha y hora en que se modificó por última vez el perfil de visibilidad.
expose_device_type_targets	Booleano	Si true y este perfil de visibilidad están asociados a una oferta con la segmentación restringida de vendedores, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a los tipos de dispositivo. Para obtener más información, consulte el servicio Deal.
expose_segment_groups_default	Booleano	Si true y este perfil de visibilidad están asociados a una oferta con la segmentación restringida de vendedores, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a segmentos. Para obtener más información, consulte el servicio Deal.
expose_video_context_default	Booleano	Si true y este perfil de visibilidad están asociados a una oferta con la segmentación restringida de vendedores, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a contextos de vídeo (por ejemplo, la versión preliminar). Para obtener más información, consulte el servicio Deal.
expose_video_content_genres_default	Booleano	Si true y este perfil de visibilidad están asociados a un acuerdo con la segmentación restringida de vendedores, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a los géneros de contenido de vídeo (por ejemplo, comedia). Para obtener más información, consulte el servicio Deal.
expose_video_program_types_default	Booleano	Si true y este perfil de visibilidad están asociados a un acuerdo con la segmentación restringida de vendedores, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a los tipos de programa de vídeo (por ejemplo, series). Para obtener más información, consulte el servicio Deal.
expose_video_content_ratings_default	Booleano	Si true y este perfil de visibilidad están asociados a un acuerdo con la segmentación restringida de vendedores, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a las clasificaciones de contenido de vídeo. Para obtener más información, consulte el servicio Deal.
expose_video_content_duration_default	Booleano	Si true y este perfil de visibilidad están asociados a un acuerdo con la segmentación restringida del vendedor, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a duraciones de contenido de vídeo (por ejemplo, formato corto). Para obtener más información, consulte el servicio Deal.
expose_video_content_networks_default	Booleano	Si true y este perfil de visibilidad están asociados a un acuerdo con la segmentación restringida del vendedor, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a redes de contenido de vídeo. Para obtener más información, consulte el servicio Deal.
expose_video_delivery_types_default	Booleano	Si true y este perfil de visibilidad están asociados a una oferta con la segmentación restringida de vendedores, los compradores de Microsoft Invest que tengan como destino la oferta no podrán dirigirse a los tipos de entrega de vídeo (por ejemplo, VOD). Para obtener más información, consulte el servicio Deal.

Categorías personalizadas

Si expose_custom_categories_default está establecido en list, use esta matriz para especificar las categorías personalizadas que desea pasar en las solicitudes de puja. Cada objeto de la matriz representa una sola categoría personalizada y contiene los campos siguientes. Para obtener formato, consulte los ejemplos siguientes.

Sugerencia

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

Campo	Tipo	Descripción
id	Entero	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 campos siguientes. Para obtener formato, consulte los ejemplos siguientes.

Sugerencia

Puede usar el servicio de miembro de la plataforma para obtener los identificadores de los miembros de la plataforma Xandr.

Campo	Tipo	Descripción
id	Entero	Identificador del miembro de la plataforma Xandr al que desea aplicar reglas de visibilidad específicas. Obligatorio activado:POST
name	string	Solo lectura. Nombre del miembro de la plataforma Xandr.
expose_publishers	Booleano	No usar. Este campo se omite. Para clientes seleccionados: si truees , los identificadores del publicador se pasan en las solicitudes de puja al miembro. Predeterminado:true
expose_tags	Booleano	No usar. Este campo se omite. Para clientes seleccionados: si truees , los identificadores de ubicación se pasan en las solicitudes de puja al miembro. Predeterminado:true
expose_age	Booleano	Si truees , los datos de antigüedad se pasan en las solicitudes de puja al miembro. Predeterminado:true
expose_gender	Booleano	Si truees , los datos de género se pasan en las solicitudes de puja al miembro. Predeterminado:true
expose_universal_categories	Booleano	No usar. Este campo se omite. 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 custom_categories matriz se pasan en las solicitudes de puja. Predeterminado:none
custom_categories	matriz de objetos	Categorías de contenido personalizadas que se pasan en las solicitudes de puja al miembro. Para ver los campos de esta matriz, vea Categorías personalizadas anteriores. Obligatorio en:POST, si expose_custom_categories_default es list.
url_exposure	enumeración	Visibilidad de las direcciones URL de inventario en las solicitudes de puja al miembro. Posibles valores: - full: las direcciones URL completas se pasan en las solicitudes de puja. - domain: solo se pasan dominios de direcciones URL en las solicitudes de puja. - hidden: las direcciones URL no se pasan en las solicitudes de puja. Predeterminado:full
expose_bid_requests	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_auction_id	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_locale	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_ecp	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_reserve_price	Booleano	Si truees , los precios de reserva se exponen al miembro propietario. Predeterminado:true
expose_user_id	Booleano	Si truees , los identificadores de usuario se exponen al miembro propietario. Predeterminado:true
expose_ip	Booleano	Si truees , las direcciones IP se exponen al miembro propietario. Predeterminado:true
expose_venue_id	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_user_agent	Booleano	Si truees , los agentes de usuario se exponen al miembro propietario. Predeterminado:true
expose_city	Booleano	Si truees , las ciudades están disponibles para dirigirse e informar al comprador de Microsoft Invest. Predeterminado:true
expose_state	Booleano	Si truees , los estados están disponibles para la segmentación y la generación de informes para el comprador de Microsoft Invest. Predeterminado:true
expose_dma	Booleano	Si truees , las DMA están disponibles para la segmentación y la generación de informes para el comprador de Microsoft Invest. Predeterminado:true
expose_postal_code	Booleano	Si truees , los códigos postales se exponen al miembro propietario. Predeterminado:true
expose_geo_lat_lon	Booleano	Si true, la información de latitud y longitud se expone al miembro propietario. Predeterminado:true
expose_device_id	Booleano	Si truees , los identificadores de dispositivo se exponen al miembro propietario. Predeterminado:true
expose_device_model_id	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_querystring	Booleano	Si truees , las cadenas de consulta se exponen al miembro propietario. Predeterminado:true
expose_application_id	Booleano	Si true, los identificadores de aplicación móvil de Android o iOS se exponen al miembro propietario. Predeterminado:true
expose_site_id	Booleano	Si truees , los identificadores de grupo de selección de ubicación (sitio) se exponen al miembro propietario. Predeterminado:true
expose_datetime	Booleano	No usar. Este campo se omite. Predeterminado:true

Licitadores

Esta matriz se usa para definir reglas de visibilidad para licitadores externos específicos o proveedores de datos contextuales. Cada objeto de la matriz representa un único pujador y contiene los campos siguientes. Para obtener formato, consulte los ejemplos siguientes.

Sugerencia

No hay ningún servicio para obtener directamente los identificadores de licitador externo; sin embargo, el Servicio para miembros de la plataforma obtiene información sobre los miembros de la plataforma, incluidos los licitadores que usan.

Campo	Tipo	Descripción
id	Entero	Identificador del licitador externo al que desea aplicar reglas de visibilidad específicas. Obligatorio activado:POST
name	string	Solo lectura. Nombre del licitador externo.
expose_publishers	Booleano	No usar. Este campo se omite. Para clientes seleccionados: si truees , los identificadores del publicador se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_tags	Booleano	No usar. Este campo se omite. Para clientes seleccionados: si truees , los identificadores de ubicación se pasan en las solicitudes de puja al pujador. Predeterminado:true
expose_age	Booleano	Si truees , los datos de edad se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_gender	Booleano	Si truees , los datos de género se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_universal_categories	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_custom_categories	enumeración	La visibilidad de las categorías de contenido personalizadas en las solicitudes de puja al licitador. 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 custom_categories matriz se pasan en las solicitudes de puja. Predeterminado:none
custom_categories	matriz de objetos	Categorías de contenido personalizadas que se pasan en las solicitudes de puja al licitador. Para ver los campos de esta matriz, vea Categorías personalizadas anteriores. Obligatorio en:POST, si expose_custom_categories_default es list.
url_exposure	enumeración	Visibilidad de las direcciones URL de inventario en las solicitudes de puja al licitador. Posibles valores: - full: las direcciones URL completas se pasan en las solicitudes de puja. - domain: solo se pasan dominios de direcciones URL en las solicitudes de puja. - hidden: las direcciones URL no se pasan en las solicitudes de puja. Predeterminado:full
expose_bid_requests	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_auction_id	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_locale	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_ecp	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_reserve_price	Booleano	Si truees , los precios de reserva se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_user_id	Booleano	Si truees , los identificadores de usuario se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_ip	Booleano	Si truees , las direcciones IP se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_venue_id	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_user_agent	Booleano	Si truees , los agentes de usuario pasaron las solicitudes de puja al licitador. Predeterminado:true
expose_city	Booleano	Si truees , las ciudades están disponibles para dirigirse e informar al postor de Microsoft Invest. Predeterminado:true
expose_state	Booleano	Si truees , los estados están disponibles para la segmentación y la generación de informes para el postor de Microsoft Invest. Predeterminado:true
expose_dma	Booleano	Si truees , las DMA están disponibles para dirigirse e informar al postor de Microsoft Invest. Predeterminado:true
expose_postal_code	Booleano	Si truees , los códigos postales se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_geo_lat_lon	Booleano	Si truese pasa información de latitud y longitud en las solicitudes de puja al licitador. Predeterminado:true
expose_device_id	Booleano	Si truees , los identificadores de dispositivo se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_device_model_id	Booleano	No usar. Este campo se omite. Predeterminado:true
expose_querystring	Booleano	Si truees , las cadenas de consulta se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_application_id	Booleano	Si truelos identificadores de aplicación móvil de Android o iOS se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_site_id	Booleano	Si truees , los identificadores del grupo de selección de ubicación (sitio) se pasan en las solicitudes de puja al licitador. Predeterminado:true
expose_datetime	Booleano	No usar. Este campo se omite. Predeterminado:true

Ejemplos

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

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

$ 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 los datos de inventario de todos los compradores excepto el miembro 9

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

$ 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
        }
    }
}

Modificación del 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 personalizada 24214 en las solicitudes de puja. Esto se aplica a todos los miembros de la plataforma Xandr y a los licitadores externos, excepto al miembro de la plataforma 9, cuya visibilidad se define por separado (consulte {{buyer_members}} la 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"
                }
            ]
        }
    }
}

Visualización de 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"
                    }
                ]
            }
        ]
    }
}

Visualización del 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"
                }
            ]
        }
    }
}