Licitantes: respuesta de la oferta
Nota
- No compatible: ya no se admite el protocolo AppNexusBidding; esta documentación es solo para fines heredados.
- Si es un nuevo licitador que se integra con Xandr, consulte el Protocolo de licitación de OpenRTB 2.4.
Un postor enviará una respuesta de puja después de recibir una solicitud de puja del bus de impresiones. La respuesta a la oferta incluirá la oferta del pujador ("precio") y la creatividad elegida ("creative_id"
o "creative_code"
). Esta creatividad se servirá si el servidor de anuncios finalmente acepta la oferta.
Campo | Tipo | Descripción |
---|---|---|
debug_text |
string | Este campo de texto opcional se mostrará en el registro de depuración al llamar a cualquier TinyTag con &debug=1&bidder=BIDDER_ID&dongle=DONGLE anexado a la cadena de consulta. Nota: DONGLE (una contraseña para proteger la salida de depuración de un licitador) solo es necesaria si se ha establecido una para el postor. Obligatorio: No |
no_bid |
bool | Si es "true", esto indicará al bus de impresiones que ha devuelto una respuesta válida, pero que ha elegido no pujar. Este campo de no_bid es el mejor cuando se desea toda no_bid la respuesta, no solo una etiqueta determinada.Obligatorio: No |
Campo | Tipo | Description |
---|---|---|
member_id |
Entero | Identificador del miembro cuya creatividad elige el licitador de la matriz "members" de la solicitud. Obligatorio: Sí |
auction_id_64 |
Entero | Identificador de la subasta para la que se envía esta respuesta. Obligatorio: Sí |
exclusive |
bool | Fase de propietario: Si es "true", se servirá la creatividad de esta respuesta. Ningún otro postor podrá competir por la impresión. Obligatorio: No |
no_bid |
bool | Si es "true", esto indicará al bus de impresiones que ha devuelto una respuesta válida, pero que ha elegido no pujar por esta etiqueta. Obligatorio: No |
price |
double | El precio bruto, expresado como CPM, que el licitador está dispuesto a pagar por esta impresión. Si es exclusivo, se usa solo con fines de informes; si no es exclusivo, solo un postor que pague más del precio de reserva podrá pujar en la subasta. Debe ser un número decimal simple. Si el valor es una cadena, evaluaremos la cadena como 0, por lo que se asegurará de que el valor sea un número. Obligatorio: No |
userdata_js |
string | Comandos javascript de userdata para modificar los datos de usuario si se selecciona la respuesta de este pujador. Nota: Si el campo no_cookies en la solicitud de puja está establecido en true, no hay ninguna garantía de que los userdata_js comandos se ejecuten correctamente (ya que Es posible que AppNexus no pueda almacenar información sobre el usuario).Obligatorio: No |
custom_notify_data |
string | Este campo de texto de forma libre se puede usar para pasar información a la solicitud de notificación. ImpBus codificará automáticamente la dirección URL o la cookie, por lo que se puede pasar en formato de texto libre. Obligatorio: No |
creative_id |
Entero | Fase de propietario: Identificador de la creatividad que se va a usar como la nueva creatividad predeterminada para la impresión. Fase sin propietario: Identificador de la creatividad que se envía como parte de la oferta del miembro para la impresión. Obligatorio: Sí (si no se proporciona código). |
creative_code |
string | Código personalizado de la creatividad que se pasa al servicio creativo. Obligatorio: Sí (si no se proporciona código). |
click_url |
string | Dirección URL de clic que se va a asociar a la creatividad. Si la creatividad ya tiene configurado click_url , el valor de la respuesta de la puja se antepondrá a la dirección URL existente. También puede usar macros personalizadas para el seguimiento de clics.Obligatorio: No |
pixel_url |
string | Dirección URL del píxel que se va a asociar a la creatividad. Este píxel se usará para el inventario no seguro. Obligatorio: No |
pixel_type |
enumeración | El tipo de píxel que se va a usar: 'javascript' o 'image' (el valor predeterminado es imagen si no se proporciona). Obligatorio: No |
deal_id |
Entero | El identificador de la oferta que desea usar para esta subasta. Obligatorio: No |
Campo | Tipo | Descripción |
---|---|---|
name |
string | Nombre de la macro que se va a reemplazar en cualquiera de las direcciones URL de la creatividad (medios, píxeles, clics, etc.) o contenido. El nombre puede contener cualquier carácter excepto el quilate (^) y debe tener el formato ${MACRO_NAME} dentro de las direcciones URL o contenido de la creatividad. Nota: Las macros personalizadas se reemplazan después de que se hayan reemplazado las macros del sistema. Para obtener más información sobre las macros personalizadas, consulte Creative Service. Obligatorio: No |
value |
string | Valor usado para reemplazar la macro. El valor puede contener cualquier carácter excepto el quilate (^). No escape las barras diagonales. Nota: Incluso si el valor es un entero, debe colocarse entre comillas dobles. |
- Cada respuesta de puja debe incluir el identificador de la subasta para la etiqueta a la que responde. Se pueden dar varias respuestas para la misma subasta.
- Las respuestas de puja en las que
no_bid
se establecetrue
en deben incluir el identificador de la subasta.
AppNexus no impone límites a los datos pasados en la custom_macros
matriz o el custom_notify_data
campo, pero se recomienda limitar el total de datos personalizados pasados a 1000 caracteres o menos. Estos datos deben codificarse y enviarse al explorador del usuario para determinados tipos de inventario (vendedores externos, ubicaciones de iFrame) como parte de una dirección URL de redireccionamiento, y las direcciones URL más largas pueden interrumpirse en determinados exploradores y para determinados vendedores.
{
"bid_response":{
"responses":[
{
"member_id":3,
"price":11.170,
"creative_id":11,
"pixel_url":"https://ad.doubleclick.net/pixel?id=11706",
"pixel_type":"image",
"auction_id_64": 2345245234523
}
]
}
}
{
"bid_response":{
"responses":[
{
"member_id":3,
"price":11.170,
"creative_id":11,
"pixel_url":"https://ad.doubleclick.net/pixel?id=11706",
"pixel_type":"image",
"auction_id_64": 2345245234523
},
{
"member_id":3,
"price":9.200,
"creative_id":12,
"pixel_url":"https://ad.doubleclick.net/pixel?id=11706",
"pixel_type":"image",
"auction_id_64": 2345245234523
}
]
}
}
{
"bid_response":{
"responses":[
{
"member_id":7,
"price":3.12,
"creative_code":"23219",
"custom_macros":[
{
"name":"CAMPAIGN_ID",
"value":452346
},
{
"name":"INT_CODE",
"value":"a352-45we-sdr3"
}
],
"userdata_js":"update_frequency(23219)",
"auction_id_64": 2345245234523
},
{
"member_id":14,
"price":1.14,
"creative_code":"23219",
"custom_macros":[
{
"name":"CAMPAIGN_ID",
"value":452312
},
{
"name":"INT_CODE",
"value":"c231-4sa2-css5"
}
],
"userdata_js":"update_frequency(23219)",
"auction_id_64": 2432387423232
}
]
}
}
{
"bid_response":{
"responses":[
{
"member_id":5555,
"price":0.75,
"creative_id":11,
"auction_id_64": 5555508250840350700,
"deal_id": 555664
}
]
}
}