Compartir a través de

Proceso de integración

  • Artículo

En este documento se incluye la información necesaria para que los asociados de suministro revisen, planifiquen y ejecuten una nueva integración de OpenRTB o migren desde una integración de protocolo SSP personalizada al estándar OpenRTB, de forma automática.

Nota:

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

Lista de comprobación de requisitos previos

Nota:

Si aún no tiene una cuenta del portal de soporte al cliente, visite la página Inicio de sesión , continúe como invitado y solicite un nuevo registro de usuario.

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

Nota:

Las comprobaciones de requisitos previos solo se completan una vez firmado el contrato y se crea el identificador de miembro. Antes de eso, solo se puede procesar el punto 1a. . Sin embargo, hasta que el contrato se contrafirma, nos encantaría iniciar la conversación con su equipo de integración para que pueda familiarizarse con el proceso y hacer que sus preguntas técnicas se aborden de inmediato.

  • Se espera que la interacción tome entre 3 y 4 semanas.
  • El cliente debe revisar completamente la lista de comprobación de requisitos previos (este documento) y recopilar toda la información antes de seguir los pasos siguientes.

Paso 1: Entrenamiento y creación de api e interfaz de usuario autoguiadas de objetos de publicación y ubicación (tiempo estimado: 7 - 10 días)

  1. Revise la documentación de la api y la jerarquía de objetos Xandr.

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

  3. Create objetos de venta para sincronizar inventarios (al menos los que se necesitan para las pruebas funcionales iniciales) a través de la interfaz de usuario o API

  4. Configure una ubicación predeterminada en el nivel de publicador y miembro. (en caso de que no podamos identificar el inventario de la solicitud de puja, la impresión se iniciará sesión en esa ubicación predeterminada).

  5. Use el code campo para asignar las solicitudes de puja a los publicadores y las ubicaciones. Para obtener más detalles y ejemplos, lea las Preguntas más frecuentes sobre integración.

    Nota:

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

  6. Use el servicio publisher para crear publicadores asignados al inventario.

    Nota:

    • El code campo es necesario para todos los vendedores externos tanto en los niveles de publicación como de ubicación, y es muy recomendable para todos los demás vendedores asegurarse de que el inventario sea lo más granular posible para que se pueda investigar con precisión en caso de problemas de calidad y específicamente para la detección de dominios. Este paso le ayudará a dividir el inventario en etiquetas altamente detectables y menos detectables, lo que le permite aislar los impactos de los dominios no detectables en el resto de la viabilidad del inventario.
    • Para crear o editar publicadores en o la API, debe declarar la relación de inventario. La información solicitada es información empresarial básica sobre cómo se accede al inventario y se usará para admitir 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 de Publisher Service .

  7. Configuración de sincronización de usuario
    Almacene la tabla de asignación de usuarios entre Xandr y la suya mediante el servicio getUID. Obtenga más información sobre la asignación de id. de usuario.

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

Xandr admite el protocolo OpenRTB 2.4para recibir todas las impresiones de tipo multimedia. Siga la especificación de OpenRTB 2.4 de IAB.

Use los puntos de conexión siguientes para enviar solicitudes de puja de OpenRTB de servidor a servidor a Xandr:

  • 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 se debe sustituir por el identificador y el alias individuales de miembro del asociado.

No dude en usar los ejemplos de solicitud de puja de la página Solicitud de puja entrante de los SSP y ajustar los campos de código según corresponda para que coincidan con la asignación de inventario de publicación y ubicación.

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

Paso 3: Pruebas manuales

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

  2. Configure una ubicación de prueba en la plataforma Xandr y asegúrese de que el inventario está asignado correctamente.

  3. Proporcione una creatividad de ejemplo que cumpla todos los requisitos de la selección de ubicación de la prueba.

  4. Configure la regla de calidad del anuncio que solo permite al comprador de pruebas de Xandr comprar impresiones en la selección de ubicación de la prueba.

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

    Nota:

    Si no quita "&test=1", los imps no se registrarán en Xandr.

  6. Active el tráfico manualmente desde la ubicación de la prueba para confirmar la recepción de una respuesta de puja, el contenido creativo y las impresiones registradas en su lado.

  7. Xandr realizará una prueba de entrega desde un puesto de socio de compra dedicado y le notificará de cualquier discrepancia antes de escalar aún más el inventario.

  8. Xandr validará las solicitudes de puja de OpenRTB y le notificará en caso de que sea necesario corregir el formato.  

Paso 4: Prueba funcional mediante programación (tráfico en directo)

  1. Abra una pequeña pero sustancial parte del tráfico a Xandr en el punto de conexión establecido (al menos varios miles de imps por día). Xandr confirmará el volumen de tráfico que se envía y comprobará que las impresiones fluyen a través de nuestros informes y se alinean con los informes internos.
  2. Ejecute la prueba durante un día más o menos y compare los números para asegurarse de que la discrepancia entre los informes y Xandr es aceptable.

Paso 5: Ir en directo

  1. Asigne todos sus inventarios en la plataforma Xandr antes de entrar en directo con un tráfico del 100 %.
  2. Después de finalizar la asignación de inventario, aumente el tráfico y quite los filtros que se pueden imponer durante las pruebas, como la segmentación previa del país, la pre-segmentación del dispositivo y la limitación del volumen de pujas.

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

Se recomienda un aumento gradual del tráfico donde se envían distintas partes del inventario a Xandr. La recomendación general es comenzar con un pequeño fragmento de tráfico (100-200 QPS).

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