Compartir a través de

Guía de integración del licitador de resultados garantizados

  • Artículo

En esta página se describen las especificaciones que definen el método por el que Xandr permite a un licitador pujar y facturar por un resultado (vista o completo) frente a la impresión típica que se sirve. Además, dado que los distintos compradores tienen estándares diferentes para lo que constituye una "impresión visible", la especificación está diseñada para admitir una variedad de estándares, incluidas diferentes definiciones (por ejemplo, IAB frente a GroupM) y diferentes proveedores de tecnología de medición (por ejemplo, DoubleVerify). En el futuro, la especificación también se puede usar para admitir eventos de transacción adicionales, por ejemplo, una impresión en demostración.

Para obtener más información, consulte Resultados garantizados.

Implementación

En un nivel alto, nuestro enfoque para la implementación sigue lo que se ha descrito en la especificación de OpenRTB como un "aviso de facturación", de OpenRTB Specification 2.4, Section 7.2.

"Ganar la subasta, sin embargo, no garantiza que el anuncio se entregue correctamente al cliente o que? cumplirá las expectativas de visibilidad. Además, las directivas varían entre los intercambios en cuanto a los criterios de facturación. La mayoría considera un anuncio facturable en algún tipo de entrega o representación frente a la victoria de la subasta por sí sola. Esto se alinea mejor con el objetivo obvio del comprador de garantizar que las impresiones que pagan se muestren realmente. Para abstraer el concepto, consulte "aviso de facturación" como la activación de alguna dirección URL de notificación en el momento en que el precio de compensación de la impresión se reservará como gasto. Esto es independientemente de si la dirección URL de aviso de win de OpenRTB real se delega en el cliente para activar o se usa alguna otra dirección URL de seguimiento."

El concepto de notificación de facturación se ha desarrollado aún más en la especificación 2.5 de OpenRTB. Resaltar contenido relevante de la sección 4.2.3.

PROCEDIMIENTO RECOMENDADO: La función esencial del aviso de victoria es informar a un postor de que ganó una subasta. No implica necesariamente la entrega de anuncios, la visibilidad creativa o la facturabilidad. Se recomienda encarecidamente a los intercambios que publiquen a sus licitadores, sus desencadenadores de eventos, directivas de facturación y cualquier otro significado que adjunten al aviso de victoria.

PROCEDIMIENTO RECOMENDADO: La activación del aviso de facturación debe ser del lado servidor y tan "cercano" como sea posible a donde los ingresos de los libros de cambio con el fin de minimizar las discrepancias entre el intercambio y el licitador.

Resumen del protocolo

A continuación se muestra un resumen de los componentes necesarios para permitir la licitación y los resultados de compra:

Solicitud de puja

Xandr indicará en la solicitud de puja que aceptará ofertas basadas en resultados, qué resultados (vistas y/o completados) y la tasa que usará el intercambio para generar un valor de eCPM para la clasificación.

Respuesta de la oferta

El licitador indicará que la oferta es una oferta basada en resultados, especificará qué resultado (payment_type), especificará el precio de la oferta basado en el resultado (vCPM para las vistas, CPCV para los completados) y proporcionará una dirección URL de notificación de facturación.

Notificación de Win

Xandr indicará que la puja ganadora fue para un resultado, especificará qué resultado y citará el precio ganador basado en el resultado que se cobrará al Licitante si el anuncio logra el resultado deseado después del servicio. Tenga en cuenta que en este momento se notifica al Licitador que ganó la subasta y que se ha notificado una impresión, pero no se le cobrará hasta que se compruebe el resultado.

Notificación de facturación

Una vez que se atiende la creatividad y Xandr recibe una señal positiva de que se produjo el resultado deseado, Xandr llama a la dirección URL de notificación de facturación para indicar que el resultado se produjo y al Licitante se le cobra el precio basado en el resultado ganador.

Especificación

Solicitud de puja

Impression AppNexus (objeto)

Xandr admite los siguientes campos en el appnexus objeto de extensión del imp objeto :

Campo Tipo Descripción
allowed_payment_types matriz de objetos Especifica los tipos de pagos permitidos para esta impresión. Si este campo no está presente, el único tipo de pago permitido es 'impression'.

Objeto de tipo de pago permitido

Xandr admite los siguientes campos en el allowed_payment_type objeto del objeto de impresión ext :

Campo Tipo Description
payment_type integer Especifica el identificador de un tipo de pago aceptable para esta impresión. Consulte Los tipos de pago admitidos actualmente a continuación.
conversion_rate double Opcional. Especifica la tasa que usará Xandr para convertir una puja basada en resultados en un precio eCPM basado en impresiones para la clasificación en la subasta. Un Licitador puede usarlo para la clasificación interna de pujas o la presupuestación o el ritmo.

Tipos de pago admitidos actualmente

Id. Description Tipo de puja
1 Impresión CPM
2 Vistas: presentación estándar vCPM
6 Vistas: visualización personalizada: 100pv1s vCPM
8 Vistas: vídeo estándar vCPM
9 Vistas: vídeo personalizado: 100pv50pd vCPM
10 Completo: vídeo estándar CPCV

Respuesta de la oferta

Bid (objeto)

Campo Tipo Description
price float (Obligatorio) El precio de la oferta expresado en CPM.
bid_payment_type Si se omite o se establece en "Impression", el precio se usa en la subasta y para rellenar la ${AUCTION_PRICE} macro.
Si es bid_payment_type algo distinto de Impresión, el precio debe establecerse; sin embargo, el payment_type_price campo se usará en la subasta y para rellenar la ${AUCTION_PRICE} macro.
nurl string Dirección URL de notificación de win. El servidor Xandr llamará a esta dirección URL cuando reciba una notificación del lado cliente del dispositivo, lo que indica que Xandr ganó la subasta. Esto ocurre al mismo tiempo que Xandr registra la impresión y es cuando el Licitante también debe registrar una impresión servida.

Nota: La notificación win no significa una transacción, solo que se ha servido la impresión. La notificación de facturación indicará una transacción.
Las direcciones URL de notificación de Win enviadas como HTTPS no se admiten y se tratarán como solicitudes HTTP.

Las macros siguientes se admiten en la dirección URL de notificación:
${AUCTION_ID} - Xandr auction_id_64
${AUCTION_BID_ID} - Id. de la oferta especificada en el bidid campo en la respuesta de la oferta
${AUCTION_IMP_ID} - Id. de la impresión del impid campo en el bid objeto del seatbid objeto
${AUCTION_SEAT_ID} - Id. del asiento ganador del seat campo en el seatbid objeto
${AUCTION_AD_ID} - Id. de la creatividad del comprador, del adid campo en el bid objeto del seatbid objeto
${AUCTION_PRICE} - Borrar el precio de la impresión en la moneda especificada en el cur campo en la respuesta de la oferta. Si bid_payment_type está presente y algo distinto de Impression, el reflejará el AUCTION_PRICE precio que se pagará solo si se llama a la notificación de facturación.
${AUCTION_CURRENCY} - Moneda del precio de compensación, tal como se especifica en el cur campo de la respuesta de la oferta.
${CREATIVE_CODE} - El code campo establecido en el creative objeto a través de la API al registrar una creatividad
${AN_PAYMENT_TYPE} - El payment_type de la oferta especificada en el bid_payment_type campo de la respuesta de la oferta
burl string Dirección URL de notificación de facturación. El servidor Xandr llamará a esta dirección URL cuando determine que la impresión es facturable. Este evento se produce al mismo tiempo que Xandr registra el costo del comprador para la impresión. En este momento, el Licitador incurre en costos y debe registrar una transacción.
La dirección URL de notificación de facturación solo es relevante para las pujas que han especificado un bid_payment_type valor distinto de Impression.

Las direcciones URL de notificación de facturación enviadas como HTTPS no se admiten y se tratarán como solicitudes HTTP.

Las macros siguientes se admiten en la dirección URL de notificación de facturación:
${AUCTION_ID} - Xandr auction_id_64
${AUCTION_BID_ID} - Id. de la oferta especificada en el bidid campo en la respuesta de la oferta
${AUCTION_IMP_ID} - Id. de la impresión del impid campo en el bid objeto del seatbid objeto
${AUCTION_SEAT_ID} - Id. del asiento ganador del seat campo en el seatbid objeto
${AUCTION_AD_ID} - Id. de la creatividad del comprador desde el adid campo en el bid objeto del seatbid objeto
${AUCTION_PRICE} - Precio de compensación para el payment_type especificado en el bid_payment_type campo de la respuesta de la oferta, en la moneda especificada en el cur campo en la respuesta de la oferta.
${AUCTION_CURRENCY} - Moneda del precio de compensación, tal como se especifica en el cur campo de la respuesta de la oferta.
${CREATIVE_CODE} - El code campo establecido en el creative objeto a través de la API al registrar una creatividad
${AN_PAYMENT_TYPE} - El payment_type de la oferta especificada en el bid_payment_type campo de la respuesta de la oferta

Objeto AppNexus de respuesta de puja

Xandr admite los siguientes campos en el appnexus objeto de extensión del objeto bid:

Campo Tipo Descripción
bid_payment_type object Se requiere para enviar una oferta de resultados garantizados. Especifica el tipo de pago para el que está pujando el Licitador. Si se omite, Xandr considerará que la oferta es para una impresión estándar.

Objeto de tipo de pago bid

Xandr admite los siguientes campos en el bid_payment_type objeto del objeto de respuesta ext de puja:

Campo Tipo Description
payment_type integer Especifica el tipo de pago por el que el Licitador está pujando y se facturará. Si el tipo de pago no 'impression'es , se debe establecer una dirección URL de notificación de facturación en el objeto de puja. Consulte Los valores admitidos actualmente para el objeto de tipo de pago de puja a continuación.
price double Especifica el precio de la oferta para el tipo de pago, expresado sobre una base de resultados (consulte Tipo de puja en los valores admitidos actualmente para el objeto de tipo de pago de la oferta) a continuación.
Por ejemplo, si se establece en payment_type 2 ('Vistas: presentación estándar'), price se interpreta como un valor vCPM. También es el cargo máximo, que solo se acumula si la creatividad se sirve y se mide visible, según la definición de IAB y el script de medición de la visualización Xandr.

Nota: Solo se admiten pujas de USD para tipos de pago distintos de Impresiones.

Valores admitidos actualmente para el objeto de tipo de pago de puja

Id. Description Tipo de puja
1 Impresión CPM
2 Vistas: presentación estándar vCPM
6 Vistas: visualización personalizada: 100pv1s vCPM
8 Vistas: vídeo estándar vCPM
9 Vistas: vídeo personalizado: 100pv50pd vCPM
10 Completo: vídeo estándar CPCV