API de plataforma digital: procedimiento recomendado de servicio de segmento por lotes

El servicio de segmentos por lotes (BSS) le permite enviar fuentes masivas de datos de segmentos externos a Xandr. Con BSS, puede integrar fácilmente sus datos de audiencia de primera, segunda o tercera parte para crear segmentos dinámicos y configurables para una selección sofisticada de usuarios y un mayor retorno de la inversión.

Procedimientos recomendados

  • Lea las preguntas frecuentes a continuación. Lo más probable es que su pregunta sea respondida allí.

  • Mantenga su mapeo de cookies actualizado y la tasa de coincidencia de usuarios alta recopilando UID con la mayor frecuencia posible.

    Xandr caduca los UID de forma gradual, de modo que los ID de usuario que no se han visto durante el período de tiempo más largo se eliminan de nuestra base de datos para dejar espacio para nuevos ID de usuario. Si carga UID que son muy antiguos, es probable que tenga un alto porcentaje de ID de usuario no válidos en su informe de estado.

  • Agrupe sus archivos tanto como sea posible (entre 100 y 300 MB).

    Los datos se cargarán más rápidamente en unos pocos archivos grandes en lugar de en una gran cantidad de archivos muy pequeños.

  • Deduplicar los archivos.

    Podrá mantener el tamaño y el tiempo de procesamiento bajos eliminando cualquier combinación duplicada de usuario / segmento de sus archivos.

  • Comprime tus archivos.

    Gzip es el único método de compresión compatible con este servicio. Al comprimir los archivos, podrá cargar más datos más rápidamente.

  • Evite enviar la pertenencia completa al segmento en cada archivo.

    En su lugar, solo tienes que enviar los cambios en la pertenencia a segmentos (las diferencias) desde la última carga. Esto reducirá en gran medida el tamaño de sus archivos y acelerará el proceso de carga.

  • Usa la URL de carga inmediatamente.

    Después de solicitar una dirección URL de carga, asegúrate de usarla en un plazo de 5 minutos o tendrás que solicitar una nueva dirección URL. No se pueden volver a usar direcciones URL antiguas.

  • Para optimizar su límite de carga diaria de BSS, asegúrese de enviar los datos de usuario a segmentos que existen o que se crearon en la plataforma Xandr.

    El envío de datos a segmentos no válidos, eliminados o inexistentes en la plataforma Xandr contaría para su límite total de carga diaria de BSS. Esto puede llevar a suposiciones falsas sobre por qué determinados segmentos no se escalan y por qué los segmentos tienen una baja utilización. Echa un vistazo al campo de datos cuando veas el historial de carga deerror_log_lines archivos. Mostrará todos los identificadores de segmento no válidos que se pasaron en las cargas.

  • Evita cargar los archivos más grandes durante las horas punta (de 10:00 a. m. a 10 p. m. EST en EE. UU., de 10 a. m. a 10 p. m. CET en Europa).

    Durante las horas punta, hay más archivos en cola y el archivo puede tardar más tiempo en procesarse. Si puedes, programa las cargas para que se realicen durante la noche. Según el SLA, las cargas pueden tardar hasta 24 horas.

  • Compruebe el informe de estado.

    La comprobación del informe de estado le permitirá detectar y corregir errores y cargar datos más precisos.

  • Confirma que ha funcionado.

    Una vez procesados los datos, puede comprobar algunos ID de usuario con el visor de cookies. Si no ve los segmentos en una geografía, verifique la otra, lo más probable es que su usuario esté en otra geoárea.

    • Estados Unidos: https://ib.nym1.adnxs.com/cookie?member_id=MEMBER_ID&dongle=DONGLE&uid=USER_ID
    • UE: https://ib.ams1.adnxs.com/cookie?member_id=MEMBER_ID&dongle=DONGLE&uid=USER_ID
    • Asia: https://ib.sin1.adnxs.com/cookie?member_id=MEMBER_ID&dongle=DONGLE&uid=USER_ID

  • Incluya el id. de trabajo en las solicitudes de soporte técnico.

    Si tienes problemas técnicos, recuerda incluir todos los id. de trabajo relevantes al enviar tu solicitud al Portal de soporte técnico de Microsoft Advertising.

Nota:

Asegúrese de esperar aproximadamente 20 minutos antes de intentar agregar usuarios a los segmentos recién creados (para permitir que estos segmentos se propaguen a todos los servidores). Como práctica recomendada, trate de minimizar la creación de nuevos segmentos, reutilice los segmentos existentes cuando sea posible o use segment "values" para subdividir aún más a los usuarios dentro de los segmentos existentes. Estas prácticas garantizarán el éxito de las cargas de los usuarios en los segmentos. Para obtener más información sobre cómo crear segmentos "values", consulte Segmentación de segmentos.

Preguntas frecuentes

  • He completado los trabajos de carga. Sin embargo, veo que hay errores.

    Si encuentra errores, puede consultar el documento de solución de problemas de BSS para diagnosticar la causa potencial.

  • ¿Cuánto tiempo pasará después de mi carga hasta que los datos estén disponibles para la segmentación?

    Los datos de sus segmentos comienzan a estar disponibles para la selección de destino tan pronto como su trabajo llega a la 'validating' fase. Los datos se ingieren por completo y están listos para su selección de destino una vez que su trabajo ha llegado 'completed'. El tiempo hasta que llegue 'completed' el trabajo depende del tamaño del archivo y del número de otros archivos en la cola.

    Nota:

    Las cargas pueden tardar hasta 24 horas en procesarse (según el SLA de Xandr).

  • ¿Habrá una marca de tiempo de "disparo" en estos usuarios para la segmentación por edades del segmento?

    Si elige incluir el campo TIMESTAMP en sus archivos, especificará la marca de tiempo para cada combinación de usuario / segmento. Si no incluye TIMESTAMP, la marca de tiempo será la hora en la que se escribieron los datos en nuestra tienda de cookies del lado servidor, que suele ser alrededor de la "hora de finalización" que ve en el informe de estado.

    Nota:

    La hora está en la zona horaria UTC.

  • ¿Qué ocurre si tengo algunos usuarios en EE. UU. y otros en Europa?

    Xandr mantiene tres tiendas de galletas independientes en EE. UU., Europa y Asia. Sin embargo, no es necesario cargar archivos separados para cada geografía. El sistema de segmentos por lotes determinará automáticamente en qué ubicación geográfica se encuentra el usuario y enviará los datos a esa base de datos del almacén de cookies. Si el usuario se encuentra en varias zonas geográficas, los datos se enviarán a cada ubicación geográfica en la que exista el usuario.

  • ¿Por qué estoy limitado a solo 999 líneas de error?

    Las líneas de error 999 proporcionadas no pretenden ser una lista completa de todos los errores. En su lugar, deben usarse como una herramienta de diagnóstico para diagnosticar problemas con el archivo y corregirlos.

  • ¿Por qué faltan algunos trabajos cuando veo todo mi historial de trabajos?

    Cuando consultes tu historial completo de carga de archivos, se incluirán todos y cada uno de los archivos que hayas cargado. Sin embargo, nuestra API limita las respuestas a 100 objetos a través de la paginación. Puede ver objetos adicionales anexando uno de estos a la llamada API:

    &start_element=101

    &sort=last_modified.desc

    Puede leer más sobre paginación en Limitación, paginación y filtrado.

  • Si incluyo el VALUE campo, ¿tengo que enumerar un valor para cada combinación de usuario/segmento?

    Sí. Sin embargo, si no desea asignar un valor, puede introducirlo 0 como valor.

  • ¿Con qué frecuencia puedo insertar cargas de segmentos por lotes?

    Nuestros sistemas pueden manejar un máximo de una carga por minuto (por miembro). Cualquier intervalo de carga de más de un minuto funcionará correctamente.

  • He recibido una notificación, "Intentando superar el límite de carga diaria de bytes". ¿Puedo seguir cargando archivos de datos?

    Tenga en cuenta el tamaño límite diario de su BSS. Si recibe un mensaje de error de nuestro sistema, detenga los trabajos de carga de archivos inmediatamente. Si continúas con la carga de archivos y mensajes de error repetidos, podrían producirse retrasos en el sistema. Espera una hora y vuelve a intentar la carga del archivo.

  • ¿Debo comprimir los archivos de carga antes de enviarlos a través del servicio de segmentos por lotes de API?

    Sí. Como práctica recomendada, siempre debe comprimir los archivos de carga antes de enviarlos a través del servicio de segmento por lotes. Se admite el estándar de compresión gzip.

  • ¿Debo enviar siempre mis audiencias completas cada vez que subo a segmentos a través del servicio de segmentos por lotes de la API?

    Como práctica recomendada, solo debes cargar audiencias completas a través del servicio de segmentos por lotes de la API cuando cargues la audiencia por primera vez o cuando la audiencia haya expirado de su segmento respectivo. Además de esos dos casos, siempre debes cargar modificaciones (deltas) en tus públicos existentes. Las cargas de segmentos por lotes no actualizan el tiempo de vida de las cookies en la tienda de cookies de Xandr (solo pueden actualizar el tiempo en que las cookies están asociadas a un conjunto determinado de segmentos).

  • ¿Debo ordenar los UID en los archivos de carga de mi segmento por lotes?

    Ordenar el archivo por ID de usuario ayuda a que nuestro sistema lo procese más rápidamente.

  • ¿Cómo puedo ver la tasa de coincidencia de usuarios de un trabajo?

    La tasa de coincidencia de usuarios de un trabajo es el porcentaje de identificadores que nuestro sistema había visto antes, dividido por la cantidad total de identificadores cargados. Esta puede ser una métrica útil para obtener una indicación de la calidad de los datos que se han cargado. Los equipos internos de Xandr también utilizan esta métrica para evaluar la calidad de los datos cargados. La fórmula para calcular la tasa de coincidencia es:

    Tasa de coincidencia de usuarios = num_valid_user / ( + num_valid_usernum_invalid_user)

  • No creo que esto esté funcionando. ¿Puedes ayudarme?

    ¡Claro! Envía un caso a través de nuestro Portal de soporte técnico de Microsoft Advertising. Tenga en cuenta que, aunque los informes de estado del trabajo se mantienen con 30 días de historial de trabajos, solo guardamos el archivo real de datos durante 3 días. Asegúrese de enviar su caso lo antes posible después de cargar para que podamos ver los datos que cargó.

  • ¿Por qué veo algunas identificaciones en LLD que no se cargaron a través de BSS?

    Destinar los identificadores cargados también se dirigirá a identificadores relacionados vinculados al mismo usuario. Como resultado, es posible que vea identificadores que no se cargaron en LLD. Cuando esto ocurre, el identificador se vinculó al mismo usuario que el identificador cargado a través de un identificador de dispositivo relacionado.

  • Last updated on