Licitantes: respuesta de la oferta

Artículo
05/17/2024

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: 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

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

Compartir a través de