Integraciones en tiempo real (proveedores de datos contextuales)

Para los proveedores de datos contextuales, los datos están directamente relacionados con el inventario. Esto requiere que realicemos una solicitud en tiempo real al proveedor de datos para cada impresión con el fin de obtener información sobre la seguridad de la marca y los datos de categorización en función de la dirección URL del referenciador. Cuando se nos pasa la dirección URL del referenciador para la subasta (ya sea en el servidor por un asociado de inventario o en el encabezado HTTP), lo pasamos a los proveedores de datos contextuales, que responden con categorías (a las que llamamos "segmentos") correspondientes a la categorización de la página, por ejemplo, "Noticias".

Además, consulte Instrucciones de Integración de datos en tiempo real.

Proceso

1. Una impresión entra en el bus de impresiones a través de una etiqueta de selección de ubicación en la página o una llamada del lado servidor desde un asociado de suministro. La impresión debe tener una dirección URL de referencia en el encabezado HTTP, como parámetro querystring o desde el default_referrer_url de la ubicación si la visibilidad de dominio o dirección URL en está establecida en "hidden".

2. Los datos de usuario se buscan en el almacén de cookies del lado servidor mediante el UID en la cookie del explorador del usuario como clave para la busqueda.

3. El almacén de cookies del lado servidor devuelve los datos de usuario. Estos datos se adjuntan a la subasta como datos de segmento y JSON de datos de usuario de forma libre.

4. Si hay una dirección URL de referencia, se envía una solicitud al proveedor de datos contextual que contiene la dirección URL del referenciador como parámetro querystring.

5. El proveedor de datos devuelve una lista separada por devolución de línea de códigos de segmento (vea el campo de código en el servicio Segment) correspondiente a las categorizaciones de la página. Estas categorizaciones se adjuntan a la subasta como datos de segmento.

   1. Si no se puede asignar ninguna categorización a la dirección URL del referenciador, se debe devolver una respuesta en blanco con un nuevo carácter de línea.

6. Las solicitudes de puja se envían a nuestra interfaz de usuario, así como a otros DSP y postores. Los datos de la subasta contienen los segmentos asociados a un proveedor de datos determinado solo si el licitador o un miembro asociado a ese pujador tiene acceso a esos segmentos.

   Sugerencia

   Segmentos en tiempo real frente a comportamiento

   Una distinción importante entre los segmentos en tiempo real (contextual) y de comportamiento es que los segmentos en tiempo real devueltos por un proveedor de datos en tiempo real solo existen durante la vida útil de la impresión y no afectan a la pertenencia a segmentos de usuario. Los segmentos de comportamiento están asociados al usuario y existen siempre que el usuario esté asociado a ese segmento.

7. Los DSP y los licitadores devuelven una respuesta para cada subasta (ya sea una oferta o una indicación de que no desean participar).

8. Por último, para las subastas en las que Xandr es el responsable final de la toma de decisiones, la creatividad ganadora se devuelve al navegador del usuario. Si la impresión se recibió a través de una llamada del lado servidor de un partner de suministro, el creativo ganador y la oferta se devuelven a ese partner de suministro para participar en otra subasta.

Detalles técnicos

Cuando una impresión entra en el bus de impresiones, se envía una solicitud HTTP GET a una instancia del proveedor de datos disponible con las macros anexadas al bid_uri parámetro configurado en bidder Service. La instancia del proveedor de datos debe responder con una lista de códigos de segmento (no identificadores de segmento: solo se aceptarán códigos de segmento), separados por una nueva línea (\n). El intervalo de tiempo de espera actual para las solicitudes del proveedor de datos es de 10 milisegundos.

Sugerencia

Para obtener una lista completa de las macros Xandr que se pueden anexar a bid_uri, vea Macros Xandr para proveedores de datos.

Solicitud y respuesta de ejemplo

Solicitud

GET /data_provider/get_categories?url=http://www.mikeonads.com/2009/10/18/rtb-serving-speed/

Respuesta

brand_safety_safe
brand_safety_not_adserver
brand_safety_general_audience
cat_computers
cat_real_time_bidding
cat_technology

Instalación

Los proveedores de datos con integraciones en tiempo real se implementan como "licitadores", aunque en realidad no realicen ofertas. Configuran instancias del licitador en cada centro de datos e interactúan directamente con el bus de impresiones. Cada proveedor de datos que use este método de integración debe tener un único miembro asociado a su licitador y los segmentos se hospedarán dentro del miembro. Configuraremos el miembro para usted y le sugeriremos que no lo modifique sin consultar primero con su contacto técnico en Xandr.

Dado que el período de tiempo de espera de 10 milisegundos es tan corto y como las solicitudes se reciben directamente desde el bus de impresiones, es necesario registrar una instancia del licitador en cada centro de datos en el que desee ver las solicitudes.

Otras consideraciones

• La fase del proveedor de datos dura 10 milisegundos, lo que significa que todos los proveedores de datos deben responder con algún tipo de categorización en 10 milisegundos o menos.
• Solo se llamará a un proveedor de datos si tiene una instancia en funcionamiento en el mismo centro de datos que procesa la impresión. Por ejemplo, si una impresión entra en el centro de datos de Ámsterdam y el proveedor de datos tiene instancias en los centros de datos de Nueva York y LA, no recibirá una solicitud de categorización.
• Dado el tiempo de respuesta necesario de 10 ms o menos, los proveedores de datos en tiempo real deben considerar la localización conjunta dentro de los centros de datos usados por Xandr para reducir la latencia y asegurarse de que los tiempos de respuesta sean de 10 ms o menos.
• La integración del proveedor de datos en tiempo real normalmente tarda varios meses en completarse. Animamos a los proveedores de datos potenciales a que lo tenga en cuenta antes de iniciar la integración con Xandr.
• Con el fin de administrar las instancias y las solicitudes recibidas, el proveedor de datos puede usar el pujador, la instancia del licitador y los servicios de perfil en la API del bus de impresiones.