Solicitud de oferta saliente a los licitadores
Nota:
Esto describe la integración del protocolo OpenRTB 2.4.
Esta solicitud de puja se envía a los licitadores cada vez que una llamada de anuncio llega al bus 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.
Nota:
Es posible que no desee recibir todas las solicitudes de puja que pasan a través de nuestra plataforma. Puede limitar las solicitudes en algún porcentaje o filtrar las solicitudes por criterios preestablecidos, como geography.
Implementación
Consulte las tablas para buscar los detalles de implementación, como objetos y encabezados sobre los que necesita más información.
Encabezados de solicitud de puja
| Campo | Tipo | Descripción |
|---|---|---|
Content-Length |
Entero | Longitud del cuerpo de la solicitud HTTP (que incluye todos los campos descritos a continuación). |
Host |
string | Dirección IP a la que se ha enviado la solicitud de puja. |
Connection |
string | Establezca siempre en "keep-alive" para garantizar conexiones TCP persistentes. |
Content-Type |
string | Tipo de contenido pasado en la solicitud. Siempre se establece en "application/json". |
x-openrtb-version |
string | La versión de openrtb admitida en la solicitud de puja. Actualmente establecido en 2.4. |
Objeto de solicitud de puja
Xandr admite los siguientes campos en el objeto de solicitud de puja de nivel superior:
| Campo | Tipo | Descripción |
|---|---|---|
id |
string | (Obligatorio) Identificador único de la solicitud de puja. |
imp |
matriz de objetos | (Obligatorio) Las impresiones ofrecidas en esta solicitud de puja. Vea El objeto impression a continuación. |
site |
objeto | Especifica información sobre el sitio web o subconjunto del inventario (grupo de selección de ubicación) para las impresiones. Aplicable a las impresiones del sitio web. Vea Objeto de sitio a continuación. |
app |
objeto | Especifica información sobre la aplicación para las impresiones. Aplicable a las impresiones de la aplicación. Vea App Object (Objeto de aplicación ) a continuación. |
device |
objeto | Especifica información sobre el dispositivo del usuario al que se entregarán estas impresiones. Consulte Device Object (Objeto de dispositivo ) a continuación. |
user |
objeto | Especifica información sobre la persona a la que se entregarán las impresiones. Vea Objeto de usuario a continuación. |
test |
integer | Indica que esta subasta está en modo de prueba y no se puede facturar. Si no está presente, se usa el valor predeterminado. - 0: modo activo; facturable (valor predeterminado).- 1: modo de prueba; no facturable. |
at |
integer | Especifica el tipo de subasta. Si no está presente, se usa el valor predeterminado. - 1: primer precio.- 2: segundo precio más un centavo (valor predeterminado). |
wseat |
matriz de cadenas | Especifica una matriz que representa una lista de permitidos de puestos de comprador permitidos para pujar por esta impresión. |
tmax |
integer | Especifica el tiempo máximo (en milisegundos) para enviar una oferta antes de agotar el tiempo de espera. |
cur |
matriz de cadenas | Especifica una matriz de monedas permitidas para pujas en esta solicitud de puja mediante códigos alfabéticos ISO-4217. Valores predeterminados de USD. |
bcat |
matriz de cadenas | Especifica una lista de categorías de contenido bloqueadas. Incluye categorías de IAB (enumeradas en la sección 5.1 de la especificación).
Bcat no es un campo obligatorio y solo se envía si hay categorías bloqueadas asociadas a la solicitud de puja. Si no hay ninguna categoría bloqueada asociada, no se envía este campo. |
badv |
matriz de cadenas | Especifica una lista de dominios de anunciante de nivel superior bloqueados que se corresponden con las direcciones URL de marca de nuestro sistema. Por ejemplo, ["company1.com","company2.com"]. Para obtener más información, consulte el Servicio de marca. Se envía un máximo de 64 valores. |
regs |
objeto | Especifica información sobre una regulación del sector, legal o gubernamental vigente para esta solicitud. Vea Regs (objeto) a continuación. |
source |
objeto | Proporciona datos sobre el origen del inventario y qué entidad toma la decisión final. Vea Source Object (Objeto de origen ) a continuación. |
ext |
objeto | Se usa para identificar extensiones específicas de la plataforma para la solicitud de puja de OpenRTB. Vea Bid Request Extension Object (Objeto de extensión de solicitud de puja ) a continuación. |
Objeto de extensión de solicitud de puja
Se admiten los objetos follow en el objeto para admitir extensiones específicas de la ext plataforma, así como señales de cadena de suministro:
| Campo | Tipo | Descripción |
|---|---|---|
appnexus |
objeto | Especifica las extensiones específicas de la plataforma para la solicitud de puja de OpenRTB. |
schain |
objeto | Especifica los campos SupplyChain incluidos en la solicitud de puja de OpenRTB para la transparencia de la ruta de suministro. Vea Schain Object (Objeto Schain ) a continuación. |
Schain (objeto)
Se admiten los siguientes campos en el schain objeto (cadena de suministro):
| Campo | Tipo | Descripción |
|---|---|---|
ver |
string | Versión de la especificación de la cadena de suministro en uso, en el formato "major.minor". Actualmente se usa la versión 1.0 de la especificación. |
complete |
enumeración | Marca que indica si la cadena contiene todos los nodos implicados en la transacción que conduce al propietario del sitio, la aplicación u otro medio del inventario, donde 0 = no, 1 = sí. |
nodes |
objeto | Matriz de objetos SupplyChainNode en el orden de la cadena. En una cadena de suministro completa, el primer nodo representa el sistema de publicidad inicial y el identificador de vendedor implicados en la transacción, es decir, el propietario del sitio, la aplicación u otro medio. En una cadena de suministro incompleta, representa el primer nodo conocido. El último nodo representa la entidad que envía esta solicitud de puja, que es el nodo Xandr. Se admiten los siguientes campos en el objeto nodes: - asi (cadena): el nombre de dominio canónico del sistema SSP, Exchange, Header Wrapper, etc. al que se conectan los licitadores. Este debe ser el mismo valor que se usa para identificar a los vendedores en un archivo ads.txt si existe uno. Para el nodo Xandr, ese dominio se appnexus.com - sid (cadena): identificador asociado a la cuenta de vendedor o revendedor dentro del sistema de publicidad. - rid (cadena): el RequestId de OpenRTB de la solicitud emitida por el vendedor. - hp (entero): indica si este nodo está implicado en el flujo de pago del inventario. Para la versión 1.0 de SupplyChain, esta propiedad siempre debe ser 1. |
Objeto de solicitud de puja
Se admiten los siguientes campos en el appnexus objeto de extensión para el objeto de solicitud de puja:
| Campo | Tipo | Descripción |
|---|---|---|
seller_member_id |
integer | Especifica el identificador del miembro que vende el inventario. Consulte Servicio para miembros de la plataforma para buscar los nombres de miembro correspondientes. |
spend_protection |
Booleano | En desuso (octubre de 2018). |
publisher_integration |
objeto | Proporciona detalles sobre la integración del publicador. |
ext_inv_code |
integer | Valor predefinido que se pasa a la cadena de consulta que se puede usar en la generación de informes. El valor debe escribirse en el sistema antes de registrarlo. Para obtener más información, vea Servicio de código de inventario externo. Ejemplo: ext_inv_code=10039 |
Objeto de integración de Publisher
En el objeto publisher_integration se admiten los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
is_header |
booleano |
-
0: no se trata de una integración de pujas de encabezado.- 1: integración en un contenedor. |
bid_shading_high |
double | En desuso (octubre de 2018). |
bid_shading_medium |
double | En desuso (octubre de 2018). |
bid_shading_low |
double | En desuso (octubre de 2018). |
Impression (objeto)
Se admiten los siguientes campos del imp objeto, que describen la impresión que se va a subastar. Una única solicitud de puja puede contener una matriz con varios imp objetos.
| Campo | Tipo | Descripción |
|---|---|---|
id |
string | (Obligatorio) Especifica un identificador único para esta impresión en el contexto de la solicitud de puja. Establezca en el valor de auction_id_64. |
banner |
objeto | Obligatorio si esta impresión se ofrece como un anuncio de banner. Vea Banner Object (Objeto banner ) a continuación. |
video |
objeto | Obligatorio si esta impresión se ofrece como un anuncio de vídeo. Vea Video Object (Objeto de vídeo ) a continuación. |
audio |
objeto | Obligatorio si esta impresión se ofrece como un anuncio de audio. Vea Audio Object (Objeto de audio ) a continuación. |
native |
objeto | Obligatorio si esta impresión se ofrece como un anuncio nativo. Vea Native Object (Objeto nativo ) a continuación |
instl |
integer | Indica si la impresión es intersticial o de pantalla completa. - 0: la impresión no es intersticial ni de pantalla completa (valor predeterminado).- 1: la impresión es intersticial o de pantalla completa. |
tagid |
string | Especifica un identificador para la ubicación específica del anuncio o la etiqueta de anuncio que se usó para iniciar la subasta. Este es el identificador de ubicación de nuestra plataforma. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
bidfloor |
float | Oferta mínima para esta impresión expresada en CPM. Xandr envía el precio bruto de mercado abierto del editor en el bidfloor campo en las solicitudes de puja salientes a los DSP de bajada. (Esto incluye las tarifas pertinentes para vendedores y compradores de Xandr). Esto es aplicable cuando bidfloor se establece en la solicitud de anuncio entrante del publicador o cuando se establece el precio de reserva de ubicación de un publicador. |
bidfloorcur |
string | Moneda especificada mediante códigos alfa ISO-4217. Esto puede ser diferente de la moneda de la oferta devuelta por el licitador si esto lo permite el intercambio. |
secure |
integer | Indica si la impresión requiere recursos creativos y marcado de direcciones URL HTTPS seguras. Si se omite, el estado seguro es desconocido, pero se puede suponer que no es seguro. - 0: la impresión no es segura.- 1: la impresión es segura. |
pmp |
objeto | Especifica información sobre una oferta de Marketplace privada que está en vigor para esta impresión. Consulte Objeto de Marketplace privado a continuación. |
ext |
objeto | Se usa para identificar extensiones específicas de la plataforma en OpenRTB para el objeto de impresión. Vea Impression Extension Object (Objeto de extensión de impresión ) a continuación. |
Banner (objeto)
Para las impresiones de banner, se admiten los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
w |
integer | (Recomendado) Especifica el ancho exacto del banner en píxeles. |
h |
integer | (Recomendado) Especifica el alto exacto del banner en píxeles. |
id |
string | Especifica un identificador único para el objeto banner. Útil para realizar el seguimiento de varios objetos de banner (por ejemplo, con una matriz de banner complementaria). Normalmente, el primer banner de la matriz es 1 y los objetos subsiguientes incrementan desde allí. Actualmente codificado de forma rígida en 1. |
btype |
matriz de enteros | Especifica los tipos creativos de banner que se van a bloquear. Consulte la sección 5.2 de la especificación de IAB para obtener una lista de tipos. |
battr |
matriz de enteros | Especifica los atributos creativos de banner que se van a bloquear. Consulte la sección 5.3 de la especificación de IAB para obtener una lista de atributos. |
pos |
integer | Especifica la posición del banner en la pantalla. - 0: desconocido (valor predeterminado)- 1: por encima del pliegue- 3: debajo del pliegue |
api |
matriz de enteros | Especifica los marcos de API admitidos para esta impresión. Si una API no aparece explícitamente, se supone que no se admite. Consulte la sección 5.6 de la especificación de IAB para obtener una lista de marcos de API. |
format |
matriz de objetos | Objetos format que representan los tamaños de banner permitidos. Vea Format Object (Formato de objeto ) a continuación. Nota: Los tamaños de banner indicados en el objeto de formato no son representativos de los tamaños permitidos a través de ofertas. |
ext |
objeto | No admitida. |
Format (objeto)
Se admite el campo siguiente en el format objeto del banner objeto :
| Campo | Tipo | Descripción |
|---|---|---|
w |
integer | Especifica el ancho de la creatividad, en píxeles. |
h |
integer | Especifica el alto de la creatividad, en píxeles. |
Objeto Video
Para las impresiones de vídeo, se admiten los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
mimes |
matriz de cadenas | (Obligatorio) Especifica los tipos MIME de contenido de vídeo admitidos; por ejemplo, video/x-ms-wmv y video/x-flv. |
minduration |
integer | (Recomendado) Especifica la duración mínima del anuncio de vídeo, en segundos. |
maxduration |
integer | (Recomendado) Especifica la duración máxima del anuncio de vídeo, en segundos. |
w |
integer | (Recomendado) Especifica el ancho del reproductor de vídeo, en píxeles. |
h |
integer | (Recomendado) Especifica el alto del reproductor de vídeo, en píxeles. |
startdelay |
integer | (Recomendado) Especifica el retraso de inicio del anuncio de vídeo: - > 0: para valores mayores que cero, el retraso antes del inicio del vídeo, en segundos.- 0: pre-roll.- -1: mid-roll genérico.- -2: post-roll genérico. |
battr |
matriz de enteros | Especifica los atributos creativos de vídeo que se van a bloquear. Consulte la sección 5.3 de la especificación de IAB para obtener una lista de atributos. |
minbitrate |
integer | Velocidad mínima de bits, en kilobytes por segundo. |
maxbitrate |
integer | Velocidad de bits máxima, en kilobytes por segundo. |
playbackmethod |
matriz de enteros | Especifica los métodos de reproducción permitidos. Si no se especifica, se supone que se permite todo. Los valores admitidos actualmente son: - 1: Reproducción automática, sonido activado.- 2: Reproducción automática, sonido apagado.- 3: haga clic para reproducir.- 4: pase el mouse sobre para reproducir. |
api |
matriz de enteros | Especifica los marcos de API admitidos para esta impresión. Si una API no aparece explícitamente, se supone que no se admite. Los valores admitidos actualmente son: - 1: VPAID 1.0- 2: VPAID 2.0- 3: MRAID-1- 4: ORMMA- 5: MRAID-2- 6: MRAID-3- 7: OMID-1 |
protocols |
matriz de enteros | Matriz de protocolos de vídeo admitidos. Los valores admitidos actualmente son: - 1: VAST 1.0- 2: VAST 2.0- 3: VAST 3.0- 4: CONTENEDOR VAST 1.0- 5: CONTENEDOR VAST 2.0- 6: CONTENEDOR VAST 3.0- 7: VAST 4.0- 8: DAAST 1.0 |
placement |
integer | Tipo de ubicación para la impresión. Opciones posibles: - 1: In-Stream- 2: en banner- 3: en el artículo- 4: en la fuente- 5: intersticial/deslizante/flotante |
linearity |
integer | Indica si la impresión debe ser lineal, no lineal, etc. Si no se especifica ninguno, suponga que se permiten todos. - 1: lineal/In-Stream- 2: no lineal/superposición |
ext |
objeto | Se usa para identificar extensiones específicas de la plataforma en OpenRTB para el objeto de vídeo. Vea Video Extension Object (Objeto de extensión de vídeo ) a continuación. |
Objeto de extensión de vídeo
Se admite un único objeto en el ext objeto para admitir extensiones específicas de Xandr para el video objeto :
| Campo | Tipo | Descripción |
|---|---|---|
appnexus |
objeto | Especifica las extensiones específicas de la plataforma para el objeto de vídeo. |
Objeto Video AppNexus
Se admiten los siguientes campos en el appnexus objeto de extensión del video objeto :
| Campo | Tipo | Descripción |
|---|---|---|
context |
integer | Especifica el contexto del vídeo: - 0:Desconocido- 1: pre-roll- 2: mitad de la tirada- 3: post-roll- 4: outstream- 5: BannerStream- 6: en la fuente- 7:Intersticial |
Objeto Audio
| Campo | Tipo | Descripción |
|---|---|---|
mimes |
matriz de cadenas | (Obligatorio) Especifica los tipos MIME de contenido de audio admitidos; por ejemplo, audio/vnd.wav, audio/mpeg, audio/mp4, audio/oggo audio/mp2. |
minduration |
integer | (Recomendado) Especifica la duración mínima del anuncio de audio, en segundos. |
maxduration |
integer | (Recomendado) Especifica la duración máxima del anuncio de audio, en segundos. |
startdelay |
integer | (Recomendado) Especifica el retraso de inicio del anuncio de audio: - > 0: para valores mayores que cero, el retraso antes del inicio del audio, en segundos.- 0: pre-roll.- -1: mid-roll genérico (retraso desconocido).- -2: post-roll genérico. |
battr |
matriz de enteros | Especifica los atributos creativos de audio que se van a bloquear. Se admite lo siguiente: - 11:Encuestas- 16: el anuncio proporciona el botón Omitir |
minbitrate |
integer | Velocidad mínima de bits, en kilobytes por segundo. |
maxbitrate |
integer | Velocidad de bits máxima, en kilobytes por segundo. |
api |
matriz de enteros | Especifica los marcos de API admitidos para esta impresión. Si una API no aparece explícitamente, se supone que no se admite. Los valores admitidos actualmente son: - 1: VPAID 1.0- 2: VPAID 2.0- 3: MRAID-1- 4: ORMMA- 5: MRAID-2- 6: MRAID-3- 7: OMID-1 |
Objeto nativo
Para las impresiones nativas, se admite el campo siguiente, que contiene el marcado creativo:
| Campo | Tipo | Descripción |
|---|---|---|
request |
string | Marcado creativo representado que se va a entregar; Las creatividades nativas se pueden devolver en este campo como una cadena codificada en JSON. El primer valor de la cadena debe ser native. Para obtener ejemplos de solicitudes de puja nativas, vea Objeto de solicitud a continuación y Solicitudes de puja de ejemplo. |
Request (objeto)
En el caso de las impresiones nativas, el request objeto contiene el objeto creativo en los campos siguientes:
| Campo | Tipo | Descripción |
|---|---|---|
ver |
string | (Recomendado) Especifica la versión de la especificación de anuncio nativo actualmente en uso. Actualmente se admiten las versiones 1.1 y 1.2 . |
plcmtcnt |
integer | Especifica el número de ubicaciones idénticas disponibles en la solicitud de puja. Normalmente 1, pero puede ser un entero diferente si la solicitud de puja es para una fuente con varias ubicaciones dentro de ella. |
plcmttype |
integer | El diseño, el formato o el diseño de la unidad de anuncios que se ofrece. Xandr envía cualquiera de los valores: - 1: en la fuente de contenido.- 4: widget de recomendación. |
privacy |
booleano | Marca para indicar si el vendedor admite un aviso de privacidad específico del comprador. - 0 o ausente: el anuncio nativo no admite vínculos de privacidad personalizados.- 1: el anuncio nativo admite el aviso de privacidad específico del comprador. |
assets |
matriz de objetos | Especifica una lista de recursos que se espera que se devuelvan en la respuesta de la oferta. Vea Assets Object (Objeto de recursos ) a continuación. |
Assets (objeto)
Se admiten los siguientes campos en el assets objeto en el native objeto :
| Campo | Tipo | Descripción |
|---|---|---|
id |
integer | Especifica un identificador único para el recurso en esta solicitud de puja. Normalmente, el primer recurso de la matriz es 1 y los recursos subsiguientes incrementan desde allí. |
required |
integer | Especifica si el recurso es necesario: - 0: el recurso es opcional.- 1: se requiere un recurso. |
title |
objeto | Especifica información sobre el título del recurso. Vea Title Object (Objeto de título ) a continuación. |
img |
objeto | Especifica información sobre la imagen del recurso. Vea Image Object (Objeto de imagen ) a continuación. |
data |
objeto | Especifica información sobre los datos del recurso. Vea Assets Data Object (Objeto de datos de recursos ) a continuación. |
video |
objeto | Especifica información sobre el vídeo del recurso. Consulte Objeto Video para ver los recursos siguientes. |
Title (objeto)
Se admiten los siguientes campos en el title objeto en el assets objeto :
| Campo | Tipo | Descripción |
|---|---|---|
len |
integer | Longitud máxima del texto en el título. |
Objeto de imagen
Se admiten los siguientes campos en el img objeto del assets objeto :
| Campo | Tipo | Descripción |
|---|---|---|
type |
integer | Especifica el identificador de tipo del elemento de imagen solicitado por el publicador. Los valores admitidos son los siguientes: - 1: imagen de icono para su uso en tamaños de pantalla más pequeños (icon_img_url). - 3: vista previa de imagen grande para el anuncio para su uso en tamaños de pantalla más grandes (main_media). |
w |
integer | Especifica el ancho exacto de la imagen, en píxeles. |
wmin |
integer | Especifica el ancho mínimo solicitado de la imagen, en píxeles. Si se incluye, este valor debe usarse para cualquier cambio de escala de imágenes por parte del cliente. Si se incluyen w o wmin, use w como ancho exacto. |
h |
integer | Especifica el alto de la imagen, en píxeles. |
hmin |
integer | Especifica el alto mínimo solicitado de la imagen, en píxeles. Si se incluye, este valor debe usarse para cualquier cambio de escala de imágenes por parte del cliente. Si se incluyen h y hmin, use h como altura exacta. |
mimes |
matriz de cadenas | Especifica los tipos MIME de contenido de imagen admitidos. Debe estar vacío, ya que se admiten todos los tipos de imagen. |
Objeto de datos Assets
Se admiten los siguientes campos en el data objeto del assets objeto :
| Campo | Tipo | Descripción |
|---|---|---|
type |
integer | Especifica el identificador de tipo del elemento admitido por el publicador. El publicador puede mostrar esta información en un formato adecuado. Los valores admitidos son los siguientes: - 1: sponsored - Mensaje "Patrocinado por", donde la respuesta contiene el nombre de marca del patrocinador- 2: desc : texto descriptivo asociado al producto o servicio que se anuncia- 3: rating - Clasificación del producto que se ofrece al usuario. Por ejemplo, la clasificación de una aplicación en una tienda de aplicaciones de 0 a 5.- 12: ctatext : texto descriptivo para un botón de "llamada a la acción" para la dirección URL de destino |
len |
integer | Longitud máxima del texto en la respuesta del elemento. |
Objeto de solicitud de seguimiento de eventos
Se admiten los siguientes campos en el event trackers request objeto (solo nativo 1.2):
| Campo | Tipo | Descripción |
|---|---|---|
event |
integer | Tipo de evento disponible para el seguimiento. Los valores admitidos son los siguientes: - 1: impression - Impresión- 2: viewable-mrc50 - Impresión visible mediante la definición de MRC al 50 % a la vista durante 1 segundo.- 3: viewable-mrc100 - Impresión visible mediante la definición de MRC al 100 % a la vista durante 1 segundo (es decir, estándar de GroupM).- 4: viewable-video50 - Impresión visible para vídeo mediante la definición de MRC al 50 % a la vista durante 2 segundos.- 555: custom value to signify OMID |
methods |
matriz de enteros | Matriz de los tipos de seguimiento disponibles para el evento determinado. Los valores admitidos son los siguientes: - 1: img - Seguimiento de píxeles Img: la dirección URL proporcionada se insertará como un píxel de 1 x 1 en el momento del evento.- 2: js - Seguimiento basado en Javascript: la dirección URL proporcionada se inserta como una js etiqueta en el momento del evento. |
Objeto Video para los recursos
Se admiten los siguientes campos en el video objeto del assets objeto :
| Campo | Tipo | Descripción |
|---|---|---|
mimes |
matriz de cadenas | Tipos MIME de contenido admitidos. Si no se especifican mimes en la solicitud de puja desde el lado de la oferta, el valor predeterminado “video/mp4” será para vídeo normal y “video/x-flv” móvil. |
minduration |
integer | Duración mínima del anuncio de vídeo en segundos. |
maxduration |
integer | Duración máxima del anuncio de vídeo en segundos. |
protocols |
matriz de enteros | Matriz de protocolos de vídeo que el publicador puede aceptar en la respuesta de la puja. Los valores admitidos actualmente son: - 1: VAST 1.0- 2: VAST 2.0- 3: VAST 3.0- 4: CONTENEDOR VAST 1.0- 5: CONTENEDOR VAST 2.0- 6: CONTENEDOR VAST 3.0- 7: VAST 4.0- 8: DAAST 1.0 |
Objeto de Marketplace privado
Se admiten los siguientes campos en el pmp objeto del imp objeto para admitir marketplaces privados (ofertas) entre compradores y vendedores que pueden aplicarse a esta impresión:
| Campo | Tipo | Descripción |
|---|---|---|
private_auction |
integer | Indica la idoneidad de la subasta para los asientos denominados en el deals objeto .- 0: se aceptan todas las ofertas.- 1: solo se aceptan ofertas para ofertas especificadas. |
deals |
matriz de objetos | Especifica información sobre las ofertas de esta oferta. Vea Deal Object (Objeto deal ) a continuación. |
Deal (objeto)
Se admiten los siguientes campos en el deal objeto del pmp objeto :
| Campo | Tipo | Descripción |
|---|---|---|
id |
string | (Obligatorio) Especifica un identificador único para la oferta. |
bidfloor |
float | Especifica el precio mínimo de la oferta, en CPM con la moneda predeterminada (USD). Si se omite, el valor predeterminado es 0.00. |
at |
integer | Invalidación opcional del tipo de subasta general de la solicitud de puja. Si se omite, el valor predeterminado es 2.- 1: primer precio.- 2: segundo precio más un centavo (valor predeterminado).- 3: el piso de oferta es el precio de transacción acordado (precio fijo). |
wseat |
matriz de cadenas | Especifica una lista de identificadores de puestos de comprador que pueden pujar por esta oferta. Si no se especifica ningún asiento, todos los compradores son elegibles. |
ext |
objeto | Se usa para identificar extensiones específicas de la plataforma en OpenRTB para el objeto deal. Vea Deal Extension Object (Objeto de extensión de oferta ) a continuación. |
Deal extension (objeto)
Se admite un único objeto en el ext objeto para admitir extensiones específicas de la plataforma para el deal objeto :
| Campo | Tipo | Descripción |
|---|---|---|
appnexus |
objeto | Especifica las extensiones específicas de la plataforma para el objeto deal. |
Deal AppNexus (objeto)
Se admiten los siguientes campos en el appnexus objeto de extensión del deal objeto :
| Campo | Tipo | Descripción |
|---|---|---|
ad_quality_override |
integer | Especifica cómo controla la oferta las creatividades: - 1: los creativos usan la configuración de calidad de anuncios existente (valor 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á ninguna restricción de perfil de anuncio a esta oferta (máxima confianza). |
allowed_media_types |
matriz de enteros | Especifica los identificadores de los tipos de medios que se permiten en esta oferta. Para obtener una lista de tipos de medios, vea Expandables y Rich Media. 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 (cualquier cosa que no aparezca específicamente en el objeto "battr") se puede usar al pujar por esta oferta. Si se rellena esta matriz, contendrá una lista completa de los tipos de medios permitidos en esta oferta. |
allowed_media_subtypes |
matriz de enteros | Especifica los identificadores de los subtipos multimedia que se permiten en esta oferta. Para obtener una lista de subtipos multimedia, vea Expandables y Rich Media. 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 simplemente significa que los subtipos multimedia en el objeto de puja principal (cualquier cosa que no aparezca específicamente en el objeto "battr") se pueden usar al pujar por esta oferta. Si se rellena esta matriz, contendrá una lista completa de tipos de submedia permitidos en esta oferta. |
sizes |
matriz de objetos | Especifica los tamaños de creatividad permitidos para esta oferta. Si se rellena esta matriz, contendrá una lista completa de tamaños permitidos en esta oferta. Los tamaños permitidos en la oferta no tienen que ser un subconjunto de lo que se permite en el objeto de solicitud de puja principal. Si la matriz está vacía, esto significa que no hay tamaños únicos para esta oferta y se deben usar los tamaños permitidos del objeto de puja principal. Vea El objeto Sizes a continuación. |
sc |
integer | Especifica si el campo wseat del objeto deal pasa un identificador de asiento de comprador. Este campo solo está presente para las ofertas configuradas con el identificador de asiento del comprador de DSP y pasará un valor de "1". |
gtd |
integer | Especifica si la oferta está garantizada mediante programación. Este campo solo está presente para las ofertas configuradas como garantizadas mediante programación y pasará un valor de "1". |
Objeto Sizes
Se admiten los siguientes campos en el sizes objeto del objeto deal ext .
| Campo | Tipo | Descripción |
|---|---|---|
w |
integer | Especifica el ancho de la creatividad permitida para esta oferta, en píxeles. |
h |
integer | Especifica el alto de la creatividad permitida para esta oferta, en píxeles. |
Objeto de extensión de impresión
Se admite un único objeto en el ext objeto para admitir extensiones específicas de la plataforma para el imp objeto :
| Campo | Tipo | Descripción |
|---|---|---|
appnexus |
objeto | Especifica las extensiones específicas de la plataforma para el objeto de impresión. |
Impression AppNexus (objeto)
Se admiten los siguientes campos en el appnexus objeto de extensión del imp objeto :
| Campo | Tipo | Descripción |
|---|---|---|
estimated_clear_price |
double | Especifica el precio claro estimado necesario para ganar la impresión. Se supone que el precio está en la moneda del publicador. Si no es así, debe especificar las unidades de moneda. |
predicted_view_rate |
double | Especifica la probabilidad de que el usuario pueda ver la impresión como un porcentaje de las impresiones de pantalla medidas, en función de los datos históricos. |
predicted_view_rate_over_total |
double | Especifica la probabilidad de que el usuario pueda ver la impresión en todas las impresiones de visualización, en función de los datos históricos. |
predicted_video_view_rate_over_total |
double | Especifica la probabilidad de que el usuario pueda ver la impresión en todas las impresiones de vídeo, en función de los datos históricos. |
predicted_video_view_rate |
double | Especifica la probabilidad de que el usuario pueda ver la impresión como un porcentaje de las impresiones de vídeo medidas, en función de los datos históricos. |
member_ad_profile_id |
integer | Especifica el identificador de perfil de anuncio del vendedor. |
allowed_payment_types |
matriz de objetos | Especifica los tipos de pagos permitidos para esta impresión. Si este campo no está presente, el único tipo de pago permitido es 'impression'.Nota: Este objeto no está habilitado para todos los clientes. Póngase en contacto con el representante de su cuenta para obtener esta característica. |
traffic_source_code |
string | Especifica el origen externo del tráfico de terceros para esta impresión. |
predicted_video_completion_rate |
double | Especifica la probabilidad de que un usuario vea completamente la impresión de vídeo, en función de los datos históricos. |
gpid |
string | Identificador global de nivel de ubicación proporcionado por el publicador para indicar una ubicación de anuncio específica en la página. |
Objeto de tipos de pago permitidos
En el allowed_payment_types objeto se admiten los siguientes campos:
Nota:
Este objeto no está habilitado para todos los clientes. Póngase en contacto con el representante de su cuenta para obtener esta característica.
| Campo | Tipo | Descripción |
|---|---|---|
payment_type |
integer | Especifica el tipo de pago permitido para esta impresión. Valores admitidos actualmente: - 1:Impresión- 2: vistas: presentación estándar- 6: vistas: visualización personalizada: 100pv1s- 8: vistas: vídeo estándar- 9: vistas: vídeo personalizado: 100pv50pd |
conversion_rate |
double | Especifica la tasa que Xandr usa para convertir una oferta que no sea de impresión a un precio de eCPM para la clasificación de pujas en la subasta. Un licitador puede usarlo para la clasificación interna de ofertas, presupuestos o ritmos, o potencialmente para otros. |
imp_count_method |
Entero | Especifica cómo se cuenta la impresión. Valores admitidos actualmente: - 0: no aplicable- 1:Desconocido- 2: recuento de representación- 3: cuente con la decisión o el servicio |
Para obtener más información, consulte la página Información general .
Objeto del sitio
Los sitios (también conocidos como grupos de selección de ubicación) son un subconjunto del inventario de un publicador. En el site objeto se admiten los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
id |
string | Recomendado. Especifica el identificador de sitio de Xandr. Se omite si la visibilidad del vendedor prohíbe el uso compartido. Los licitadores no pueden buscar en qué sitio corresponde el identificador, pero estos identificadores se pueden usar como fragmentos de inventario anónimos y optimizables. |
domain |
string | Especifica el dominio del sitio (por ejemplo, publishersite.com). Se omite si la visibilidad del vendedor prohíbe el uso compartido. |
cat |
matriz de cadenas | Especifica una lista de categorías de contenido. Incluye categorías de IAB (enumeradas en la sección 5.1 de la especificación). Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
page |
string | Especifica la dirección URL completa de la página donde se muestra la impresión (por ejemplo, page.publishersite.com/path/to/page). Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. Contiene el dominio en lugar de la dirección URL completa si solo se expone el dominio en el perfil de visibilidad. |
publisher |
objeto | Especifica información sobre el publicador. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. Consulte Publisher Object (Objeto de publicador ) a continuación. |
content |
objeto | Detalles sobre el contenido del sitio. Vea Content Object (Objeto de contenido ) a continuación. |
ext |
objeto | Se usa para almacenar campos de extensión de aplicación. Vea Objeto de extensión de sitio a continuación. |
Objeto de extensión de sitio
Se admiten los siguientes campos en el objeto ext del objeto de sitio.
| Campo | Tipo | Descripción |
|---|---|---|
inventorypartnerdomain |
objeto | El valor pasado en este campo indica al app-ads.txt aplicador que compruebe el archivo app-ads.txt de la aplicación para la directiva inventorypartnerdomain=[value de este campo]. |
App (objeto)
En el app objeto se admiten los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
id |
string | Especifica el identificador de la aplicación Xandr. Se omite si la visibilidad del vendedor prohíbe el uso compartido. Los licitadores no pueden buscar en qué sitio corresponde el identificador, pero estos identificadores se pueden usar como fragmentos de inventario anónimos y optimizables. |
bundle |
string | Especifica el paquete de aplicaciones o el nombre del paquete (por ejemplo, com.foo.mygame). Está pensado para ser un identificador único en varios intercambios. Para iOS, este será el identificador de aplicación de iTunes (id. numérico). Se omite si la visibilidad del vendedor prohíbe el uso compartido. |
cat |
matriz de cadenas | Especifica una lista de categorías de contenido. Incluye categorías de IAB (enumeradas en la sección 5.1 de la especificación). Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
publisher |
objeto | Especifica información sobre el publicador. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. Consulte Publisher Object (Objeto de publicador ) a continuación. |
name |
string | Nombre completo de la aplicación (es decir, Angry Birds). (Este valor puede estar aliasado a petición del publicador). |
content |
objeto | Detalles sobre el contenido del sitio. Vea Content Object (Objeto de contenido ) a continuación. |
storeurl |
string | Dirección URL de la Tienda de aplicaciones para una aplicación instalada. |
ext |
objeto | Se usa para almacenar campos de extensión de aplicación. Consulte Objeto de extensión de aplicación a continuación. |
Publisher (objeto)
Se admite el campo siguiente en el publisher objeto :
| Campo | Tipo | Descripción |
|---|---|---|
id |
string | Especifica el identificador del publicador de Xandr. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
Content (objeto)
Xandr admite los siguientes campos en el objeto Content:
| Campo | Tipo | Descripción |
|---|---|---|
genre |
string | Género que mejor describe el contenido (por ejemplo, rock, pop, etc.). |
id |
string | Identificador que identifica de forma única el contenido. |
language |
string | Lenguaje de contenido mediante ISO-639-1-alpha-2. |
ext |
objeto | Marcador de posición para extensiones específicas del intercambio en OpenRTB. |
episode |
integer | Número de episodio. |
title |
string | Título del contenido. Ejemplos de vídeo: "Search Committee" (televisión), "A New Hope" (película) o "Endgame" (hecho para web). Ejemplo que no es de vídeo: "Por qué un glaciar antártico se está derritiendo tan rápidamente" (artículo de la revista Time). |
series |
string | Ejemplos de vídeo: "The Office" (televisión), "Star Wars" (película) o "Arby 'N' The Chief" (hecho para web). Ejemplo que no es de vídeo: "Ecocéntrico" (blog de Time Magazine). |
season |
string | Temporada de contenido (por ejemplo, "Temporada 3"). |
artist |
string | Artista acreditado con el contenido. |
album |
string | Álbum al que pertenece el contenido; normalmente para el audio. |
isrc |
string | Código de grabación estándar internacional conforme a la norma ISO-3901. |
producer |
objeto | Detalles sobre el contenido Producer. Consulte la sección 3.2.12 en la especificación de IAB. |
url |
string | Dirección URL del contenido, para contextualización o revisión en el lado de compra. |
cat |
matriz de cadena | Matriz de categorías de contenido de IAB que describen el productor de contenido. Consulte la lista 5.1 en la especificación de IAB. |
prodq |
integer | Calidad de producción. Consulte la lista 5.11 en la especificación de IAB. |
videoquality |
integer | En desuso a favor de prodq. Calidad de vídeo. Consulte la lista 5.11 en la especificación de IAB. |
context |
integer | Tipo de contenido (juego, vídeo, texto, etc.). Consulte la lista 5.16 en la especificación de IAB. |
contentrating |
string | Clasificación de contenido (por ejemplo, MPAA). |
userrating |
string | Clasificación por el usuario del contenido (por ejemplo, número de estrellas, me gusta, etc.). |
qagmediarating |
integer | Clasificación multimedia según las directrices de IQG. Consulte la lista 5.17 en la especificación de IAB. |
keywords |
string | Lista separada por comas de palabras clave que describen el contenido. |
livestream |
integer |
0 = no en directo, 1 = el contenido está en directo (por ejemplo, streaming, blog en directo). |
sourcerelationship |
integer |
0 = indirecto, 1 = directo. |
len |
integer | Longitud del contenido en segundos; adecuado para vídeo o audio. |
data |
matriz de objetos | Datos de contenido adicionales. Cada objeto Data representa un origen de datos diferente. Consulte la sección 3.2.16 en la especificación de IAB. |
Objeto de extensión de contenido
Xandr admite el campo siguiente en el objeto ext:
| Campo | Tipo | Descripción |
|---|---|---|
network |
string | La empresa primaria de nivel superior o, si procede, una submarca que posee varios canales similares a tv, marcas de contenido d2c o propiedades digitales en las que se está viendo el contenido. |
Objeto de extensión de aplicación
Se admiten los siguientes campos en el objeto ext del objeto de aplicación.
| Campo | Tipo | Descripción |
|---|---|---|
inventorypartnerdomain |
string | El valor pasado en este campo indica al app-ads.txt aplicador que compruebe el archivo app-ads.txt de la aplicación para la directiva inventorypartnerdomain=[value de este campo]. |
Device (objeto)
Se admiten los siguientes campos en el device objeto .
| Campo | Tipo | Descripción |
|---|---|---|
ua |
string | (Recomendado) Especifica la cadena del agente de usuario desde el explorador. El agente de usuario suele identificar información como la aplicación, el sistema operativo y el proveedor de software que actúa en nombre del usuario, por ejemplo, "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US; rv:1.9.0.4) Gecko/2008102920 Firefox/3.0.4". |
geo |
objeto | Especifica la ubicación del dispositivo, como se deriva de los servicios de ubicación del dispositivo (como la triangulación de la torre de celdas o GPS) o la dirección IP. También incluye la zona horaria y un código para el área de mercado designada. Nota: geo invalida la dirección IP. Para obtener más información, consulte Objeto geográfico. |
dnt |
integer | Especifica la configuración No realizar seguimiento: - 0: Do Not Track está establecido en false en el explorador (se permite el seguimiento).- 1: Do Not Track está establecido en true en el explorador (el usuario ha optado por no realizar el seguimiento). |
ip |
string | Especifica la dirección IPv4 más cercana al dispositivo. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
ipv6 |
string | Dirección IP más cercana al dispositivo como IPv6. |
devicetype |
integer | Especifica el tipo de dispositivo mediante valores IAB: - 1: Móvil/Tableta- 2:Ordenador personal- 3: TV conectada- 4:Teléfono- 5:Tableta- 6: dispositivo conectado- 7: establecer el cuadro superior |
make |
string | Especifica la make del dispositivo. |
model |
string | Especifica el modelo del dispositivo. |
os |
string | Especifica el sistema operativo del dispositivo. Si se pasa, esto invalida el sistema operativo en el campo ua. A continuación se muestran los valores posibles en el campo os: - "Desconocido" - "Android" - "Apple iOS" - "Apple Mac" - "Microsoft Windows" - "Sistema operativo Blackberry" - "Microsoft Mobile" - "Linux" - "Symbian OS" - "Chrome OS" - "Sistema operativo PlayStation 4" - "Firefox OS" - "Roku OS" |
language |
string | Especifica el idioma del explorador; usar códigos ISO 639-1 o ISO 3166 alfa-2. |
lmt |
integer | La señal "Limitar seguimiento de anuncios" aprobada comercialmente (por ejemplo, iOS, Android), donde 0=tracking no es restringido, 1=tracking debe estar limitado según las directrices comerciales. |
carrier |
string | Especifica el operador del dispositivo. |
connectiontype |
integer | Especifica el tipo de conexión de datos detectado para el dispositivo mediante valores IAB. Hoy se admiten los siguientes valores: - 0:Desconocido- 3: Red de telefonía móvil: generación desconocida |
ifa |
string | Especifica el identificador autorizado para el uso del anunciante en el texto no cifrado. Establezca en iOS idfa, Android aaido Windows adid si está disponible. También se establece para las impresiones de CTV, usando los tipos de identificador de dispositivo proporcionados por el dispositivo, proporcionados por el publicador u otros tipos de identificadores de dispositivo según corresponda. Para obtener más información, consulte ext.ifa_type. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
dpidsha1 |
string | Especifica el identificador único sha1 cifrado, específico de la plataforma (por ejemplo, ANDROID_ID o UDID para iOS) para el dispositivo móvil. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
dpidmd5 |
string | Especifica el identificador único de MD5, específico de la plataforma (por ejemplo, ANDROID_ID o UDID para iOS) para el dispositivo móvil. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
ext |
objeto | Se usa para identificar extensiones específicas de la plataforma en OpenRTB para el objeto geográfico. Vea Geo Extension Object (Objeto de extensión geográfica) a continuación. |
Geo (objeto)
En el geo objeto se admiten los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
lat |
float | Especifica la latitud del dispositivo, como se deriva de los servicios de ubicación del dispositivo. Esto puede oscilar entre -90 y 90. El sur es negativo. |
lon |
float | Especifica la longitud del dispositivo, derivada de los servicios de ubicación del dispositivo. Esto puede oscilar entre -180 y 180. Oeste es negativo. |
country |
string | Especifica el nombre del país, según ISO-3166-1 Alpha-3. |
region |
string | Código de región mediante ISO-3166-2; Código de estado de 2 letras si USA. |
city |
string | Especifica el nombre de la ciudad. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
zip |
string | Especifica el código POSTAL o postal donde se encuentra el dispositivo. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
metro |
string | Contiene un código para el área de mercado designada por el usuario en función de su dirección IP (si se puede determinar la dirección IP). |
utcoffset |
Entero | Indica la hora local como un desplazamiento de UTC. |
ext |
objeto | Se usa para identificar extensiones específicas de la plataforma en OpenRTB para el objeto geográfico. Vea Geo Extension Object (Objeto de extensión geográfica) a continuación. |
Objeto de extensión geográfica
Se admite un único objeto en el ext objeto para admitir extensiones específicas de la plataforma para el geo objeto :
| Campo | Tipo | Descripción |
|---|---|---|
appnexus |
objeto | Especifica las extensiones específicas de la plataforma para el objeto geográfico. Para obtener una lista de las extensiones de este objeto, vea Geo AppNexus Object (Objeto Geo AppNexus ) a continuación. |
Objeto Geo AppNexus
Se admite el campo siguiente en el appnexus objeto de extensión del geo objeto :
| Campo | Tipo | Descripción |
|---|---|---|
timezone |
string | Contiene la zona horaria del usuario en función de la dirección IP (si se puede determinar la dirección IP). |
Objeto de extensión de dispositivo
Se admite un único objeto en el ext objeto para admitir extensiones específicas de la plataforma para el device objeto :
| Campo | Tipo | Descripción |
|---|---|---|
ifa_type |
string | Especifica el origen de la IFA, si se genera en el dispositivo (y, por lo tanto, se usa en todas las aplicaciones) o si es un IFA proporcionado por un publicador o un IFA temporal o de sesión. Se usa principalmente para impresiones de CTV. Los tipos de IFA son Dispositivo, Publicador (incluidas las aplicaciones), SSP y Sesión. A continuación se muestran los valores recomendados para el ifa_type parámetro :- "pppd": el "id. proporcionado por el dispositivo" genérico, pero en función del uso histórico, se pueden usar valores específicos del tipo de dispositivo común. - "rida" - Id. de Roku - "aaid": id. de Android - "idfa": id. de Apple - "afai" - Amazon Fire id - "tifa" - Tizen Identifier for Advertising (Samsung Ad ID) - "vida" - Vizio Advertising ID - "lgudid": id. de dispositivo único de LG - "msai": id. de Microsoft - "ppid": id. proporcionado por el publicador - "sspid": identificador proporcionado por SSP - "sessionid": id. de sesión/id. sintético (que se describe a continuación) |
User (objeto)
En el user objeto se admiten los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
id |
string | (O idbuyeruid se recomienda) Especifica el identificador único de Xandr para este usuario. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. Identificador único de 64 bits para el usuario. Es lo mismo para todas las solicitudes de este usuario hasta que se borran las cookies. Este campo es 0 cuando Xandr no tiene una coincidencia para este usuario o el explorador del usuario no acepta cookies. Es -1 para usuarios que no pueden participar. |
buyeruid |
string | (O idbuyeruid se recomienda) El identificador único del comprador para este usuario, si se conoce. Se omite si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
yob |
integer | Especifica el año de nacimiento como un entero de 4 dígitos. Se omite si se desconoce o si la configuración de visibilidad del vendedor prohíbe el uso compartido. |
gender |
string | Especifica el género. Establézcalo null en si es desconocido. Se omite si se desconoce o la configuración de visibilidad del vendedor prohíbe el uso compartido.- M:Masculino- F:Hembra- O:Otro |
data |
matriz de objetos | Especifica información sobre los datos del usuario. Vea Objeto de datos de usuario a continuación. |
ext |
objeto | Se usa para identificar extensiones específicas de la plataforma en OpenRTB para el objeto de usuario. |
Objeto de datos de usuario
Se admiten los siguientes campos en el data objeto del user objeto :
| Campo | Tipo | Descripción |
|---|---|---|
id |
string | Especifica el identificador del proveedor de datos. |
segment |
matriz de objetos | En desuso (abril de 2019). |
Objeto de extensión de usuario
Se admiten los siguientes campos en el ext objeto para admitir extensiones específicas de la plataforma para el user objeto :
| Campo | Tipo | Descripción |
|---|---|---|
appnexus |
objeto | Especifica las extensiones específicas de la plataforma para el objeto de usuario. Vea a continuación una lista de las extensiones de este objeto. |
consent |
string | Opcional. Contiene la estructura de datos desarrollada por el Grupo de Trabajo de Consentimiento del Reglamento General de Protección de Datos (RGPD) bajo los auspicios de IAB Europa. |
eids |
objeto | Especifica la información relacionada con los identificadores de usuario extendidos. Puede ser soluciones de identidad de terceros (Criteo, TDID, RampID, etc.) o identificadores proporcionados por publisher (PPID). |
Objeto
Nota:
eids no está disponible si las señales de privacidad indican que no se puede procesar la información personal.
En el eids objeto se admiten los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
source |
string | Especifica el dominio de la organización que es el generador del identificador de terceros. |
uids |
Objeto | Especifica la información de identidad específica de la solución de identidad de terceros o el publicador. Los campos pertinentes incluyen: id string Id. de usuario proporcionado por la solución de identidad de terceros o el publicador. Ext Objeto Especifica información adicional específica proporcionada por la solución de identidad de terceros o el publicador. Los campos ext incluyen: rtiPartner = nombre de la solución de identidad de terceros, usado por TDID. |
Segment (objeto)
Advertencia
Este objeto está en desuso (2019).
Se admiten los siguientes campos en el segment objeto del objeto de usuario data :
| Campo | Tipo | Descripción |
|---|---|---|
id |
string | Especifica el identificador de segmento Xandr. |
value |
string | Especifica el valor del segmento de datos. |
Regs (objeto)
En el regs objeto se admiten los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
coppa |
integer | Indica si esta solicitud está sujeta a la Ley de protección de la privacidad en línea (COPPA) de los Estados Unidos. - 0: no está sujeto a COPPA. Tratar como una subasta normal.- 1: sujeto a COPPA. Limite lo que se permite para el destino y el registro según sea necesario. |
ext |
objeto | Se usa para identificar extensiones específicas de la plataforma en OpenRTB para el objeto reg. |
gpp |
Indica la cadena de consentimiento de GPP de IAB real. Implica qué proveedores pueden procesar datos personales y en qué condiciones. Ejemplo: { "Regs": { "ext": { "gpp": "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN", "gpp_sid": [2,6]} } } |
|
gpp_sid |
Opcional: indica qué regulaciones o lógicas GPP se van a aplicar, o si un usuario se encuentra en un país (país del EEE) con un marco que forma parte del GPP. Ejemplo: { "Regs": { "ext": { "gpp": "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN", "gpp_sid": [2,6]} } } |
Regs (objeto de extensión)
Se admite el campo siguiente en el regs.ext objeto :
| Campo | Tipo | Descripción |
|---|---|---|
gdpr |
integer | Opcional. Indica si la solicitud está o no sujeta a las regulaciones del Reglamento General de Protección de Datos (RGPD). Posibles valores: - 0: No, la solicitud no está sujeta a las regulaciones del RGPD.- 1: sí, la solicitud está sujeta a las regulaciones del RGPD.Ningún valor indica Desconocido. |
us_privacy |
string | La cadena de privacidad de EE. UU. admite actualmente el cumplimiento de CCPA pasando la siguiente información en la cadena: Versión de especificación Número (1 char en cadena) Versión de esta especificación de cadena usada para codificar la cadena Aviso explícito o oportunidad de cancelar la participación ENUM ( N = No, Y = Sí, - = No aplicable)Se ha proporcionado un aviso explícito según lo requerido por 1798.115(d) del CCPA y la oportunidad de no participar en la venta de sus datos de conformidad con los artículos 1798.120 y 1798.135 del CCPA. Venta de exclusión ENUM ( N = No, Y = Sí, - = No aplicable)¿Ha optado por no participar en la venta de su información personal o en virtud de los 1798.120 y 1798.135 LSPA ENUM ( N = No, Y = Sí, - = No aplicable)Publisher es signatario de los límites de IAB que se definen en el Acuerdo. d Contrato de proveedor de servicios (LSPA) y el publicador declara que la transacción está cubierta como una "transacción de exclusión cubierta" o una "transacción sin exclusión" tal como se definen en el Contrato. esos términos se definen en el Acuerdo. |
gpp |
Indica la cadena de consentimiento de GPP de IAB real. Implica qué proveedores pueden procesar datos personales y en qué condiciones. Ejemplo: { "Regs": { "ext": { "gpp": "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN", "gpp_sid": [2,6]} } } |
|
gpp_sid |
Opcional: indica qué regulaciones o lógicas GPP se van a aplicar, o si un usuario se encuentra en un país (país del EEE) con un marco que forma parte del GPP. Ejemplo: { "Regs": { "ext": { "gpp": "DBACNYA~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA~1YNN", "gpp_sid": [2,6]} } } |
|
dsa |
Indica si la solicitud está sujeta a la Ley de Servicios Digitales (DSA). Para obtener más información, consulte aquí. Ejemplo: { dsarequired: 1, pubrender: 0, transparency: [ { domain: 'request.tomato.com', dsaparams: [ 1 ] },{ domain: 'request2.tomato.com', dsaparams: [ 1, 2, 3 ] }],datatopub: 1 } |
Source (objeto)
En el source objeto se admiten los siguientes campos:
| Campo | Tipo | Descripción |
|---|---|---|
fd |
integer | Entidad responsable de la decisión de venta de impresiones finales, donde: - 0: exchange (valor predeterminado)- 1: origen ascendente |
tid |
string | Identificador de transacción que debe ser común entre todos los participantes en esta solicitud de puja. El valor se pasará desde el vendedor. Si el vendedor no proporciona un identificador de transacción, creamos uno y lo compartimos. |
Solicitudes de puja de ejemplo
Solicitud de puja de Banner
{
"id": "8765482113786061111",
"imp": [{
"id": "7654319310942953333",
"banner": {
"w": 320,
"h": 50,
"id": "1",
"battr": [1, 2, 15],
"pos": 0,
"format": [{
"w": 320,
"h": 50
}]
},
"instl": 0,
"tagid": "12347654",
"secure": 1,
"ext": {
"appnexus": {
"estimated_clear_price": 0.57,
"predicted_view_rate": 0.073255,
"member_ad_profile_id": 1111055,
"predicted_video_completion_rate": 0.592172,
"predicted_view_rate_over_total": 0.067229,
"allowed_payment_types": [{
"payment_type": 1,
"imp_count_method": 2
}]
}
}
}],
"site": {
"id": "3232399",
"domain": "example.com",
"cat": ["IAB12-2", "IAB12", "IAB11-5"],
"page": "https://example.com/somepage.md",
"publisher": {
"id": "1111999"
}
},
"device": {
"ua": "Mozilla/5.0 (Linux; Android 6.0.1; HUAWEI Build/MMB28B) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.137 Mobile Safari/537.36",
"geo": {
"lat": 36.6203,
"lon": -4.4998,
"country": "ESP",
"region": "MA",
"metro": "1",
"city": "UnaCuidad",
"zip": "11111",
"utcoffset": 60,
"ext": {
"appnexus": {
"timezone": "Africa/Ceuta"
}
}
},
"dnt": 0,
"ip": "11.222.111.0",
"devicetype": 4,
"make": "Unknown",
"model": "Generic Android Mobile",
"os": "Android",
"language": "es",
"connectiontype": 0
},
"user": {
"id": "7939999668795769876",
"buyeruid": "CABBBBrbuQ9AA5DMJJJJlOL9ZOo",
"gender": "O",
"data": [{
"id": "0",
"segment": [{
"id": "1",
"value": "0"
}]
}, {
"id": "1234",
"segment": [{
"id": "4444555",
"value": "0"
}]
}],
"ext": {
"appnexus": {
"userdata_json": "{\"uid\":\"CABBBBrbuQ9AA5DMJJJJlOL9ZOo\"}"
}
}
},
"test": 0,
"at": 1,
"tmax": 150,
"wseat": ["1234",..., "9988"],
"cur": ["USD"],
"bcat": ["IAB23-7", "IAB23-5", "IAB23-10", "IAB23-9", "IAB23-1", "IAB7-44", "IAB9-9", "IAB8-18", "IAB8-5"],
"badv": ["url1.com", "url2.com"],
"ext": {
"appnexus": {
"seller_member_id": 123,
"publisher_integration": {
"is_header": 0
}
},
"schain": {
"complete": 1,
"nodes": [{
"asi": "appnexus.com",
"sid": "123",
"rid": "2dd111ff-7777-4abc-8558-86a123ab46d6",
"hp": 1
}],
"ver": "1.0"
}
},
"source": {
"fd": 1,
"tid": "2dd111ff-7777-4abc-8558-86a123ab46d6"
}
}
Solicitud de puja nativa 1.1
{
"id": "123456789",
"imp": [{
"id": "987654321",
"native": {
"request": "{\"ver\":\"1.1\",\"plcmttype\": 4,\"plcmtcnt\": 1,\"assets\":[{\"id\": 1,\"required\": 1,\"title\":{\"len\": 140}},{\"id\": 4,\"required\": 1,\"img\":{\"type\": 3,\"wmin\": 600,\"hmin\": 315}},{\"id\": 2,\"required\": 0,\"img\":{\"type\": 1,\"wmin\": 320,\"hmin\": 180}},{\"id\": 6,\"required\": 1,\"data\":{\"type\": 2,\"len\": 205}},{\"id\": 5,\"required\": 1,\"data\":{\"type\": 1,\"len\": 140}}]}}",
"ver": "1.1"
},
"instl": 0,
"secure": 0,
"ext": {
"appnexus": {
"estimated_clear_price": 11.644000,
"member_ad_profile_id": 667317,
"predicted_view_rate_over_total": 0.000000
}
}
}],
"app": {
"id": "1234",
"bundle": "com.news.example"
},
"device": {
"ua": "iPad; OS like Mac OS X; iOS 9.2; STR 2.2.4",
"geo": {
"country": "USA",
"city": "Wilmington",
"zip": "01887"
},
"dnt": 0,
"ip": "198.51.100.2",
"devicetype": 1,
"make": "Apple",
"model": "iPad",
"os": "Apple iOS",
"connectiontype": 0
},
"user": {
"id": "2233445566",
"data": [{
"id": "0",
"segment": [{
"id": "1",
"value": "0"
}]
}],
"ext": {
"appnexus": {
"userdata_json": "{}"
}
}
},
"test": 0,
"at": 2,
"tmax": 2000,
"wseat": [
"1234"
],
"cur": [
"USD"
],
"ext": {
"appnexus": {
"seller_member_id": 1234
},
"schain": {
"complete": 1,
"nodes": [{
"asi": "appnexus.com",
"sid": "1234",
"rid": "25e2b11c-004f-4903-a912-5aef7732096b",
"hp": 1
}],
"ver": "1.0"
}
}
}
Solicitud de puja multimedia
Para asegurarse de que el licitador está configurado para recibir estas solicitudes, abra un caso de soporte técnico.
{
"id": "914181541748747384",
"imp": [{
"id": "837746433617288491",
"banner": {
"w": 320,
"h": 250,
"id": "1",
"battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
"pos": 0,
"api": [3, 5],
"format": [{
"w": 320,
"h": 250
}, {
"w": 1,
"h": 1
}, {
"w": 1,
"h": 1
}]
},
"native": {
"request": "{\"ver\":\"1.2\",\"plcmtcnt\":1,\"assets\":[{\"id\":7,\"required\":0,\"img\":{\"type\":3}},{\"id\":8,\"required\":0,\"img\":{\"type\":1}},{\"id\":1,\"required\":0,\"title\":{\"len\":100}},{\"id\":2,\"required\":0,\"data\":{\"type\":2,\"len\":300}},{\"id\":3,\"required\":0,\"data\":{\"type\":12,\"len\":20}},{\"id\":4,\"required\":0,\"data\":{\"type\":1}},{\"id\":5,\"required\":0,\"data\":{\"type\":3}}],\"plcmttype\":4,\"eventtrackers\":[{\"event\":1,\"methods\":[1]}]}",
"ver": "1.2"
},
"instl": 0,
"tagid": "12345678",
"secure": 1,
"pmp": {
"private_auction": 0,
"deals": [{
"id": "345667",
"bidfloor": 4,
"bidfloorcur": "USD",
"at": 2,
"wseat": ["1234"],
"ext": {
"appnexus": {
"sizes": [{
"w": 1,
"h": 1
}, {
"w": 320,
"h": 250
}]
}
}
}, {
"id": "345678",
"bidfloor": 3,
"bidfloorcur": "USD",
"at": 2,
"wseat": ["1234"],
"ext": {
"appnexus": {
"sizes": [{
"w": 1,
"h": 1
}, {
"w": 320,
"h": 250
}]
}
}
}]
},
"ext": {
"appnexus": {
"estimated_clear_price": 10.72,
"predicted_view_rate": 0.784599,
"member_ad_profile_id": 23456,
"predicted_video_completion_rate": 0,
"predicted_view_rate_over_total": 0.764223,
"allowed_payment_types": [{
"payment_type": 1,
"imp_count_method": 2
}]
}
}
}],
"app": {
"id": "3840770",
"name": "FunAPP",
"bundle": "no.funapp.android",
"publisher": {
"id": "123567"
}
},
"device": {
"ua": "Mozilla/5.0 (Linux; Android 9; SM-G965F Build/PPR1.180610.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/74.0.3729.157 Mobile Safari/537.36",
"geo": {
"country": "NOR",
"region": "02",
"metro": "2435",
"city": "Hakadal",
"zip": "1487",
"utcoffset": 120,
"ext": {
"appnexus": {
"timezone": "Europe/Oslo"
}
}
},
"lmt": 0,
"ip": "123.23.100.5",
"devicetype": 4,
"make": "Samsung",
"model": "SM-G965F",
"os": "Android",
"connectiontype": 0,
"ifa": "0b3979c6-9c84-4359-a5e6-ee6565048fde",
"ext": {
"ifa_type": "aaid"
}
},
"user": {
"id": "4038657820804547795",
"buyeruid": "S5670DGCSRG"
},
"at": 2,
"tmax": 100,
"wseat": ["3456"],
"cur": ["USD"],
"bcat": ["IAB9-9", "IAB8-5", "IAB8-18"],
"badv": ["some_advertiser_domain.com"],
"regs": {
"coppa": 0
},
"source": {
"fd": 0,
"tid": "5676d767-e8b8-43b1-b7bf-fd6056b65018"
},
"ext": {
"appnexus": {
"seller_member_id": 1234,
"publisher_integration": {
"is_header": 0
}
},
"schain": {
"complete": 1,
"nodes": [{
"asi": "appnexus.com",
"sid": "1234",
"rid": "5676d767-e8b8-43b1-b7bf-fd6056b65018",
"hp": 1
}],
"ver": "1.0"
}
}
}
Solicitud de puja multitag
{
"id": "5698201228871522665",
"imp": [{
"id": "13529449707735835",
"banner": {
"w": 300,
"h": 250,
"id": "1",
"battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
"pos": 0,
"format": [{
"w": 300,
"h": 250
}]
},
"instl": 0,
"tagid": "123456",
"secure": 1,
"ext": {
"appnexus": {
"estimated_clear_price": 0.5,
"member_ad_profile_id": 1234,
"allowed_payment_types": [{
"payment_type": 1,
"imp_count_method": 2
}]
}
}
},
{
"id": "2460698130037038280",
"banner": {
"w": 580,
"h": 400,
"id": "1",
"battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
"pos": 0,
"format": [{
"w": 580,
"h": 400
}, {
"w": 580,
"h": 500
}]
},
"instl": 0,
"tagid": "123457",
"secure": 1,
"ext": {
"appnexus": {
"estimated_clear_price": 12.4,
"member_ad_profile_id": 1235,
"allowed_payment_types": [{
"payment_type": 1,
"imp_count_method": 2
}]
}
}
}, {
"id": "5610871170052394076",
"banner": {
"w": 580,
"h": 400,
"id": "1",
"battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
"pos": 0,
"format": [{
"w": 580,
"h": 400
}, {
"w": 580,
"h": 500
}]
},
"instl": 0,
"tagid": "123478",
"secure": 1,
"ext": {
"appnexus": {
"estimated_clear_price": 11.14,
"member_ad_profile_id": 8765,
"allowed_payment_types": [{
"payment_type": 1,
"imp_count_method": 2
}]
}
}
}, {
"id": "9057531734780521319",
"banner": {
"w": 580,
"h": 400,
"id": "1",
"battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
"pos": 0,
"format": [{
"w": 580,
"h": 400
}, {
"w": 580,
"h": 500
}]
},
"instl": 0,
"tagid": "677",
"secure": 1,
"ext": {
"appnexus": {
"estimated_clear_price": 11.31,
"member_ad_profile_id": 65987,
"allowed_payment_types": [{
"payment_type": 1,
"imp_count_method": 2
}]
}
}
}, {
"id": "7953238633763561522",
"banner": {
"w": 160,
"h": 600,
"id": "1",
"battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
"pos": 0,
"format": [{
"w": 160,
"h": 600
}]
},
"instl": 0,
"tagid": "987345",
"secure": 1,
"ext": {
"appnexus": {
"estimated_clear_price": 18.91,
"member_ad_profile_id": 12345,
"allowed_payment_types": [{
"payment_type": 1,
"imp_count_method": 2
}]
}
}
}, {
"id": "6528429208551730965",
"banner": {
"w": 980,
"h": 300,
"id": "1",
"battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
"pos": 0,
"format": [{
"w": 980,
"h": 300
}, {
"w": 580,
"h": 400
}, {
"w": 580,
"h": 500
}]
},
"instl": 0,
"tagid": "34546",
"secure": 1,
"ext": {
"appnexus": {
"estimated_clear_price": 8.58,
"member_ad_profile_id": 3456,
"allowed_payment_types": [{
"payment_type": 1,
"imp_count_method": 2
}]
}
}
}, {
"id": "8731177004555232453",
"banner": {
"w": 160,
"h": 600,
"id": "1",
"battr": [1, 2, 3, 4, 5, 9, 10, 12, 14],
"pos": 0,
"format": [{
"w": 160,
"h": 600
}, {
"w": 180,
"h": 500
}, {
"w": 180,
"h": 700
}]
},
"instl": 0,
"tagid": "345637",
"secure": 1,
"ext": {
"appnexus": {
"estimated_clear_price": 8.78,
"member_ad_profile_id": 34567,
"allowed_payment_types": [{
"payment_type": 1,
"imp_count_method": 2
}]
}
}
}
],
"site": {
"id": "346789",
"domain": "xandr.com",
"cat": ["IAB12", "IAB12-2", "IAB11-5"],
"page": "xandr.com",
"publisher": {
"id": "876543"
}
},
"device": {
"ua": "Mozilla/5.0 (Linux; Android 9; SAMSUNG SM-G950U) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/10.1 Chrome/71.0.3578.99 Mobile Safari/537.36",
"geo": {
"country": "USA",
"region": "FL",
"metro": "539",
"city": "Tampa",
"zip": "33617",
"utcoffset": -240,
"ext": {
"appnexus": {
"timezone": "America/Indiana/Vevay"
}
}
},
"dnt": 0,
"ip": "173.168.163.240",
"devicetype": 2,
"make": "Samsung",
"model": "SM-G950U",
"os": "Android",
"language": "en",
"connectiontype": 0,
"ext": {}
},
"user": {
"id": "6535227187230073444",
"buyeruid": "a_dsp_user_id",
"at": 1,
"tmax": 100,
"wseat": ["1417"],
"cur": ["USD"],
"regs": {
"coppa": 0
},
"source": {
"fd": 0,
"tid": "0edd5bae-91e7-4723-9f6b-21e942b623ce"
},
"ext": {
"appnexus": {
"seller_member_id": 958,
"publisher_integration": {
"is_header": 0
}
},
"schain": {
"complete": 1,
"nodes": [{
"asi": "appnexus.com",
"sid": "958",
"rid": "0edd5eab-91e7-4723-9f6b-21e912b623ce",
"hp": 1
}],
"ver": "1.0"
}
}
}
}