Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Importante
- No se admite: El protocolo de licitación AppNexus ya no es compatible. Esta documentación es solo para fines patrimoniales. Dejaremos de usar este protocolo el 1 de diciembre de 2018.
- Si eres un nuevo licitador que se integra con AppNexus, consulta 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 Bus de impresiones. Contiene toda la información necesaria para que un licitador produzca un precio de oferta y una creatividad para servir.
La solicitud de oferta incluye información de los vendedores que especifica qué anunciantes y creatividades pueden ganar una subasta y publicarse 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 acepten sus ofertas.
Limitación de solicitudes de pujas
Es posible que no desee recibir todas las solicitudes de licitación que pasan a través de la plataforma AppNexus. Puede limitar las solicitudes en un porcentaje o filtrarlas por criterios predefinidos, como la geografía.
Solicitudes de pujas de varias etiquetas
A veces enviamos "solicitudes de puja de varias etiquetas", en las que una solicitud de puja puede incluir varios identificadores de etiqueta con tamaños, estándares de calidad de anuncios, precios de reserva, etc. potencialmente diferentes. Por ahora, estas solicitudes deben manejarse con respuestas individuales para cada etiqueta como si fueran solicitudes independientes. Sin embargo, en un futuro cercano, estas solicitudes de etiquetas múltiples serán la base para adquisiciones, compras de 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 | Descripción |
|---|---|---|---|
Connection |
todo | string | Establezca siempre "keep-alive" para garantizar conexiones TCP persistentes. |
Content-Length |
todo | Entero | Longitud del cuerpo de la solicitud HTTP (que incluye todos los campos que se describen a continuación). |
Host |
todo | string | Dirección IP a la que se ha enviado la solicitud de licitación. |
X-Debug |
Algunos | Entero | Si se establece en 1, la llamada de anuncio incluía el valor debug=1 y no se publicará 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 del emplazamiento puede publicar un anuncio. El propietario puede anular el incumplimiento exclusivo durante la fase de propietario de la subasta. |
X-Segment |
Algunos | string | Una lista separada por comas de los segmentos en los que se encuentra el usuario. Los segmentos disponibles incluyen aquellos propiedad de sus miembros y aquellos propiedad de proveedores de datos de terceros (a los que AppNexus ha otorgado acceso a su ofertante). |
X-Venue |
todo | Entero | Este encabezado no se usa actualmente. |
Información de subastas
Datos generales
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
member_ad_profile_id |
Algunos | Entero | El id. del perfil de aprobación de anuncios a nivel de miembro que se aplica a la impresión. |
timestamp |
todo | marca de tiempo | Hora en la que se envió la solicitud. |
bidder_timeout_ms |
todo | Entero | Número de milisegundos que tiene el licitante desde el momento en que el bus de diablillo envía la solicitud hasta el momento en que el bus de diablillo recibe la respuesta antes del tiempo de espera. Este número variará según el socio de suministro. |
bid_info |
todo | objeto | 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 elegibles para ofertar en esta convocatoria. Un miembro es una entidad que tiene una relación financiera de compra o venta con AppNexus y está asociada a un licitador. Algunos postores 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 proporciona en el ejemplo siguiente. |
tags |
todo | matriz de objetos | Una matriz de las etiquetas que se subastan en esta convocatoria. 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 | Descripción |
|---|---|---|---|
allow_exclusive |
Algunos | Booleano | Si el miembro licitante es propietario del inventario (es decir, member_id de etiqueta = identificación de miembro del postor), entonces el miembro puede servir en él sin permitir que otros postores participen. |
Depurar datos
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
debug_requested |
Algunos | Booleano | Si es verdadero, la llamada de anuncio incluía la debug=1 marca y no se publicará ningún anuncio. Esto solo se incluirá en la solicitud de oferta si se utiliza 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 la llave del miembro (establecida en el Servicio para miembros). Su ofertante puede usar el debug_member_id para producir un resultado de depuración que se limita a un miembro en particular. |
test |
Algunos | Booleano | Si es verdadera, la etiqueta del anuncio se está ejecutando como prueba y no se publicará ningún anuncio. Si no está presente, la prueba es falsa. |
Otros datos
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
excluded_adservers |
Algunos | Matriz de enteros | Los identificadores de los servidores de anuncios que no son aptos para la impresión, según lo definido por la configuración de calidad de anuncios del vendedor. Puedes usar el servicio de servidor de anuncios para buscar servidores de anuncios. |
excluded_brands |
Algunos | Matriz de enteros | Los identificadores de las marcas que no son aptas para la impresión, según lo definido por la configuración de calidad de anuncios del vendedor. Puede utilizar 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, según lo definido por la configuración de calidad de anuncios del vendedor. Puede utilizar el Servicio de idiomas para buscar idiomas. |
excluded_categories |
Algunos | Matriz de enteros | Los identificadores de las categorías que no son aptas para la impresión, según lo definido por la configuración de calidad de anuncios del vendedor. Puede usar el Servicio de categorías para buscar categorías. |
excluded_creatives |
Algunos | Matriz de enteros | Los identificadores de creatividades que no son aptas para la impresión, según lo definido por la configuración de calidad de anuncios del vendedor. Puede utilizar el Servicio de creatividades para buscar creatividades. |
excluded_technical_attributes |
Algunos | Matriz de enteros | Los identificadores de los atributos técnicos que no son aptos para la impresión, según lo definido por la configuración de calidad del anuncio del vendedor. Puede utilizar el servicio de atributos técnicos para buscar atributos técnicos. |
single_phase |
Algunos | Booleano | Este campo no se utiliza actualmente para los licitadores. |
Members
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
id |
todo | Entero | Id. del miembro. |
Etiquetas
Información asociada a la etiqueta del anuncio.
Datos de subastas
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
auction_id_64 |
todo | Entero | El identificador de la subasta. Esto es útil para la conciliación y las discrepancias, por lo que se recomienda agregarlo a los registros. No se garantiza que esto sea único. |
Datos de jerarquía de inventario
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
id |
Algunos | Entero | El identificador del TinyTag. Una etiqueta es un subconjunto de inventario dentro de un sitio. Los ofertantes no pueden buscar a qué etiqueta corresponde el ID, pero estos ID se pueden usar como fragmentos de inventario anónimos y optimizables. |
site_id |
Algunos | Entero | El identificador del sitio. Los sitios son la segunda agrupación de inventario más grande para los miembros que venden su inventario a través de AppNexus. Un sitio es un subconjunto del inventario de un editor. Los postores no pueden buscar a qué sitio corresponde el ID, pero estos ID se pueden usar como fragmentos de inventario anónimos y optimizables. |
Datos generales
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
size |
todo | string | Un tamaño (anchoxalto; por ejemplo, 300x160) para esta impresión. |
sizes |
todo | matriz de cadenas | Tamaños creativos permitidos para esta impresión, indicados en formato "widthxheight". |
position |
todo | enumeración("debajo","por encima","desconocido") | La posición del anuncio en la página superior o inferior de la página. quitados de la etiqueta, si están disponibles. |
tag_format |
Algunos | enum("iframe", "js", "wp7", "vast", "json", "xml") | Para las etiquetas "iframe", el bus de impresiones devolverá HTML para mostrar la creatividad ganadora en la página del editor (si es necesario, el HTML contendrá una etiqueta IFrame). Para las etiquetas "js", el bus de impresiones devolverá javascript para que se ejecute en la página del editor. (El javascript devuelto normalmente contendrá comandos document.write para generar el HTML para mostrar la creatividad). Esta distinción solo es relevante para los postores en el caso de que una creatividad no se muestre correctamente en uno o más 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 | Id. válidos de subtipo multimedia. Use el servicio de subtipo de medios para obtener una lista de identificadores. |
media_subtypes |
Algunos | matriz de cadenas | Subtipos multimedia válidos para una creatividad, en formato de cadena. |
inventory_audits |
Algunos | matriz | Datos de autoclasificación del vendedor sobre el contenido del sitio. |
venue_id |
Algunos | Entero | Este campo no se utiliza actualmente para los licitadores. |
ad_profile_id |
Algunos | Entero | El id. del perfil de aprobación de anuncios a nivel de etiqueta que se aplica a la impresión de la etiqueta concreta. |
predicted_view_rate |
todo | double | La probabilidad de que el usuario pueda ver la impresión, en función de los datos históricos. |
Datos de precios
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
reserve_price |
Algunos | float | Cuando se proporciona, esta es la oferta mínima necesaria para ganar la subasta. Si el miembro ofertante es el propietario del inventario (allow_exclusive = verdadero), esto se omite. |
estimated_clear_price |
Algunos | double | El ECP es el precio estimado necesario para ganar el inventario. El ECP es superior al 95 % de todas las pujas ganadoras para esta etiqueta enviadas a través de AppNexus. Nota: Es posible que un porcentaje significativo de ofertas ganadoras para cualquier etiqueta no se envíe a través de AppNexus. Consulte Mecánica de reducción de precios para obtener más detalles. |
estimated_average_price |
Algunos | double | El EAP es similar al ECP, excepto que el EAP es superior al 70 % de todas las ofertas ganadoras para esta etiqueta enviadas a través de AppNexus. |
estimated_price_verified |
Algunos | Booleano | Este campo indica si el EAP y el ECP se han verificado mediante los datos observados por AppNexus. |
Datos específicos del propietario
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
tag_data |
Solo de propiedad | string | Si está disponible, el resto de la 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 de propiedad | Booleano | Indica si la subasta es exclusiva de forma predeterminada. Una subasta exclusiva es aquella en la que solo el propietario del emplazamiento puede publicar un anuncio. El propietario puede anular el incumplimiento exclusivo durante la fase de propietario de la subasta. |
default_creative_id |
Solo de propiedad | Entero | El id. de creatividad predeterminado de este TinyTag. |
Campos específicos para dispositivos móviles
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
supply_type |
Algunos | Siempre enviado para "mobile_app" (no enviado para "web") | Distingue si este inventario es web, explorador móvil o aplicación móvil. Para determinar si una impresión web se está viendo en un dispositivo móvil, usa el sistema operativo en la solicitud de puja. |
creative_formats |
Algunos | Uno o varios de "texto", "imagen", "html-url", "js-url", "flash", "js-raw", "html-raw", "html-iframe", "url-vast", "xml-url", "archivo-url", desconocido" | Lista de formatos creativos de AppNexus que se pueden utilizar 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 "clic a web", "clic para llamar" | Lista de acciones de clic permitidas de los creativos que se pueden utilizar para pujar por esta impresión. Actualmente, el método de clic para llamar no está disponible, pero lo estará pronto. Se pueden agregar otras acciones a esta lista a medida que se admiten. |
smaller_sizes_allowed |
Algunos | Booleano | Verdadero si también se pueden usar creatividades de menor tamaño y creatividades de texto para pujar por la impresión. |
Datos de la oferta
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
deals |
Algunos | matriz de objetos | Una matriz de tratos que se aplican a la impresión. Consulte Ofertas para obtener más información. |
Ofertas
Cada objeto de la deals matriz contiene los siguientes campos.
| Campo | Tipo | Descripción |
|---|---|---|
ad_quality_override |
Entero | Especifica cómo el acuerdo controla las creatividades: - 1: los creativos usan la configuración de calidad de anuncios existente. (Predeterminado) - 2: los creativos en estado de auditoría "pendiente" servirán. Una vez auditadas estas creatividades, se utiliza la configuración de calidad de anuncios existente. - 3: no se aplicarán restricciones de perfil de anuncios a esta oferta. (Confianza máxima) |
allowed_media_subtypes |
de enteros. | Especifica los identificadores de los subtipos de medios que se permiten en esta oferta. Use el servicio de subtipos de medios para ver una lista de subtipos de medios. Si no hay subtipos de medios únicos para este trato en comparación con el objeto de solicitud de oferta principal, este campo será una matriz vacía. Esto NO significa que la oferta no permita ningún subtipo de medios, sino que solo significa que los subtipos de medios en el objeto de oferta principal deben usarse al ofertar en esta oferta. |
allowed_media_types |
de enteros. | Especifica los ID de los tipos de medios permitidos en esta oferta. Utilice el servicio de tipos de medios para ver una lista de tipos de medios. Si no hay tipos de medios únicos para esta oferta en comparación con el objeto de solicitud de oferta principal, este campo será una matriz vacía. Esto NO significa que la oferta no permita ningún tipo de medios, sino que solo significa que los tipos de medios en el objeto de oferta principal deben usarse al ofertar en esta oferta. |
floor_cpm |
double | El precio que el vendedor ha fijado para el trato. Use esta cantidad más las tarifas aplicables como su oferta mínima para competir por este inventario. Ten en cuenta que pujar este importe más las comisiones aplicables te ayudará a asegurarte de que puedes optar a la oferta, pero no garantizará que tu puja gane. Este importe siempre estará en dólares estadounidenses. Los precios de venta introducidos en otra moneda se convertirán a dólares. |
id |
Entero | El identificador del trato que se aplica a la impresión. Puede utilizar el Servicio de acceso al comprador de ofertas para ver los detalles de la oferta, incluido el nombre de la oferta, la descripción, la fecha de inicio y finalización y el inventario asociado. |
member_id |
Entero | El identificador del miembro comprador para el que se creó la oferta. |
sizes |
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 oferta 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 oferta principal deben usarse al ofertar en esta oferta. |
Bid_Info
Información sobre el usuario y la solicitud de puja general.
Usuario
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
user_id_64 |
todo | Entero | El id. único de 64 bits para el usuario. Será lo mismo para todas las solicitudes de este usuario hasta que se eliminen 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 navegador del usuario no acepta cookies. Será -1 para los usuarios que opten por no participar. |
user_agent |
Algunos | string | El encabezado "User-Agent" del explorador. (En otras palabras, el tipo de navegador). |
operating_system |
Algunos | Entero | El identificador del sistema operativo del usuario. Puede usar el servicio del sistema operativo para asignar identificadores de sistema operativo a nombres. |
browser |
Algunos | Entero | El Id. del navegador del usuario. Puede usar el servicio de explorador para asignar identificadores de explorador a nombres. |
accepted_languages |
Algunos | string | El encabezado "Accept-Language" del explorador (utilizando el idioma ISO-639 y los códigos de país ISO-3166). |
language |
Algunos | Entero | El identificador del idioma analizado a partir de la cadena accepted_languages. Puede usar el servicio de idiomas para asignar idiomas a nombres. |
no_flash |
todo | booleano | Informa al licitador si hemos detectado que el navegador del usuario no tiene instalado flash. |
no_cookies |
todo | booleano | Si el no_cookies campo se establece en false- AppNexus puede rastrear al usuario a través de una identificación de usuario que se coloca en una cookie en el navegador del usuario. - La identificación del usuario estará contenida en el user_id_64 campo en la solicitud de oferta. Si el no_cookies campo se establece en true Y el user_id_64 campo se establece en 0 - AppNexus no puede rastrear al usuario ya que el navegador del usuario no acepta cookies. - No debe ofertar por dicha subasta en nombre de campañas que requieran datos de usuario (por ejemplo, limitación de frecuencia, limitación de inmediatez). Si el no_cookies campo se establece en true Y, el campo es distinto de user_id_64 cero - AppNexus puede rastrear al usuario a través de cookies y el campo user_id_64 contiene la identificación del usuario. - Sin embargo, se ha producido un problema al buscar información de usuario en el almacén de datos de usuario del lado del servidor de AppNexus. - Como resultado, la solicitud de oferta no incluirá datos de usuario, ni AppNexus podrá actualizar de manera confiable los datos de usuario en función de los comandos enviados en la respuesta de la oferta. - No debe ofertar por dicha subasta en nombre de campañas que requieran datos de usuario (por ejemplo, limitación de frecuencia, limitación de inmediatez). |
gender |
Algunos | enumeración | "hombre" o "mujer": el editor puede proporcionar estos datos en el momento de la subasta. |
age |
Algunos | Entero | El publicador puede proporcionar estos datos en el momento de la subasta. |
segments |
todo | de objetos. | Matriz de los segmentos en los que se encuentra el usuario. Los segmentos disponibles incluyen aquellos propiedad de sus miembros y aquellos propiedad de proveedores de datos de terceros (a los que AppNexus ha otorgado acceso a su ofertante). Se describe con más detalle a continuación. |
session_freq |
todo | Entero | El número de impresiones que AppNexus ha servido a este usuario durante la duración de la sesión de exploración. A estos efectos, 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 servido a este usuario, en este editor, durante la duración de la sesión de exploración. A estos efectos, una sesión de exploración se define como la duración de la cookie AppNexus del usuario. |
Datos geográficos
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
ip_address |
todo | string | La dirección IP del usuario. |
country |
Algunos | string | El país o región del usuario en función de la dirección IP, si se puede determinar. |
region |
Algunos | string | La 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 | El 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 | La zona horaria del usuario en función de la dirección IP, si se puede determinar. |
Datos de usuario del almacén de cookies del lado del servidor
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
userdata_json |
Algunos | Los datos de usuario adjuntos a la cookie del usuario almacenados por el postor que recibe la solicitud. | |
total_clicks |
Algunos | Entero | Este campo ha quedado en desuso. |
Información de inventario (página)
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
selling_member_id |
todo | Entero | El identificador del miembro que vende el inventario. Consulte Servicio para miembros de la plataforma para encontrar los nombres de los miembros correspondientes. |
url |
Algunos | string | La URL de referencia (contiene el anuncio / inicia la solicitud de anuncio). Esto se proporciona siempre si está disponible, a menos que el editor haya decidido restringir su uso. Un editor también puede optar por configurar una URL de referencia predeterminada en AppNexus que se pasará en la solicitud de oferta en caso de que la referencia no esté disponible o el editor haya decidido restringir su uso. Para obtener más información, póngase en contacto con el representante técnico de AppNexus. |
domain |
Algunos | string | El dominio de la dirección URL de referencia. |
inventory_audits |
Algunos | matriz | Datos de auditoría de AppNexus sobre el contenido del sitio. Las auditorías de bid_info pertenecen a todas las etiquetas de la subasta. Esta información suele proceder 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 iframes envolventes, este es 'true'. Tenga en cuenta que si AppNexus no puede determinar si la etiqueta está encapsulada, esto será 'false'. |
publisher_id |
Algunos | Entero | El Id. del publicador. Los publicadores se utilizan como las agrupaciones de inventario más grandes para los miembros que venden su inventario a través de AppNexus. Los ofertantes no pueden buscar a qué editor corresponde el identificador, pero estos identificadores se pueden usar como fragmentos de inventario anónimos y optimizables. |
is_secure |
Algunos | booleano | Si la página es segura, esto es cierto. Nota: Todas las conexiones para asegurar el inventario deben ser seguras. Esto incluye píxeles, creatividades y llamadas de terceros. (es decir, para una creatividad: 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 | Descripción |
|---|---|---|---|
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 están representados como negativos. Puede haber un máximo de 5 decimales de precisión. |
carrier |
Algunos | Entero | Identificador del operador. Estará disponible una asignación de identificadores a nombres de operadores y países o regiones en el servicio de solo lectura del operador. Existirá un operador especial "WIFI" para los usuarios que se conectan a través de WiFi. |
device_make |
Algunos | Entero | El identificador del dispositivo marca 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 el servicio Device Make. |
device_model |
Algunos | Entero | El Id. del modelo de dispositivo en el que se mostrará el anuncio. Para obtener más información, consulte el Servicio de modelo de dispositivo. |
device_type |
Algunos | Entero | El identificador del tipo de dispositivo en el que se mostrará el anuncio. Se representa mediante un entero y se puede buscar mediante el Servicio de modelo de dispositivo. Valores permitidos y sus significados: - 1 = "pc" - 2 = "phone" - 3 = "tableta" |
device_ids |
Algunos | objeto | Objeto JSON que contiene información sobre los id. de dispositivo asociados a la impresión que se está pujando. Para obtener más información, consulte Id. de dispositivo. |
Id. de dispositivos
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
aaid |
Algunos | string | Identificador de publicidad de Google para dispositivos Android, tal y como se recupera de los servicios de Google Play. |
idfa |
Algunos | string | Identificador de publicidad de Apple para dispositivos iOS con iOS 6+. |
md5udid |
Algunos | string | El hash MD5 del archivo ANDROID_ID. Esto solo debe enviarse para dispositivos Android. Debe estar codificado como URL. |
openudid |
Algunos | string | OpenUDID del dispositivo. Esto solo debe enviarse para las versiones 5 e inferiores de iOS. |
sha1mac |
Algunos | string | ODÍN. Esto solo debe enviarse para las versiones 5 e inferiores de iOS. Esta debe ser una URL codificada |
sha1udid |
Algunos | string | El hash SHA1 del ANDROID_IDarchivo . Esto solo debe enviarse para dispositivos Android. Debe estar codificado como URL. |
Segmentos
Matriz de los segmentos en los que se encuentra el usuario. Los segmentos disponibles incluyen aquellos propiedad de sus miembros y aquellos propiedad de proveedores de datos de terceros (a los que AppNexus ha otorgado acceso a su ofertante).
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
code |
Algunos | string | Consulta Servicios de píxeles para obtener más información. |
id |
todo | Entero | Segment ID. |
last_seen_min |
todo | Entero | El número de minutos transcurridos desde la última vez que se etiquetó a este usuario con este segmento. Se expresa en tiempo Posix (representado en minutos). Multiplique este valor por 60 para obtener el número de segundos transcurridos desde la época en que se actualizó este segmento. |
member_id |
todo | Entero | ID del miembro asociado a este segmento. |
other |
Algunos | Entero | El valor del segmento, si el segmento contiene un valor. |
Auditorías de inventario
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
auditor_member_id |
todo | Entero | Identificación del miembro que proporcionó esta auditoría. Si este campo es nulo, la auditoría la realizó el equipo de operaciones de la plataforma. |
content_categories |
Algunos | de enteros. | Identificadores de categorías de contenido del sitio. Para obtener los nombres significativos de categorías de contenido específicas o para obtener la lista completa, consulte Servicio de categoría de contenido. Nota: Es posible que veas identificadores en esta lista que no son visibles para ti 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 | de enteros. | Identificadores de atributos confidenciales del sitio en los que algunos anunciantes pueden optar por no publicar. Para obtener los nombres significativos de atributos específicos o para obtener 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 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 expandible
{
"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": []
}
}
}
Solicitud relacionada con una oferta
{
"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
}
]
}
}
}