Compartir a través de

API de plataforma digital: procedimientos recomendados de Batch Segment Service

  • Artículo

Batch Segment Service (BSS) permite enviar fuentes masivas de datos de segmento externo a Xandr. Con BSS, puede integrar fácilmente los datos de audiencia de primera, segunda o de terceros para crear segmentos dinámicos y configurables para una segmentación de usuarios sofisticada y un aumento del ROI.

Procedimientos recomendados

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

  • Mantenga la asignación de cookies fresca y la tasa de coincidencias de usuario alta mediante la recopilación de UID con la mayor frecuencia posible.

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

  • Realice el procesamiento por lotes de los archivos tanto como sea posible (entre 100 y 300 MB).

    Los datos se cargarán más rápidamente en algunos 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 inactivos mediante la eliminación de las combinaciones de usuarios o segmentos duplicadas de los archivos.

  • Comprima los 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 necesita enviar los cambios en la pertenencia al segmento (los deltas) desde la última carga. Esto reducirá considerablemente el tamaño de los archivos y acelerará el proceso de carga.

  • Use la dirección URL de carga inmediatamente.

    Después de solicitar una dirección URL de carga, asegúrese de usarla en 5 minutos o tendrá que solicitar una nueva dirección URL. No se pueden reutilizar direcciones URL antiguas.

  • Para optimizar el límite diario de carga de BSS, asegúrese de enviar 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 con el límite de carga diario total de BSS. Esto puede dar lugar a suposiciones falsas sobre por qué determinados segmentos no se escalan y por qué los segmentos tienen un uso bajo. Eche un vistazo al campo de datos al ver el error_log_lineshistorial de carga de archivos. Enumerará todos los identificadores de segmento no válidos que se pasaron en las cargas.

  • Evite cargar los archivos más grandes durante las horas punta (10 am-10 pm EST en ee. UU., 10 am-10 pm CET en Europa).

    Durante las horas punta, hay más archivos en la cola y el archivo puede tardar más tiempo en procesarse. Si puede, programe que las cargas se realicen de la noche a la mañana. Según el Acuerdo de Nivel de Servicio, 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.

  • Confirme que funcionó.

    Una vez procesados los datos, puede comprobar de forma puntual algunos identificadores de usuario mediante el visor de cookies. Si no ve los segmentos en una geografía, compruebe la otra: lo más probable es que el usuario esté en otra ubicación geográfica.

    • NOS: 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 identificador de trabajo en las solicitudes de soporte técnico.

    Si tiene problemas técnicos, no olvide incluir todos los identificadores de trabajo pertinentes al enviar su solicitud en nuestro Portal de soporte al cliente.

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 procedimiento recomendado, intente minimizar la creación de nuevos segmentos, reutilizar los segmentos existentes siempre que sea posible o usar segmento "values" para subdividir aún más a los usuarios dentro de los segmentos existentes. Estas prácticas garantizarán que los usuarios carguen correctamente en segmentos. Para obtener más información sobre la creación de segmentos "values", consulte Segmentación de destino.

Preguntas frecuentes

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

    Si encuentra errores, puede hacer referencia al documento solución de problemas de BSS para diagnosticar posibles causas.

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

    Los datos del segmento comienzan a estar disponibles para la selección de destino en cuanto el trabajo llega a la 'validating' fase. Los datos están totalmente ingeridos y listos para el destino una vez que el trabajo ha alcanzado 'completed'. El tiempo hasta que el trabajo llega 'completed' depende del tamaño del archivo y del número de otros archivos de la cola.

    Nota:

    Espere hasta 24 horas para que las cargas se procesen (según el Acuerdo de Nivel de Servicio de Xandr).

  • ¿Habrá una marca de tiempo "desencadenada" en estos usuarios para la segmentación de edad?

    Si decide incluir el campo TIMESTAMP en los archivos, especificará la marca de tiempo para cada combinación de usuarios o segmentos. Si no incluye TIMESTAMP, la marca de tiempo será la hora a la que se escribieron los datos en nuestro almacén de cookies del lado servidor, que suele estar alrededor del "tiempo 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 almacenes de cookies independientes en Estados Unidos, Europa y Asia. Sin embargo, no es necesario cargar archivos independientes para cada geografía. El sistema Batch Segment determinará automáticamente en qué ubicación geográfica se encuentra el usuario y enviará los datos a esa base de datos de almacén de cookies. Si el usuario está 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 están pensadas para ser una lista completa de todos los errores. En su lugar, se deben usar como una herramienta de diagnóstico para diagnosticar problemas con el archivo y, a continuación, corregirlos.

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

    Cuando vea el historial de carga de archivos completo, se incluirán todos los archivos que haya cargado. Sin embargo, nuestra API limita las respuestas a 100 objetos a través de la paginación. Para ver objetos adicionales, anexe uno de estos objetos a la llamada API:

    &start_element=101

    &sort=last_modified.desc

    Puede obtener más información sobre la paginación en Limitación, Paginación y Filtrado.

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

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

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

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

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

    Tenga en cuenta el tamaño del límite diario de BSS. Si recibe un mensaje de error de nuestro sistema, detenga los trabajos de carga de archivos inmediatamente. Continuar la carga de archivos con mensajes de error repetidos podría provocar retrasos en el sistema. Espere una hora y vuelva a intentar la carga de archivos.

  • ¿Debo comprimir los archivos de carga antes de enviarlos a través del servicio de segmento de lote de API?

    Sí. Como procedimiento recomendado, siempre debe comprimir la carga de archivos antes de insertarlos a través del servicio batch segment. Se admite el estándar de compresión gzip.

  • ¿Debo insertar siempre mis audiencias completas cada vez que cargue en segmentos a través del servicio de segmentos por lotes de API?

    Como procedimiento recomendado, solo debe cargar audiencias completas a través del servicio de segmento de lote de API cuando cargue la audiencia por primera vez o cuando la audiencia haya expirado de su segmento respectivo. Además de esos dos casos, siempre debe cargar modificaciones (deltas) en las audiencias existentes. Las cargas de segmentos por lotes no actualizan el tiempo de vida de las cookies en el almacén de cookies Xandr (solo pueden actualizar la hora en que las cookies están asociadas a un determinado conjunto de segmentos).

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

    Ordenar el archivo por id. de usuario ayuda a nuestro sistema a procesar su archivo más rápidamente.

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

    La tasa de coincidencia de usuario de un trabajo es el porcentaje de identificadores que nuestro sistema había visto antes, dividido por la cantidad total de identificadores cargados. 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 usan esta métrica para evaluar la calidad de los datos cargados. La fórmula para calcular la tasa de coincidencias es:

    tasa de coincidencia de usuario = num_valid_user / ( + num_valid_usernum_invalid_user)

  • No creo que esto funcione. ¿Puedes ayudar?

    ¡Seguro! Envíe un caso a través de nuestro Portal de soporte al cliente. 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 algunos identificadores en LLD que no se cargaron a través de BSS?

    Los identificadores cargados de destino también se dirigirán a los 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 id. cargado a través de un identificador de dispositivo relacionado.