Notificar solicitud

Los licitadores reciben notificaciones sobre los resultados de la subasta, el tiempo de respuesta de la oferta y cualquier error generado por la respuesta de la oferta de un licitador en particular (es decir, "error de análisis JSON"). Estas notificaciones se enviarán mediante una llamada del lado del servidor a un postor especificado notify_URI cuando la subasta haya finalizado y se haya servido la impresión. Puede administrar la cantidad de información que recibe en sus notificaciones utilizando el notify_full_auction campo en el Servicio de licitadores. Las notificaciones incluyen detalles sobre cada oferta enviada.

Nota:

En ciertos tipos de subastas, se puede generar una notificación de pérdida o pendiente antes de la notificación de ganancia. Las notificaciones de victoria siempre son autoritativas e invalidan cualquier otra notificación recibida previamente para esa subasta.

Subasta interna

Para todas las subastas que realizamos, los postores recibirán notificaciones cuando se gane una subasta y cuando ocurra un error. Los postores también pueden optar por recibir notificaciones cuando se pierde una subasta enviando una solicitud de soporte.

Subasta externa

Para todas las subastas realizadas por un tercero, los postores recibirán una notificación pendiente cuando su oferta se transmita al tercero y una notificación cuando se gane una subasta.

Especificaciones

Campo Ámbito Tipo Descripción
timestamp todo marca de tiempo Hora en la que se envió la solicitud.
user_id_64 Algunos Entero El id. del usuario. En las solicitudes "perdidas" y "sin oferta", no se especificará ningún identificador de usuario.
fail Algunos booleano Devuelve verdadero cuando no se pudo procesar la respuesta de la oferta (por ejemplo, se pasó un JSON no válido en la respuesta de la oferta).
error Algunos string Cuando el error es verdadero, este campo muestra el mensaje de error correspondiente. Consulte la lista de errores a continuación.
error_id Algunos Entero Puede encontrar más detalles sobre el número proporcionado aquí.
response_time_ms Algunos Entero Cuando se proporciona, este es el número de milisegundos que devuelve el nombre bid_response . Este parámetro se excluirá si no se devuelve ninguna respuesta.

Etiquetas

Campo Ámbito Tipo Descripción
id Algunos Entero Identificador de la etiqueta.
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.
notify_type todo enumeración Los valores posibles son kept, sold, won, lostdefault, o pending.

Nota:kept y sold solo se aplican si eres el propietario del inventario.
post_pending todo booleano Establézcalo en true si el miembro ha ganado la subasta final para un inventario de terceros.
member_id Algunos Entero El identificador del miembro incluido en la respuesta a la puja. En las solicitudes "perdidas" y "sin oferta", no se especificará ninguna identificación de miembro.
creative_id Algunos Entero El identificador de la creatividad incluida en la respuesta a la puja. En las solicitudes "perdidas" y "sin puja", no se especificará ningún identificador de creatividad.
price_paid Tipo = Ganado double El precio real pagado (CPM) por el ganador. Esto solo está disponible si has ganado la impresión.
price_sold_for Tipo = Vendido double Los ingresos que recibe el propietario de la impresión cuando se vende. Solo para vendedores.
custom_notify_data Algunos string Si ha ganado la impresión de esta etiqueta, los datos de notificación personalizados que envió para la puja ganadora pasarán al nivel de etiqueta en la notificación.
payment_rule_id Algunos Entero El id. de la regla de pago que le ha asignado la etiqueta.

Respuestas

Campo Ámbito Tipo Descripción
result todo string Esta marca (ok o error) notifica la recepción de una respuesta válida a la oferta al licitante. Si es errorasí, recibirá un mensaje de error relevante.
price_bid Algunos double El precio ofertado en la respuesta a la oferta.
error_id Algunos Entero Cuando result es error, este campo muestra el código de error. Para obtener más información, consulte Notificar códigos de error de solicitud.
error Algunos string Cuando result es error, este campo muestra el mensaje de error correspondiente. Para obtener más información, consulte Notificar códigos de error de solicitud.
custom_notify_data Algunos string Cuando se proporciona, se trata de cualquier dato que el licitador haya especificado en la respuesta que se pasará a la notificación.

Nota:

La matriz de respuestas no estará presente cuando post-pending sea true.

Notificaciones de pérdida

Podemos enviarle solicitudes de notificación cuando envíe una respuesta de oferta distinta de cero para una subasta y no gane la subasta. Esto puede ocurrir porque se te superó la puja o porque se rechazó tu puja. Las ofertas se pueden rechazar por razones técnicas, como un mensaje JSON mal formado, o por razones a 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 piso para un trato. Si tienes problemas para obtener la entrega de una creatividad determinada, los mensajes de notificación de pérdida son una excelente manera de ver por qué tu creatividad no está ganando más impresiones. Para activar los mensajes de notificación de pérdida, envíe una solicitud de soporte técnico y un representante podrá habilitarla para su licitante.

Lista de errores

Para obtener una lista de todos los posibles errores que podrían enviarse en una solicitud de notificación, consulte Códigos de error de oferta.

Notificar subasta completa

Si el parámetro notify_full_auction Servicio del licitador se establece en true, full_tag_info, y 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 oferta , excepto el exclusive_default campo, mientras que bid_info contiene toda la información en las secciones Bid_info y Segmentos de la página Solicitud de oferta .

Nota:

Para las notificaciones posteriores pendientes (post-pending está establecido en true), full_tag_info no está disponible porque aún no se ha recibido la devolución de llamada de aceptación de la oferta.

Ejemplos

Solicitud de una sola etiqueta - Subasta ganada

Nota:

Esto solo está disponible cuando se usa el protocolo de pujas de la plataforma. Las victorias de OpenRTB se enviarán mediante el campo NURL en la respuesta de la oferta.

{   "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 - Subasta perdida

{
    "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
    }
}

Solicitud de notificación: preguntas más frecuentes

  • Last updated on