Solicitud de notificación
Los licitadores reciben notificaciones sobre los resultados de la subasta, el tiempo de respuesta de la oferta y los errores generados por la respuesta de puja de un pujador determinado (es decir, "error de análisis JSON"). Estas notificaciones se enviarán a través de una llamada del lado servidor a un licitador especificado notify_URI cuando se haya completado la subasta y se envíe la impresión. Puede administrar la cantidad de información que recibe en sus notificaciones mediante el notify_full_auction campo en el Servicio del Licitador. Las notificaciones incluyen detalles sobre cada oferta enviada.
Nota:
En determinados tipos de subastas, se puede generar una notificación perdida o pendiente antes de la notificación win. Las notificaciones win siempre son autoritarias e invalidan cualquier otra notificación recibida anteriormente para esa subasta.
Subasta interna
Para todas las subastas que realizamos, los licitadores recibirán notificaciones cuando se gane una subasta y cuando se produzca un error. Los licitadores también pueden optar por recibir notificaciones cuando se pierde una subasta mediante el envío de una solicitud de soporte técnico.
Subasta externa
Para todas las subastas realizadas por un tercero, los licitadores recibirán una notificación pendiente cuando su oferta se transmita a terceros y una notificación cuando se gane una subasta.
Especificaciones
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
timestamp |
todo | Timestamp | Hora de envío de la solicitud. |
user_id_64 |
alguno | Entero | Identificador del usuario. En las solicitudes "lost" y "no-bid", no se especificará ningún identificador de usuario. |
fail |
alguno | booleano | Devuelve true cuando no se pudo procesar la respuesta de puja (por ejemplo, json no válido pasado en la respuesta de la puja). |
error |
alguno | string | Cuando error es true, este campo muestra el mensaje de error correspondiente. Vea Lista de errores a continuación. |
error_id |
alguno | Entero | Puede encontrar más detalles sobre el número proporcionado aquí. |
response_time_ms |
alguno | Entero | Cuando se proporciona, este es el número de milisegundos para el bid_response que se va a devolver. Este parámetro se excluirá si no se devuelve ninguna respuesta. |
Etiquetas
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
id |
alguno | Entero | Identificador de la etiqueta. |
auction_id_64 |
todo | Entero | Identificador de la subasta. Esto resulta útil para la conciliación y las discrepancias, por lo que se recomienda agregar a los registros. |
notify_type |
todo | enumeración | Los valores posibles son kept, sold, won, lost, defaulto pending.Nota: kept y sold solo se aplican si es el propietario del inventario. |
post_pending |
todo | booleano |
true Establézcalo en si el miembro ha ganado la subasta final de un inventario de terceros. |
member_id |
alguno | Entero | Identificador del miembro incluido en la respuesta de la puja. En las solicitudes "lost" y "no-bid", no se especificará ningún identificador de miembro. |
creative_id |
alguno | Entero | Identificador de la creatividad incluida en la respuesta de la puja. En las solicitudes "perdidas" y "sin puja", no se especificará ningún identificador creativo. |
price_paid |
type = won | double | El precio real pagado (CPM) por el ganador. Esto solo está disponible si ganó la impresión. |
price_sold_for |
type = sold | double | Ingresos recibidos por el propietario de la impresión cuando se vende. Solo para vendedores. |
custom_notify_data |
alguno | string | Si ganó la impresión de esta etiqueta, los datos de notificación personalizados que envió para la puja ganadora pasarán a través del nivel de etiqueta en la notificación. |
payment_rule_id |
alguno | Entero | Identificador de la regla de pago que la etiqueta le ha asignado. |
Respuestas
| Campo | Ámbito | Tipo | Descripción |
|---|---|---|---|
result |
todo | string | Esta marca (ok o error) informa de la recepción de una respuesta de puja válida al licitador. Si es error, recibirá un mensaje de error pertinente. |
price_bid |
alguno | double | Oferta de precio en la respuesta de la oferta. |
error_id |
alguno | Entero | Cuando result es error, este campo muestra el código de error. Para obtener más información, vea Notificación de códigos de error de solicitud. |
error |
alguno | string | Cuando result es error, este campo muestra el mensaje de error correspondiente. Para obtener más información, vea Notificación de códigos de error de solicitud. |
custom_notify_data |
alguno | string | Cuando se proporciona, se trata de los datos que el licitador ha especificado en la respuesta que se va a pasar a la notificación. |
Nota:
La matriz de respuestas no estará presente cuando post-pending sea true.
Notificaciones perdidas
Podemos enviarle solicitudes de notificación cuando envíe una respuesta de puja distinta de cero para una subasta y no gane la subasta. Esto puede ocurrir porque se le ha superado o porque se ha rechazado la oferta. Las pujas se pueden rechazar por motivos técnicos, como un mensaje JSON mal formado o por razones de nivel empresarial, como el uso de una creatividad bloqueada por el vendedor o el envío de un precio de oferta que está por debajo del mínimo para una oferta. Si tiene problemas para recibir la entrega en una creatividad determinada, los mensajes de notificación perdidos son una excelente manera de ver por qué su creatividad no está ganando más impresiones. Para activar los mensajes de notificación perdidos, envíe una solicitud de soporte técnico y un representante puede habilitarlo para el postor.
Lista de errores
Para obtener una lista de todos los posibles errores que se pueden enviar en una solicitud de notificación, consulte Códigos de error de puja.
Notificar la subasta completa
Si el parámetro notify_full_auctionBidder Service está establecido en true, full_tag_infoy bid_info se incluirá en la respuesta. El parámetro full_tag_info contiene toda la información descrita en la sección Etiquetas de la página Solicitud de puja , excepto el exclusive_default campo , mientras que bid_info contiene toda la información de las secciones Bid_info y Segmentos de la página Solicitud de puja .
Nota:
En el caso de las notificaciones posteriores a la espera (post-pending se establece en true), full_tag_info no está disponible porque la devolución de llamada de aceptación de la oferta aún no se ha recibido.
Ejemplos
Solicitud de etiqueta única: subasta ganada
Nota:
Esto solo está disponible cuando se usa el protocolo de puja de la plataforma. Las victorias de OpenRTB se enviarán mediante el campo NURL en la respuesta de la puja.
{ "notify_request":{
"timestamp":"2011-02-09 00:11:44",
"response_time_ms":4,
"tags":[
{
"id":474074,
"auction_id_64":7606327141949238687,
"payment_rule_id":65930,
"price_paid":0.90000,
"member_id":670,
"notify_type":"won",
"creative_id":12345,
"user_id_64":4628364836293826
}
],
"responses":[
{
"result":"ok",
"price_bid":1.00000
}
]
}
}
Solicitud de etiqueta única: se ha perdido la subasta
{
"notify_request": {
"user_id_64": 2843838668060323000,
"responses": [
{
"price_bid": 0.06207,
"result": "ok"
}
],
"tags": [
{
"notify_type": "lost",
"id": 9373851,
"payment_rule_id": 874041,
"auction_id_64": 1177991420539445500
}
],
"timestamp": "2016-09-27 21:49:06",
"auction_timestamp": "2016-09-27 21:49:06",
"response_time_ms": 67
}
}
Solicitud de etiqueta única: error en la respuesta
{
"notify_request": {
"user_id_64": 9191106446964517565,
"responses": [
{
"error_id": 408,
"result": "error",
"error": "Creative 536754694 brand 75445 banned on member's ad profile 542799"
}
],
"tags": [
{
"notify_type": "lost",
"id": 5632681,
"payment_rule_id": 821648,
"auction_id_64": 442903072350998711
}
],
"timestamp": "2016-09-27 21:48:46",
"auction_timestamp": "2016-09-27 21:48:46",
"response_time_ms": 87
}
}