Leer en inglés

Compartir a través de


Licitadores: solicitud de puja

Importante

  • No compatible: ya no se admite el protocolo de licitación appNexus; esta documentación es solo para fines heredados. Dejaremos de usar este protocolo el 1 de diciembre de 2018.
  • Si es un nuevo licitador que se integra con AppNexus, consulte el Protocolo de licitación de OpenRTB 2.4.

Se envía una solicitud de puja a los licitadores cada vez que una llamada de anuncio llega al Autobús de impresiones. Contiene toda la información necesaria para que un postor produzca un precio de oferta y un creativo para servir.

La solicitud de puja incluye información de vendedores que especifica qué anunciantes y creativos pueden ganar una subasta y ejecutarse en una página. Esta información se almacena en un perfil de aprobación de anuncios, que los licitadores pueden usar para asegurarse de que se aceptan sus ofertas.

Solicitudes de puja de limitación

Es posible que no desee recibir todas las solicitudes de puja que pasan a través de la plataforma AppNexus. Puede limitar las solicitudes en algún porcentaje o filtrar las solicitudes por criterios preestablecidos, como geography.

Solicitudes de puja con varias etiquetas

A veces se envían "solicitudes de puja de varias etiquetas", donde una solicitud de puja puede incluir varios identificadores de etiqueta con tamaños potencialmente diferentes, estándares de calidad de anuncios, precios de reserva, etc. Por ahora, estas solicitudes deben controlarse con respuestas individuales para cada etiqueta como si fueran solicitudes independientes. Sin embargo, en un futuro próximo, estas solicitudes de varias etiquetas serán la base para las adquisiciones, las compras a página completa y muchas otras características de inventario premium.

Cada etiqueta individual de una solicitud de varias etiquetas tiene un identificador de subasta único.

Implementación

Encabezados de solicitud

Campo Ámbito Tipo Description
Connection todo string Establezca siempre en "keep-alive" para garantizar conexiones TCP persistentes.
Content-Length todo Entero Longitud del cuerpo de la solicitud HTTP (que incluye todos los campos descritos a continuación).
Host todo string Dirección IP a la que se ha enviado la solicitud de puja.
X-Debug Algunos Entero Si se establece en 1, la llamada al anuncio incluyó la marca debug=1 y no se mostrará ningún anuncio.
X-DMA Algunos Entero Código para el área de mercado designada del usuario en función de la dirección IP, si se puede determinar.
X-Exclusive Algunos Entero Indica si la subasta es exclusiva de forma predeterminada. Una subasta exclusiva es aquella en la que solo el propietario de la ubicación puede publicar un anuncio. El propietario puede invalidar el valor predeterminado exclusivo durante la fase de propietario de la subasta.
X-Segment Algunos string Lista separada por comas de los segmentos en los que se encuentra el usuario. Entre los segmentos disponibles se incluyen los que pertenecen a sus miembros y los que pertenecen a proveedores de datos de terceros (a los que AppNexus ha concedido acceso al licitador).
X-Venue todo Entero Este encabezado no se usa actualmente.

Información de la subasta

Datos generales

Campo Ámbito Tipo Description
member_ad_profile_id Algunos Entero Identificador del perfil de aprobación de anuncios de nivel de miembro que se aplica a la impresión.
timestamp todo Timestamp Hora de envío de la solicitud.
bidder_timeout_ms todo Entero Número de milisegundos que tiene el licitador desde el momento en que el imp bus envía la solicitud hasta el momento en que el imp bus recibe la respuesta antes del tiempo de espera. Este número variará según el asociado de suministro.
bid_info todo object Detalles sobre el usuario y la solicitud de puja en general. Consulte Bid_Info a continuación para obtener más información.
members todo matriz de objetos Una matriz de miembros que son aptos para pujar en esta llamada. Un miembro es una entidad que tiene una relación de compra o venta financiera con AppNexus y está asociada con un postor. Algunos licitadores pueden tener varios miembros; si está creando un postor para su propio uso exclusivo, será el único miembro. El objeto miembro tiene el identificador del miembro. Consulte Miembros a continuación para obtener más información.

Nota: Esto no es una matriz de números, es una matriz de objetos. La sintaxis exacta se indica en el ejemplo siguiente.
tags todo matriz de objetos Matriz de las etiquetas que se subastan en esta llamada. Una subasta tendrá al menos una, pero puede tener varias etiquetas. Consulte Etiquetas a continuación para obtener más información.

Datos específicos del propietario

Campo Ámbito Tipo Description
allow_exclusive Algunos Booleano Si el miembro de la puja posee el inventario (es decir, member_id de etiqueta = id. de miembro del licitador), el miembro puede servir en él sin permitir que otros licitadores participen.

Depuración de datos

Campo Ámbito Tipo Description
debug_requested Algunos Booleano Si es true, la llamada de anuncio incluyó la debug=1 marca y no se mostrará ningún anuncio. Esto solo se incluirá en la solicitud de puja si se usa el dongle correcto.
debug_member_id Algunos Entero Este campo contendrá el valor del parámetro "debug_member", si el parámetro se pasa en la cadena de consulta y el parámetro "dongle" pasado en la cadena de consulta coincide con el dongle del miembro (establecido en el servicio miembro). El licitador puede usar el debug_member_id para generar una salida de depuración limitada a un miembro determinado.
test Algunos Booleano Si es true, la etiqueta de anuncio se ejecuta como prueba y no se mostrará ningún anuncio. Si no está presente, la prueba es false.

Otros datos

Campo Ámbito Tipo Description
excluded_adservers Algunos matriz de enteros Los identificadores de los servidores de anuncios que no son aptos para la impresión, tal como se define en la configuración de calidad de anuncios del vendedor. Puede usar el servicio ad server para buscar servidores de anuncios.
excluded_brands Algunos matriz de enteros Los identificadores de las marcas que no son aptos para la impresión, tal como se define en la configuración de calidad del anuncio del vendedor. Puede usar el Servicio de marca para buscar marcas.
excluded_languages Algunos matriz de enteros Los identificadores de idiomas que no son aptos para la impresión, tal como se define en la configuración de calidad de anuncios del vendedor. Puede usar language service para buscar idiomas.
excluded_categories Algunos matriz de enteros Los identificadores de categorías que no son aptos para la impresión, tal como se define en la configuración de calidad del anuncio del vendedor. Puede usar el servicio category para buscar categorías.
excluded_creatives Algunos matriz de enteros Los identificadores de los creativos que no son aptos para la impresión, tal como se define en la configuración de calidad del anuncio del vendedor. Puede usar creative service para buscar creatividades.
excluded_technical_attributes Algunos matriz de enteros Los identificadores de atributos técnicos que no son aptos para la impresión, tal como se define en la configuración de calidad de anuncios del vendedor. Puede usar el Servicio de atributos técnicos para buscar atributos técnicos.
single_phase Algunos Booleano Este campo no se usa actualmente para los licitadores.

Members

Campo Ámbito Tipo Description
id todo Entero El identificador del miembro.

Etiquetas

Información asociada a la etiqueta de anuncio.

Datos de la subasta

Campo Ámbito Tipo Description
auction_id_64 todo Entero Identificador de la subasta. Esto resulta útil para la conciliación y las discrepancias, por lo que se recomienda agregarlo a los registros. No se garantiza que sea único.

Datos de jerarquía de inventario

Campo Ámbito Tipo Description
id Algunos Entero Identificador de TinyTag. Una etiqueta es un subconjunto de inventario dentro de un sitio. Los licitadores no pueden buscar a qué etiqueta corresponde el identificador, pero estos identificadores se pueden usar como fragmentos de inventario anónimos y optimizados.
site_id Algunos Entero Identificador del sitio. Los sitios son las segundas agrupaciones de inventario más grandes para los miembros que venden su inventario a través de AppNexus. Un sitio es un subconjunto del inventario de un publicador. Los licitadores no pueden buscar a qué sitio corresponde el identificador, pero estos identificadores se pueden usar como fragmentos de inventario anónimos y optimizados.

Datos generales

Campo Ámbito Tipo Description
size todo string Un tamaño (widthxheight; por ejemplo, 300x160) para esta impresión.
sizes todo matriz de cadenas Tamaños creativos permitidos para esta impresión, dados en formato "widthxheight".
position todo enum("below","above","unknown") Posición del anuncio en la página por encima o por debajo del pliegue; tomado de la etiqueta, si está disponible.
tag_format Algunos enum("iframe", "js", "wp7", "vast", "json", "xml") En el caso de las etiquetas "iframe", el bus de impresiones devolverá HTML para mostrar la creatividad ganadora en la página del publicador (si es necesario, el HTML contendrá una etiqueta IFrame). En el caso de las etiquetas "js", el bus de impresiones devolverá javascript para ejecutarse en la página del publicador. (El javascript devuelto normalmente contendrá comandos document.write para generar el CÓDIGO HTML para mostrar la creatividad). Esta distinción solo es relevante para los licitadores en el caso de que una creatividad no se muestre correctamente en uno o varios formatos de etiqueta.
allowed_media_types Algunos matriz de enteros Tipos de medios válidos. Use el servicio de tipo multimedia para obtener una lista de identificadores.
allowed_media_subtypes Algunos matriz de enteros Identificadores de subtipo de medios válidos. Use el servicio subtipo multimedia para obtener una lista de identificadores.
media_subtypes Algunos matriz de cadenas Subtipos de medios válidos para una creatividad, en formato de cadena.
inventory_audits Algunos matriz Datos de auto-clasificación del vendedor sobre el contenido del sitio.
venue_id Algunos Entero Este campo no se usa actualmente para los licitadores.
ad_profile_id Algunos Entero Identificador del perfil de aprobación de anuncios de nivel de etiqueta que se aplica a la impresión de la etiqueta determinada.
predicted_view_rate todo double Probabilidad de que el usuario pueda ver la impresión en función de los datos históricos.

Datos de precios

Campo Ámbito Tipo Description
reserve_price Algunos float Cuando se proporciona, esta es la oferta mínima necesaria para ganar la subasta. Si el miembro de puja posee el inventario (allow_exclusive = true), se omite.
estimated_clear_price Algunos double El ECP es el precio estimado necesario para ganar el inventario. El ECP es mayor que el 95 % de todas las ofertas ganadoras de esta etiqueta enviadas a través de AppNexus.

Nota: Es posible que el porcentaje significativo de pujas ganadoras de cualquier etiqueta no se envíe a través de AppNexus.

Consulte Mecánicas de reducción de precios para obtener más información.
estimated_average_price Algunos double El EAP es similar al ECP, salvo que el EAP es mayor que el 70 % de todas las pujas ganadoras de esta etiqueta enviadas a través de AppNexus.
estimated_price_verified Algunos Booleano Este campo indica si appNexus ha comprobado el EAP y ECP mediante los datos observados.

Datos específicos del propietario

Campo Ámbito Tipo Description
tag_data solo propiedad string Si está disponible, la otra información asociada a este id. de TinyTag. El propietario del TinyTag puede agregar esta información al TinyTag antes de una subasta.
exclusive_default solo propiedad Booleano Indica si la subasta es exclusiva de forma predeterminada. Una subasta exclusiva es aquella en la que solo el propietario de la ubicación puede publicar un anuncio. El propietario puede invalidar el valor predeterminado exclusivo durante la fase de propietario de la subasta.
default_creative_id solo propiedad Entero El identificador creativo predeterminado de este TinyTag.

Campos específicos para dispositivos móviles

Campo Ámbito Tipo Description
supply_type Algunos Siempre se envía para "mobile_app" (no se envía para "web") Distingue si este inventario es Web, Mobile Browser o Mobile App. Para determinar si se está viendo una impresión web en un dispositivo móvil, use el sistema operativo en la solicitud de puja.
creative_formats Algunos Uno o varios de "text", "image", "html-url", "js-url", "flash", "js-raw", "html-raw", "html-iframe", "url-vast", "xml-url", "file-url", unknown" Lista de formatos creativos de AppNexus que se pueden usar para pujar por la impresión. Se pueden agregar otros formatos a esta lista a medida que se admitan.
creative_actions Algunos Uno o varios de "click-to-web", "click-to-call" Lista de acciones de clic permitidas de las creatividades que se pueden usar para pujar por esta impresión. En la actualidad, el clic para llamar no está disponible, pero estará disponible pronto. Se pueden agregar otras acciones a esta lista a medida que se admitan.
smaller_sizes_allowed Algunos Booleano True si también se pueden usar creativos de un tamaño más pequeño y creativos de texto para pujar por la impresión.

Datos de transacción

Campo Ámbito Tipo Description
deals Algunos matriz de objetos Matriz de ofertas que se aplican a la impresión. Consulte Ofertas para obtener más información.

Ofertas

Cada objeto de la deals matriz contiene los campos siguientes.

Campo Tipo Description
ad_quality_override Entero Especifica cómo controla la oferta las creatividades:
- 1: los creativos usan la configuración de calidad de anuncios existente. (Predeterminado)
- 2: las creatividades en estado de auditoría "pendiente" servirán. Una vez auditadas estas creatividades, se usa la configuración de calidad de anuncios existente.
- 3: no se aplicarán restricciones de perfil de anuncio a esta oferta. (Confianza máxima)
allowed_media_subtypes matriz de enteros. Especifica los identificadores de los subtipos multimedia que se permiten en esta oferta. Use el servicio de subtipos multimedia para ver una lista de subtipos multimedia. Si no hay subtipos multimedia únicos para esta oferta en comparación con el objeto de solicitud de puja principal, este campo será una matriz vacía. Esto NO significa que la oferta no permita ningún subtipo multimedia, sino que solo significa que los subtipos multimedia del objeto de puja principal deben usarse al pujar por esta oferta.
allowed_media_types matriz de enteros. Especifica los identificadores de los tipos de medios que se permiten en esta oferta. Use el servicio de tipos de medios para ver una lista de tipos de medios. Si no hay ningún tipo de medio único para esta oferta en comparación con el objeto de solicitud de puja principal, este campo será una matriz vacía. Esto NO significa que la oferta no permita ningún tipo de medio, sino que solo significa que los tipos de medios del objeto de puja principal deben usarse al pujar por esta oferta.
floor_cpm double El precio que el vendedor ha establecido para la oferta. Use esta cantidad más las tarifas aplicables como oferta mínima para competir por este inventario. Tenga en cuenta que pujar por esta cantidad más las tarifas aplicables le ayudará a asegurarse de que es elegible para la oferta, pero no garantizará que su oferta gane.
Esta cantidad siempre estará en dólares estadounidenses. Los precios de ask especificados en otra moneda se convertirán en dólares.
id Entero Identificador de la oferta que se aplica a la impresión. Puede usar el servicio Deal Buyer Access para ver los detalles de la oferta, incluidos el nombre de la oferta, la descripción, la fecha de inicio y finalización y el inventario asociado.
member_id Entero Identificador del miembro comprador para el que se creó la oferta.
sizes matriz de cadenas. Tamaños creativos permitidos para esta oferta, dados en formato "widthxheight". Si no hay tamaños únicos para esta oferta en comparación con el objeto de solicitud de puja principal, este campo será una matriz vacía. Esto NO significa que la oferta no permita ningún tamaño, sino que solo significa que los tamaños del objeto de puja principal deben usarse al pujar por esta oferta.

Bid_Info

Información sobre el usuario y la solicitud de puja general.

Usuario

Campo Ámbito Tipo Description
user_id_64 todo Entero Identificador único de 64 bits para el usuario. Será igual para todas las solicitudes de este usuario hasta que se borren las cookies.

Nota: Este valor solo se rellena cuando el campo no_cookies es false.

Este campo es 0 cuando AppNexus no tiene una coincidencia para este usuario o el explorador del usuario no acepta cookies. -1 Será para usuarios no participar.
user_agent Algunos string Encabezado "User-Agent" desde el explorador. (En otras palabras, el tipo de explorador).
operating_system Algunos Entero Identificador del sistema operativo del usuario. Puede usar el servicio de sistema operativo para asignar identificadores de sistema operativo a nombres.
browser Algunos Entero Identificador del explorador del usuario. Puede usar el Servicio de explorador para asignar identificadores de explorador a nombres.
accepted_languages Algunos string Encabezado "Accept-Language" desde el explorador (con códigos de país ISO-639 e ISO-3166).
language Algunos Entero Identificador del idioma analizado a partir de la cadena de accepted_languages. Puede usar language service para asignar idiomas a nombres.
no_flash todo booleano Informa al pujador si hemos detectado que el explorador del usuario no tiene flash instalado.
no_cookies todo booleano Si el no_cookies campo está establecido en false
- AppNexus es capaz de realizar un seguimiento del usuario a través de un id. de usuario que se coloca en una cookie en el explorador del usuario.
- El identificador de usuario se incluirá en el user_id_64 campo de la solicitud de puja.

Si el no_cookies campo está establecido en true AND, el user_id_64 campo se establece en 0
- AppNexus no puede realizar un seguimiento del usuario, ya que el navegador del usuario no acepta cookies.
- No debe pujar por dicha subasta en nombre de campañas que requieran datos de usuario (por ejemplo, límite de frecuencia, límite de censura).

Si el no_cookies campo está establecido en true AND, el user_id_64 campo es distinto de cero
- AppNexus es capaz de realizar un seguimiento del usuario a través de cookies, y el campo user_id_64 contiene el id. de usuario.
- Sin embargo, se produjo un problema al buscar información de usuario en el almacén de datos de usuario del lado servidor de AppNexus.
- Como resultado, la solicitud de puja no incluirá datos de usuario, ni AppNexus podrá actualizar de forma confiable los datos de usuario en función de los comandos enviados en la respuesta de la puja.
- No debe pujar por dicha subasta en nombre de campañas que requieran datos de usuario (por ejemplo, límite de frecuencia, límite de censura).
gender Algunos enumeración "macho" o "mujer": estos datos pueden ser suministrados por el editor en el momento de la subasta.
age Algunos Entero El editor puede proporcionar estos datos en el momento de la subasta.
segments todo matriz de objetos. Matriz de los segmentos en los que se encuentra el usuario. Entre los segmentos disponibles se incluyen los que pertenecen a sus miembros y los que pertenecen a proveedores de datos de terceros (a los que AppNexus ha concedido acceso al licitador). Se describe con más detalle a continuación.
session_freq todo Entero El número de impresiones que AppNexus ha proporcionado a este usuario durante la sesión de exploración. Para estos fines, una sesión de exploración se define como la duración de la cookie AppNexus del usuario.
pub_session_freq todo Entero El número de impresiones que AppNexus ha proporcionado a este usuario, en este publicador, durante la sesión de exploración. Para estos fines, una sesión de exploración se define como la duración de la cookie AppNexus del usuario.

Datos geográficos

Campo Ámbito Tipo Description
ip_address todo string Dirección IP del usuario.
country Algunos string El país del usuario en función de la dirección IP, si se puede determinar.
region Algunos string Región (estado o provincia) del usuario en función de la dirección IP, si se puede determinar.
city Algunos string La ciudad del usuario en función de la dirección IP.
postal_code_id Algunos Entero Identificador del código postal del usuario, basado en la dirección IP.
dma Algunos Entero Código para el área de mercado designada del usuario en función de la dirección IP, si se puede determinar.
time_zone Algunos string Zona horaria del usuario en función de la dirección IP, si se puede determinar.
Campo Ámbito Tipo Description
userdata_json Algunos Los datos de usuario adjuntos a la cookie del usuario almacenados por el licitador que recibe la solicitud.
total_clicks Algunos Entero Este campo ha quedado en desuso.

Información de inventario (página)

Campo Ámbito Tipo Description
selling_member_id todo Entero Identificador del miembro que vende el inventario. Consulte Servicio para miembros de la plataforma para buscar los nombres de miembro correspondientes.
url Algunos string La dirección URL de referencia (contiene el anuncio o inicia la solicitud de anuncio). Esto siempre se proporciona si está disponible, a menos que el publicador haya elegido restringir su uso. Un publicador también puede optar por configurar una dirección URL de referencia predeterminada en AppNexus que se pasará a la solicitud de puja en caso de que el referenciador no esté disponible o el publicador haya elegido restringir su uso. Póngase en contacto con su representante técnico de AppNexus para obtener más información.
domain Algunos string Dominio de la dirección URL de referencia.
inventory_audits Algunos matriz AppNexus audita los datos sobre el contenido del sitio. Las auditorías de bid_info pertenecen a todas las etiquetas de la subasta. Esta información suele provenir de una auditoría de nivel de dominio. Se describe con más detalle a continuación.
within_iframe todo booleano Si la etiqueta se encuentra en la página sin incluir iframes, es 'true'. Tenga en cuenta que si AppNexus no puede determinar si la etiqueta está encapsulada, será 'false'.
publisher_id Algunos Entero Identificador del publicador. Los publicadores se usan como las agrupaciones de inventario más grandes para los miembros que venden su inventario a través de AppNexus. Los licitadores no pueden buscar a qué publicador corresponde el identificador, pero estos identificadores se pueden usar como fragmentos de inventario anónimos y optimizados.
is_secure Algunos booleano Si la página es segura, esto es true.

Nota: Todas las conexiones para proteger el inventario deben ser seguras. Esto incluye píxeles, creatividades y llamadas de terceros. (es decir, para un creativo: https://mysecure.content.com/ad/ABC.123.com/DEF.40;sz=300x250) \\)
certified_supply Algunos booleano En desuso.

Campos específicos para dispositivos móviles

Campo Ámbito Tipo Description
app_id Algunos string Id. de aplicación global para dispositivos Android e iOS (por ejemplo, para la aplicación Angry Birds: "app_id": "com.rovio.angrybirds" para un dispositivo Android, "app_id" : "343200656" o "com.clickgamer.AngryBirds" para un dispositivo iOS).
loc Algunos string Ubicación del usuario, proporcionada en términos de latitud y longitud. Expresado en el formato "snnn.ddd,snnn.ddd", por ejemplo +123.456 o -456.123. El sur y el oeste se representan como negativos. Puede haber un máximo de 5 posiciones decimales de precisión.
carrier Algunos Entero Identificador del operador. Una asignación de identificadores a nombres de operador y países estará disponible en el servicio de solo lectura del operador. Un operador especial "WIFI" existirá para los usuarios que se conectan a través de WiFi.
device_make Algunos Entero El identificador del dispositivo en el que se mostrará el anuncio. Puedes usarlo para el fabricante del dispositivo en el que se mostrará el anuncio. Para obtener más información, consulte Device Make Service.
device_model Algunos Entero Identificador del modelo de dispositivo en el que se mostrará el anuncio. Para obtener más información, consulte Device Model Service.
device_type Algunos Entero Identificador del tipo de dispositivo en el que se mostrará el anuncio. Esto se representa mediante un entero y se puede buscar mediante device model service. Valores permitidos y sus significados:
- 1 = "pc"
- 2 = "phone"
- 3 = "tablet"
device_ids Algunos object Objeto JSON que contiene información sobre los identificadores de dispositivo asociados a la impresión de puja. Para obtener más información, consulte Id. de dispositivo.

Id. de dispositivos

Campo Ámbito Tipo Description
aaid Algunos string El identificador de publicidad de Google para dispositivos Android recuperado de los servicios de Google Play.
idfa Algunos string Identificador de publicidad de Apple para dispositivos iOS que ejecutan iOS 6+.
md5udid Algunos string Hash MD5 de .ANDROID_ID Esto solo debe enviarse para dispositivos Android. Debe estar codificado como dirección URL.
openudid Algunos string OpenUDID del dispositivo. Esto solo debe enviarse para las versiones 5 y posteriores de iOS.
sha1mac Algunos string ODIN. Esto solo debe enviarse para las versiones 5 y posteriores de iOS. Debe estar codificado en url.
sha1udid Algunos string Hash SHA1 de ANDROID_ID. Esto solo debe enviarse para dispositivos Android. Debe estar codificado como dirección URL.

Segmentos

Matriz de los segmentos en los que se encuentra el usuario. Entre los segmentos disponibles se incluyen los que pertenecen a sus miembros y los que pertenecen a proveedores de datos de terceros (a los que AppNexus ha concedido acceso al licitador).

Campo Ámbito Tipo Description
code Algunos string Consulte Servicios de píxeles para obtener más información.
id todo Entero Id. de segmento.
last_seen_min todo Entero El número de minutos transcurridos desde que este usuario se etiquetó por última vez con este segmento. Dado en tiempo posix (representado en minutos). Multiplique este valor por 60 para obtener el número de segundos desde la época en que se actualizó este segmento.
member_id todo Entero Identificador del miembro asociado a este segmento.
other Algunos Entero Valor del segmento, si el segmento contiene un valor.

Auditorías de inventario

Campo Ámbito Tipo Description
auditor_member_id todo Entero Identificador del miembro que proporcionó esta auditoría. Si este campo es NULL, el equipo de operaciones de la plataforma realizó la auditoría.
content_categories Algunos matriz de enteros. Identificadores de categorías de contenido del sitio. Para obtener los nombres significativos de categorías de contenido específicas o para la lista completa, consulte Servicio de categorías de contenido.

Nota: Es posible que vea identificadores en esta lista que no son visibles en el servicio de categoría de contenido.
intended_audience Algunos enumeración general, niños, young_adult o maduros. Indica el nivel de madurez objetivo de los lectores de este sitio web.
inventory_attributes Algunos matriz de enteros. Identificadores de atributos confidenciales del sitio en los que algunos anunciantes pueden optar por no ejecutarse. Para obtener los nombres significativos de atributos específicos o para la lista completa, consulte Servicio de atributos de inventario. La presencia de una matriz vacía en este campo indica que el sitio se ha auditado y se ha detectado que no tiene atributos confidenciales.

Ejemplo

Solicitud de etiqueta única

{
    "bid_request": {
        "timestamp": "2015-06-07 14:39:35",
        "bidder_timeout_ms": 100,
        "members": [
            {
                "id": 6
            },
            {
                "id": 12
            }
        ],
        "allow_exclusive": false,
        "debug_requested": false,
        "tags": [
            {
                "id": 13,
                "sizes": [
                    "728x90"
                ],
                "position": "unknown",
                "inventory_source_id": 476,
                "auction_id_64": 8984480746668973000,
                "tag_format": "iframe",
                "reserve_price": 1,
                "ad_profile_id": 382,
                "predicted_view_rate": 0.654321,
                "inventory_audits": [
                    {
                        "auditor_member_id": 3,
                        "inventory_attributes": [
                            1431,
                            1432,
                            1887
                        ],
                        "content_categories": [
                            171
                        ]
                    }
                ]
            }
        ],
        "bid_info": {
            "user_id_64": 2987961585469200400,
            "no_flash": false,
            "no_cookies": false,
            "ip_address": "96.246.152.18",
            "inventory_audits": [
                {
                    "auditor_member_id": null,
                    "intended_audience": "young_adult",
                    "inventory_attributes": [
                        2,
                        3,
                        6,
                        7
                    ],
                    "content_categories": [
                        39
                    ]
                }
            ],
            "user_agent": "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US;rv:1.9.0.3) Gecko/2008092414 Firefox/3.0.3",
            "accepted_languages": "en-US,en;q=0.8",
            "country": "US",
            "region": "NY",
            "city": "New York",
            "postal_code_id": "10014",
            "dma": 501,
            "time_zone": "America/New_York",
            "url": "https://www.foodandwine.com/recipes/",
            "domain": "foodandwine.com",
            "selling_member_id": 3,
            "inventory_source_id": 123,
            "inventory_class": "class_2",
            "within_iframe": false,
            "total_clicks": 0,
            "segments": [
                {
                    "id": 103,
                    "member_id": 6,
                    "code": "PotentialCarBuyer",
                    "last_seen_min": 21108407
                }
            ]
        }
    }
}

Solicitud de varias etiquetas

{
    "bid_request": {
        "timestamp": "2015-09-17 20:32:00",
        "bidder_timeout_ms": 200,
        "members": [
            {
                "id": 1513
            }
        ],
        "member_ad_profile_id": 11138,
        "tags": [
            {
                "auction_id_64": 1704399148337927200,
                "size": "120x600",
                "sizes": [
                    "120x600"
                ],
                "smaller_sizes_allowed": false,
                "position": "unknown",
                "tag_format": "js",
                "site_id": 188164,
                "creative_formats_map": "1111111110",
                "creative_formats": [
                    "unknown",
                    "html-url",
                    "js-url",
                    "flash",
                    "image",
                    "js-raw",
                    "html-raw",
                    "html-iframe",
                    "url-vast"
                ],
                "ad_profile_id": 201859,
                "ad_profiles": [
                    201859
                ],
                "visibility_profile_id": 132,
                "venue_id": 12043,
                "predicted_view_rate": 0.675,
                "allowed_media_types": [
                    1
                ],
                "allowed_media_subtypes": [],
                "ecp": 1.43206,
                "eap": 0.5,
                "id": 624139,
                "inventory_audits": [
                    {
                        "auditor_member_id": null,
                        "intended_audience": "general",
                        "inventory_attributes": [],
                        "content_categories": []
                    }
                ]
            },
            {
                "auction_id_64": 3898100382999990000,
                "size": "5x6",
                "sizes": [
                    "5x6"
                ],
                "smaller_sizes_allowed": false,
                "position": "unknown",
                "tag_format": "js",
                "site_id": 188164,
                "creative_formats_map": "1111111110",
                "creative_formats": [
                    "unknown",
                    "html-url",
                    "js-url",
                    "flash",
                    "image",
                    "js-raw",
                    "html-raw",
                    "html-iframe",
                    "url-vast"
                ],
                "ad_profile_id": 201859,
                "ad_profiles": [
                    201859
                ],
                "visibility_profile_id": 132,
                "venue_id": 12043,
                "predicted_view_rate": 0.7131,
                "allowed_media_types": [
                    1
                ],
                "allowed_media_subtypes": [],
                "ecp": 2.07576,
                "eap": 0.5,
                "id": 624139,
                "inventory_audits": [
                    {
                        "auditor_member_id": null,
                        "intended_audience": "general",
                        "inventory_attributes": [
                            14
                        ],
                        "content_categories": []
                    }
                ]
            }
        ],
        "bid_info": {
            "user_id_64": 488125638053592500,
            "no_cookies": false,
            "payment_rule_id": 91411,
            "selling_member_id": 681,
            "no_flash": false,
            "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_4) AppleWebKit/537.1 (KHTML, like Gecko) Chrome/21.0.1180.89 Safari/537.1",
            "browser": 8,
            "operating_system": 11,
            "language": 1,
            "accepted_languages": "en-US,en;q=0.8",
            "session_freq": 75,
            "pub_session_freq": 15,
            "ip_address": "207.27.32.2",
            "country": "US",
            "region": "NY",
            "city": "New York",
            "dma": 501,
            "time_zone": "America/New_York",
            "inventory_class": "unaudited",
            "within_iframe": false,
            "publisher_id": 89400,
            "url": "https://www.foodandwine.com/recipes/",
            "domain": "www.foodandwine.com",
            "inventory_audits": [
                {
                    "auditor_member_id": null,
                    "inventory_attributes": [],
                    "content_categories": []
                }
            ],
            "userdata_json": "{}",
            "segments": []
        }
    }
    }

Solicitud móvil (modo de depuración)

{
    "bid_request": {
        "timestamp": "2015-08-23 14:27:08",
        "bidder_timeout_ms": 2000,
        "members": [
            {
                "id": 307
            },
            {
                "id": 308
            }
        ],
        "single_phase": true,
        "member_ad_profile_id": 8610,
        "tags": [
            {
                "auction_id_64": 5638094169507807000,
                "size": "728x90",
                "sizes": [
                    "728x90"
                ],
                "smaller_sizes_allowed": true,
                "position": "unknown",
                "tag_format": "wp7",
                "site_id": 173564,
                "supply_type": "mobile_app",
                "creative_formats_map": "0000100001",
                "creative_formats": [
                    "image",
                    "text"
                ],
                "visibility_profile_id": 129,
                "venue_id": 663,
                "predicted_view_rate": 0.6891,
                "inventory_source_id": 926,
                "allowed_media_subtypes": [
                    1
                ],
                "estimated_clear_price": 1.24481,
                "estimated_average_price": 0.167,
                "estimated_price_verified": true,
                "id": 583751
            }
        ],
        "bid_info": {
            "user_id_64": 5725700387444723000,
            "no_cookies": false,
            "payment_rule_id": 84497,
            "selling_member_id": 618,
            "no_flash": true,
            "user_agent": "Mozilla%2f5.0+(compatible%3b+MSIE+9.0%3b+Windows+NT+6.1%3b+Trident%2f5.0)",
            "operating_system": 13,
            "language": 1,
            "accepted_languages": "en-us,en;q=0.5",
            "app_id": "2ac11907-8e3b-4b9b-b803-2ac834fa559a",
            "ip_address": "131.107.0.83",
            "country": "US",
            "postal_code_id": "10016",
            "loc": "38.7875232696533,-77.2614831924438",
            "inventory_class": "class_1",
            "within_iframe": false,
            "publisher_id": 81242,
            "gender": "male",
            "age": 27,
            "userdata_json": "{\"frequency\":[[\"r\",101,1,1,1,1303349386],[\"r\",102,1,1,1,1303349386]],\"last_imp_time\":1303349386,\"version\":4,\"pixel\":[],\"impserved\":45}",
            "segments": []
        }
    }
}

Solicitud ampliable

{
    "bid_request": {
        "timestamp": "2015-04-20 20:00:14",
        "bidder_timeout_ms": 2000,
        "members": [
            {
                "id": 123
            }
        ],
        "test": true,
        "member_ad_profile_id": 11138,
        "tags": [
            {
                "auction_id_64": "7310650419817444682",
                "size": "300x250",
                "sizes": [
                    "300x250"
                ],
                "smaller_sizes_allowed": false,
                "position": "unknown",
                "tag_format": "js",
                "site_id": 188163,
                "creative_formats_map": "1111111111",
                "creative_formats": [
                    "unknown",
                    "html-url",
                    "js-url",
                    "flash",
                    "image",
                    "js-raw",
                    "html-raw",
                    "html-iframe",
                    "url-vast",
                    "text"
                ],
                "ad_profile_id": 201859,
                "predicted_view_rate": 0.675,
                "visibility_profile_id": 132,
                "venue_id": 12043,
                "allowed_media_types": [
                    6
                ],
                "allowed_media_subtypes": [
                    10,
                    11,
                    12,
                    13,
                    14,
                    15,
                    16,
                    17,
                    18,
                    19,
                    20,
                    24
                ],
                "estimated_clear_price": 1,
                "estimated_average_price": 0.5
            }
        ],
        "bid_info": {
            "user_id_64": 7994340253645703000,
            "no_cookies": false,
            "payment_rule_id": 91411,
            "selling_member_id": 681,
            "no_flash": false,
            "is_secure": false,
            "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.163 Safari/535.19",
            "browser": 8,
            "operating_system": 11,
            "language": 1,
            "accepted_languages": "en-US,en;q=0.8",
            "session_freq": 1,
            "pub_session_freq": 1,
            "ip_address": "68.67.167.12",
            "country": "US",
            "region": "NY",
            "city": "New York",
            "postal_code_id": "10003",
            "dma": 501,
            "time_zone": "America/New_York",
            "inventory_class": "unaudited",
            "within_iframe": false,
            "url": "https://www.foodandwine.com/recipes/",
            "domain": "foodandwine.com",
            "inventory_audits": [
                {
                    "auditor_member_id": null,
                    "inventory_attributes": []
                }
            ],
            "userdata_json": "{}",
            "segments": []
        }
    }
}
{
    "bid_request": {
        "timestamp": "2015-04-18 17:00:57",
        "bidder_timeout_ms": 2000,
        "members": [
            {
                "id": 1417
            }
        ],
        "test": true,
        "member_ad_profile_id": 555216,
        "excluded_technical_attributes": [
            2033
        ],
        "tags": [
            {
                "auction_id_64": 5555508250840351000,
                "size": "300x250",
                "sizes": [
                    "300x250"
                ],
                "smaller_sizes_allowed": false,
                "position": "unknown",
                "tag_format": "iframe",
                "site_id": 555526,
                "creative_formats_map": "111111111011",
                "creative_formats": [
                    "unknown",
                    "html-url",
                    "js-url",
                    "flash",
                    "image",
                    "js-raw",
                    "html-raw",
                    "html-iframe",
                    "url-vast",
                    "unknown",
                    "unknown"
                ],
                "ad_profile_id": 555180,
                "visibility_profile_id": 5553,
                "venue_id": 407258,
                "predicted_view_rate": 0.675,
                "pop_max_width": 300,
                "pop_max_height": 250,
                "pop_is_prepop": false,
                "allowed_media_types": [
                    1
                ],
                "media_subtypes": [
                    "banner"
                ],
                "estimated_clear_price": 0.913,
                "estimated_average_price": 0.456,
                "id": 5555354,
                "deals": [
                    {
                        "id": 555664,
                        "member_id": 5555,
                        "floor_cpm": 0.5,
                        "ad_quality_override": 2,
                        "allowed_media_types": [
                            1,
                            5
                        ],
                        "allowed_media_subtypes": [
                            10,
                            11,
                            23,
                            50
                        ],
                        "sizes": [
                            "300x250",
                            "300x600"
                        ]
                    }
                ]
            }
        ],
        "bid_info": {
            "user_id_64": 5555037017052493000,
            "no_cookies": false,
            "payment_rule_id": 555018,
            "selling_member_id": 55578,
            "no_flash": false,
            "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/34.0.1847.116 Safari/537.36",
            "browser": 8,
            "operating_system": 11,
            "operating_system_extended": 81,
            "operating_system_family": 4,
            "carrier": 1,
            "device_type": 1,
            "language": 1,
            "accepted_languages": "en-US",
            "session_freq": 1,
            "pub_session_freq": 1,
            "ip_address": "555.1.12.54",
            "country": "US",
            "inventory_class": "unaudited",
            "within_iframe": false,
            "device_ids": {
                "sha1udid": "d55555c2314f3789198685914c01425034b5d502",
                "md5udid": "caf55557c5b39fb4ad68dabc9808bda1"
            },
            "publisher_id": 555547,
            "userdata_json": "{}",
            "segments": [
                {
                    "id": 1,
                    "member_id": 0,
                    "code": "cookie_birthday",
                    "provider": "",
                    "last_seen_min": 23274134
                }
            ]
        }
    }
}