Compartir a través de


Instrucciones de integración de datos en tiempo real

Aunque la configuración es ligeramente diferente a la de los licitadores normales que realmente compran medios, los proveedores de datos con integraciones en tiempo real se configuran como "licitadores" en nuestro sistema. Una vez que se haya creado el postor del proveedor de datos y haya recibido credenciales, puede empezar a configurarlo con los pasos siguientes.

Implementación de la API de Impression Bus

Complete los pasos siguientes para empezar a usar la API de Impression Bus (api.adnxs.com):

Paso 1: Use las credenciales de API para autenticarse.

Paso 2: Debe establecer la configuración de ACL para aceptar los intervalos IP del bus de impresiones de Xandr. Asegúrese de permitir intervalos IP desde los centros de datos donde está escuchando tráfico y direcciones IP de bus de impresión de lista de permitidos exclusivamente (póngase en contacto con el Administrador de cuentas de Xandr para obtener una lista de ACL específicas de Xandr). No olvide permitir los intervalos IP de NYM1 y NYM2 si se encuentra en el centro de datos de NY y permitir intervalos IP de AMS3 y FRA1 si se encuentra en el centro de datos de AMS.

Paso 3:Crear el perfil primario a través del servicio de perfil del licitador de API. El perfil le permitirá filtrar previamente el tráfico por parámetros como país o región, vendedor y porcentaje general. Con fines de prueba, se recomienda establecer el passthrough_percent campo en algo pequeño como el 5 % hasta que esté listo para asumir una cantidad mayor. Los licitadores del proveedor de datos no pueden tener perfiles secundarios, solo pueden tener un único perfil primario.

Paso 4: Configure el pujador estableciendo los bid_uri campos (punto de conexión para solicitudes de puja), ready_uri (punto de conexión para solicitudes listas) y parent_profile_id . parent_profile_id debe ser el identificador del perfil que creó en el paso 3. Los demás campos de objeto del licitador (notify_uri, pixel_uri, click_uri, etc.) no deben establecerse, ya que no se aplican a los proveedores de datos.

  • Asegúrese de incluir al menos una de nuestras macros en bid_uri. Para obtener una lista completa de las macros disponibles, consulte Macros Xandr para proveedores de datos.

Paso 5: Agregue al menos una instancia del licitador. En producción, se debe registrar al menos una instancia del licitador en cada centro de datos para el que quiera ver el tráfico.

Paso 6: Cree segmentos mediante segment service. El code campo es lo que devolverá en la respuesta de la puja. También puede crear segmentos en nuestra interfaz de usuario del licitador en la pestaña Segmentos.

Nota:

Solo puede crear segmentos en el asiento de su propio miembro.

Paso 7: Empiece a responder a las solicitudes listas con un 1 y a las solicitudes de puja con códigos de segmento. Si no puede responder entre 8 y 10 ms o no tiene ningún segmento para una impresión determinada, responda con una nueva línea:

  • Solicitudes listas: Responder con '1\n'
  • Solicitudes de puja: Responder con 'segmentCode1\nsegmentCode2\n' or '\n'

Sugerencia

Como principio rector, el licitador debe intentar acercarse a una tasa de tiempo de espera del 0 %. Para ello, es muy importante que el licitador responda a TODAS las solicitudes de puja (con códigos o con una nueva línea) en un plazo aproximado de 7 milisegundos para tener en cuenta el nerviosismo.

Paso 8: Confirme que la integración funciona correctamente examinando las métricas de nuestra interfaz de usuario del licitador.

Paso 9: Comparta los segmentos con los clientes mediante el servicio de uso compartido de datos de miembros.

Paso 10: En curso: supervise las métricas en la interfaz de usuario del licitador en la pestaña Métricas.

Otras consideraciones

  • 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.