Leer en inglés

Compartir a través de


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.

Implementación

Especificaciones

Bid_response

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

Bid_response-responses>[ ]

Campo Tipo Description
member_id Entero Identificador del miembro cuya creatividad elige el licitador de la matriz "members" de la solicitud.
Obligatorio:
auction_id_64 Entero Identificador de la subasta para la que se envía esta respuesta.
Obligatorio:
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

Bid_response-responses>[ ]->custom_macros[ ]

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.

Id. de subasta

  • 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 establece true en deben incluir el identificador de la subasta.

Límites de datos personalizados (macros y datos de notificación)

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.

Ejemplo

Respuesta de etiqueta única (mediante el identificador creativo con píxel)

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

Etiqueta única, varias pujas (con id. de creatividad con píxel)

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

Respuesta de varias etiquetas (mediante código creativo y macros personalizadas)

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

Respuesta a un acuerdo

{
   "bid_response":{
      "responses":[
         {
            "member_id":5555,
            "price":0.75,
            "creative_id":11,
            "auction_id_64": 5555508250840350700,
            "deal_id": 555664
         }
      ]
   }
   }