Proceso de integración

Este documento incluye la información necesaria para que los socios proveedores revisen, planifiquen y ejecuten una nueva integración de OpenRTB, o migren de una integración de protocolo SSP personalizada al estándar OpenRTB, a su propio ritmo.

Nota:

La página Proceso de integración es solo para socios de suministro externos.

Lista de comprobación de requisitos previos

Nota:

Si aún no tiene una cuenta en el portal de atención al cliente, visite la página de inicio de sesión , proceda como invitado y solicite el registro de un nuevo usuario.

  1. Póngase en contacto con el administrador de cuentas (o abra un ticket con nuestro equipo de soporte) para confirmar la siguiente información:
  2. Revise la documentación que se describe a continuación y discuta las preguntas abiertas:

Nota:

Las comprobaciones de requisitos previos solo se completan después de que se firme el contrato y se cree la identificación del miembro. Antes de eso, solo se puede procesar el punto 1a. . Sin embargo, hasta que se refrende el contrato, nos encantaría iniciar la conversación con su equipo de integración para que pueda familiarizarse con el proceso y abordar sus preguntas técnicas de inmediato.

  • Se espera que el compromiso tome de 3 a 4 semanas.
  • El cliente debe revisar completamente la Lista de verificación de requisitos previos (este documento) y recopilar toda la información antes de seguir los pasos a continuación.

Paso 1: Entrenamiento autoguiado de API/UI y creación de objetos de publicación y colocación (tiempo estimado: 7 - 10 días)

  1. Revise la jerarquía de objetos de Xandr y la documentación de API/UI.

  2. Aprovisione los objetos que necesitará para las pruebas iniciales, ya sea a través de la API. Consulte la documentación de la API para obtener más detalles.

  3. Crear objetos de venta para sincronizar inventarios (al menos los necesarios para las pruebas funcionales iniciales) a través de la interfaz de usuario/API

  4. Configurar una ubicación predeterminada a nivel de publicador y miembro. (En caso de que no podamos identificar el inventario de la solicitud de oferta, la impresión se registrará en esa ubicación predeterminada).

  5. Usa el campo para asignar tus code solicitudes de pujas a tus editores y ubicaciones. Para obtener más detalles y ejemplos, lea las preguntas frecuentes sobre integración.

    Nota:

    Con el fin de proporcionar transparencia a nuestros compradores y mejorar nuestra optimización, requerimos a nuestros socios que dividan su inventario por editor. Para obtener más información sobre nuestros estándares de estructura de inventario, visite nuestra página wiki Utilice la API para sincronizar su estructura de inventario.

  6. Use el servicio de publicación para crear publicadores asignados a su inventario.

    Nota:

    • El code campo es obligatorio para todos los vendedores externos, tanto a nivel de publicador como de emplazamiento, y es muy recomendable para todos los demás vendedores con el fin de garantizar que su inventario sea lo más detallado posible para que pueda ser investigado con precisión en busca de problemas de calidad y, específicamente, en busca de detectabilidad de dominio. Este paso te ayudará a dividir tu inventario en etiquetas altamente detectables y menos detectables, lo que te permitirá aislar los impactos de los dominios no detectables en el resto de la viabilidad de tu inventario.
    • Para crear o editar editores en la API, debe declarar la relación de inventario. La información solicitada es información comercial básica sobre cómo se accede al inventario y se utilizará para respaldar los esfuerzos de calidad del inventario de Xandr. Para obtener una lista completa de los campos y sus requisitos de uso, consulte la documentación del servicio Publisher .

  7. Configuración de sincronización de usuario
    Almacena la tabla de asignación de usuarios entre Xandr y la tuya mediante el servicio getUID. Obtenga más información del mapa de ID de usuario.

Paso 2: Pruebas de punto de conexión de solicitud de puja de OpenRTB (tiempo estimado: entre 3 y 4 días)

Xandr es compatible con el protocolo OpenRTB 2.4para recibir impresiones de todo tipo de medios. Sigue la especificación OpenRTB 2.4 de IAB.

Usa los siguientes puntos de conexión para enviar a Xandr solicitudes de pujas de OpenRTB de servidor a servidor:

  • http://MEMBER_ALIAS-useast..com/openrtb2member_id=MEMBER_ID&test=1
  • http://MEMBER_ALIAS-uswest..com/openrtb2member_id=MEMBER_ID&test=1
  • http://MEMBER_ALIAS-emea..com/openrtb2?member_id=MEMBER_ID&test=1
  • http://MEMBER_ALIAS-apac..com/openrtb2?member_id=MEMBER_ID&test=1

Nota:

MEMBER_ID y MEMBER_ALIAS debe sustituirse por su ID de miembro asociado individual y su alias.

No dude en utilizar los ejemplos de solicitud de oferta de la página Solicitud de oferta entrante de SSP y ajustar los campos de código en consecuencia para que coincidan con la asignación de inventario de su editor y ubicación.

Debes usar el parámetro de cadena de "test=1" consulta en las llamadas para identificar una impresión de prueba. No se registrará en los informes.

Paso 3: Pruebas manuales

  1. Proporciona un ejemplo de solicitud de puja a Xandr.

  2. Configura una ubicación de prueba en la plataforma Xandr y asegúrate de que el inventario esté asignado correctamente.

  3. Proporcione una creatividad de muestra que cumpla todos los requisitos de la colocación de la prueba.

  4. Configura una regla de calidad de anuncios que solo permita a Xandr Test Buyer comprar impresiones en la ubicación de prueba.

  5. Quitar "&test=1" de la cadena de consulta del punto de conexión cuando se inicia la prueba.

    Nota:

    Si no eliminas "&test=1", los diablillos no se registrarán en el lado de Xandr.

  6. Activa manualmente el tráfico desde el emplazamiento de prueba para confirmar la recepción de una respuesta a la puja, el recurso creativo servido y las impresiones registradas por tu parte.

  7. Xandr ejecutará una prueba de entrega desde un asiento de miembro dedicado del lado de la compra y le notificará cualquier discrepancia antes de escalar aún más su inventario.

  8. Xandr validará tus solicitudes de puja de OpenRTB y te lo notificará en caso de que sea necesario corregir el formato.  

Paso 4: Prueba funcional programática (tráfico en vivo)

  1. Abrir una porción pequeña pero sustancial del tráfico a Xandr en el punto final establecido (a un mínimo de varios miles de diablillos por día). Xandr confirmará el volumen de tráfico que se envía y verificará que las impresiones fluyan a través de nuestros informes y se alineen con tus informes internos.
  2. Realiza la prueba durante un día más o menos y compara los números para asegurarte de que la discrepancia entre tu informe y el informe de Xandr sea aceptable.

Paso 5: Publicar

  1. Mapee todos sus inventarios en la plataforma Xandr antes de ponerlos en marcha con un 100% de tráfico.
  2. Después de finalizar la asignación del inventario, aumenta el tráfico y quita los filtros que puedan imponerse durante las pruebas, como la segmentación previa por país, la segmentación por dispositivo y la limitación del volumen de pujas.

Paso 6: Finalización/Seguimiento (tiempo estimado: 2 - 3 días)

Recomendamos un aumento gradual del tráfico en el que se envíen distintas partes de tu inventario a Xandr. La recomendación general es comenzar con una pequeña parte del tráfico (100-200 QPS).

Notifique a su contacto de Xandr sobre la finalización de la integración / migración a su propio ritmo; su contacto iniciará las pruebas finales de validación de requisitos de OpenRTB y le proporcionará los resultados finales y los comentarios.

  • Last updated on