Datos de nivel de registro por lotes
Los datos de nivel de registro por lotes (LLD) le permiten recuperar y realizar un seguimiento de las fuentes de datos de eventos de nivel de registro que incluyen dimensiones que no están disponibles en la interfaz de usuario de Xandr o a través de API Report Service de forma procesada por lotes. Las fuentes se generan cada hora y se dividen en uno o varios archivos (consulte Formatos de archivo a continuación). El formato del archivo que reciba dependerá de lo que haya especificado al suscribirse (por ejemplo, Avro, Protobuf, Protobuf delimitado).
Para obtener información general sobre los datos de nivel de registro, vea [Fuentes de distribución de datos de nivel de registro](log level-data-feeds.md).
Formatos de archivo & esquemas
Puede especificar uno o varios de los siguientes formatos al suscribirse al servicio.
Use las descargas que se proporcionan a continuación para los archivos de ejemplo empaquetados y el código para consumir archivos de datos de nivel de registro.
Nota:
Los archivos de ejemplo se crean para ayudarle a probar la implementación que usará para consumir archivos de datos de nivel de registro. Para facilitar las pruebas, los archivos de ejemplo son algo más sencillos que los archivos generados que se recuperarán en producción:
- Los archivos de ejemplo para el formato protobuf no se comprimen (en producción, están comprimidos con Snappy)
- Los datos de ejemplo no contienen valores típicos de una columna determinada. En su lugar, las columnas se rellenan con el número de índice de la columna convertido al tipo de la columna.
| Versión | Fecha de lanzamiento | Zip de esquemas | Archivo ZIP de ejemplo | Código postal de ejemplo (incluye esquemas y archivos de ejemplo) | Notas |
|---|---|---|---|---|---|
| 0.5.46 | 21 de mayo de 2024 | Descargar | Descargar | Descargar | Añadidoprivate_auction private_auction_eligible chrome_traffic_label a fuente estándar. |
| 0.5.44 | 21 de febrero de 2024 | Descargar | Descargar | Descargar | Añadidosplit_id external_campaign_id external_bidrequest_id external_bidrequest_imp_id postal_code_ext_id Los siguientes valores se agregarán al campo existente event_type :click served started skipped error 25_pct 50_pct 75_pct 100_pct |
| 0.5.43 | 2 de enero de 2024 | Descargar | Descargar | Descargar | Se ha agregado vg_id a la fuente de eventos de vídeo |
| 0.5.42 | 10 de noviembre de 2023 | Descargar | Descargar | Descargar | Se ha agregado curated_deal_code a la fuente del conservador |
| 0.5.41 | 30 de octubre de 2023 | Descargar | Descargar | Descargar | Se ha agregado external_bidrequest_id y external_bidrequest_imp_id a la fuente de transparencia de marca/comprador. |
| 0.5.37 | 22 de junio de 2023 | Descargar | Descargar | Descargar | Se ha agregado region_id a la fuente estándar. |
| 0.5.36 | 2 de mayo de 2023 | Descargar | Descargar | Descargar | En desuso data_costs de la fuente estándar. |
| 0.5.35 | 8 de marzo de 2023 | Descargar | Descargar | Descargar | Se ha agregado fallback_ad_index a la fuente estándar. |
| 0.5.31 | 1 de febrero de 2023 | Descargar | Descargar | Descargar | Se ha agregado segment_data_costs y feature_costs a la fuente estándar. |
| 0.5.27 | 1 de noviembre de 2021 | Descargar | Descargar | Descargar | Se ha agregado un nuevo campo, extended_ids, a la fuente estándar y a la fuente del conservador. |
| 0.5.26 | 14 de octubre de 2021 | Descargar | Descargar | Descargar | La fuente de transparencia del comprador (brand_transparency_feed) ahora es una fuente de nivel de registro totalmente compatible (anteriormente era una versión alfa). |
| 0.5.25 | 8 de septiembre de 2021 | Descargar | Descargar | Descargar | Se han agregado dos nuevos campos device_unique_idip_address a la fuente de incrementalidad. |
| 0.5.24 | 22 de julio de 2021 | Descargar | Descargar | Descargar | Se ha agregado un nuevo campo, postal_code_ext, a la fuente estándar. |
| 0.5.22 | 21 de julio de 2021 | Descargar | Descargar | Descargar | Se agregó device_id el campo a la fuente del conservador. Estos valores de identificadores se pueden buscar mediante el servicio Xandr API Device Model. |
| 0.5.21 | 18 de junio de 2021 | Descargar | Descargar | Descargar | Se agregaron 3 campos nuevos, operating_system, browsery language a la fuente del conservador. Estos valores se pueden buscar mediante el servicio de sistema operativo de la API Xandr, el servicio de explorador y el servicio de lenguaje , respectivamente. |
| 0.5.20 | 20 de mayo de 2021 | Descargar | Descargar | Descargar | Se ha agregado un nuevo campo, device_make_id, a la fuente estándar. El campo contiene el identificador de la marca del dispositivo, que suele ser el fabricante del dispositivo (por ejemplo, Samsung). Para asignar identificadores de dispositivo a nombres, use el servicio Device Make. |
| 0.5.18 | 19 de abril de 2021 | Descargar | Descargar | Descargar | Se han agregado mejoras a la fuente del conservador (curator_feed). |
| 0.5.15 | 31 de marzo de 2021 | Descargar | Descargar | Descargar | - Se ha agregado un nuevo campo, personal_identifiers, a la fuente estándar. Este campo de tipo "repetido" aparece tanto a los compradores como a los vendedores para las impresiones con transacciones, sin transacciones y vistas. - Se agregó la versión inicial de la fuente del conservador ( curator_feed). |
| 0.5.10 | 4 de febrero de 2021 | Descargar | Descargar | Descargar | - Se han realizado los siguientes cambios en la fuente de transparencia del comprador: Los campos siguientes se agregaron en ( bid message índice 9):external_campaign_id insertion_order_id bidder_seat_id bidder_seat_name El sasc_cap_savings campo se agregó en ( result message index 10). - El custom_parameters campo (índice 17) de la fuente universal de píxeles se ha cambiado de un campo opcional a uno repetido. Consulte la documentación de las fuentes individuales para obtener más información sobre los campos que se han agregado. |
| 0.5.7 | 6 de abril de 2020 | Descargar | Descargar | Descargar | Se han agregado 4 campos nuevos a la fuente universal de píxeles. Los nuevos campos son: - traffic_type - Origen del tráfico al que está realizando el seguimiento el píxel. Los valores posibles son WEB o APP - application_id - El identificador de la aplicación (en el almacén de aplicaciones) en el que se ha colocado el píxel. Este valor puede ser numérico o alfanumérico (por ejemplo, com.xandr.application_name)- device_unique_id - El identificador único que representa el dispositivo móvil (el valor de este campo será null excepto para las integraciones específicas). El prefijo numérico indica el tipo de identificador de dispositivo único:0 = IDFA (Id. de Apple para publicidad)1 = SHA12 = MD53 = ODIN4 = OPENUDID5 = AAID (Id. de publicidad de Android)6 = WINDOWSADID (Id. de Microsoft Advertising). - custom_parameters - Contiene todos los parámetros personalizados que se enviaron con el píxel desencadenado. |
| 0.5.4 | 27 de enero de 2020 | Descargar | Descargar | Descargar | Corrección del esquema usado para liberar la nueva fuente universal de píxeles. |
| 0.5.2 | 7 de noviembre de 2019 | Descargar | Descargar | Descargar | Se ha agregado un nuevo external_campaign_id campo a la fuente estándar en LLD. Este nuevo campo opcional solo debería aparecer a los vendedores en las filas de impresiones revendidas. El valor de este campo se pasa a través del cid campo en una oferta de DSP. Dado que el cid campo es opcional, el nuevo external_campaign_id campo solo tendrá datos cuando los CSP externos lo rellenen en sus pujas. Consulte la especificación Open RTB para obtener más información sobre el cid campo. |
| 0.5.1 | 10 de septiembre de 2019 | Descargar | Descargar | Descargar | - Se ha agregado partner_fees a la fuente estándar. - Se ha agregado partition_time_millis un campo a todas las fuentes para simplificar la carga y partición de datos en bases de datos. - Se ha agregado hashed_user_id_64 un campo a las fuentes de píxeles y segmentos de conversión para los clientes que solo quieren datos personales anónimos. |
| 0.4.4 | 29 de mayo de 2019 | Descargar | Descargar | Descargar | Se ha agregado tc_string a la fuente estándar. |
| 0.3.4 | 10 de abril de 2019 | Descargar | Descargar | Descargar | Se ha agregado split_id a la fuente estándar. |
| 0.3.3 | 5 de abril de 2019 | Descargar | Descargar | Descargar | - Se ha agregado hashed_user_id_64 a la fuente de segmentos. - Se ha agregado hashed_user_id_64, latitude_trunc, longitude_trunc a la fuente estándar sin traducir. |
| 0.3.0 | 4 de octubre de 2018 | Descargar | Descargar | Descargar | - Se han agregado esquemas de Avro y archivos de ejemplo. : se ha agregado partition_time_millis una columna a todas las fuentes para el filtrado de particiones por registro. |
| 0.2.4 | miércoles, 22 de agosto de 2018 | Descargar | Descargar | Descargar | - Se ha quitado hashed_device_unique_id del esquema de fuente estándar (ya no se usa)- Se ha agregado el esquema para la fuente estándar sin traducir. |
| 0.1.9 | 12 de abril de 2018 | Descargar | Descargar | Descargar | - Permitir la especificación de la versión protobuf, por ejemplo, -Dprotobuf.version="2.5.0" - Buscador de clases de esquema revisado para trabajar con código generado proto3 |
| 0.1.8 | 16 de marzo de 2018 | Descargar | Descargar | Descargar | Se ha agregado una sugerencia de sintaxis proto2 para que los archivos proto sean compilables con proto3. |
| 0.1.7 | 12 de marzo de 2018 | Descargar | Descargar | Descargar | Protobuf-delimited ahora está comprimido con GZIP y se ha actualizado el código de ejemplo en consecuencia. |
| 0.1.6 | 7 de marzo de 2018 | Descargar | Descargar | Descargar | Se han agregado campos de datos personales anonimizados a varios esquemas LLD pertinentes |
| 0.1.4 | 8 de diciembre de 2017 | Descargar | Descargar | Descargar | Se ha agregado imps_for_budget_caps_pacing una columna a standard_feed |
| 0.1.3 | lunes, 16 de octubre de 2017 | Descargar | Descargar | Descargar | Versión inicial |
Protobuf (búferes de protocolo encapsulados en archivos de secuencia)
Importante
Actualmente solo se admite la versión 2.5.0 de protobuf.
Los archivos son archivos de secuencia de Hadoop comprimidos de Snappy en los que el valor de cada registro es BytesWriteable, cuyo carga útil es un mensaje de búfer de protocolo codificado.
Todos los esquemas especifican que los campos son opcionales y null los valores son campos no establecidos en el mensaje protobuf. Consulte las fuentes individuales en Fuentes de distribución de datos de nivel de registro para conocer las condiciones que hacen que el valor de un campo sea null y para obtener más detalles sobre la disponibilidad de las columnas.
Consulte Instalación y configuración de Protobuf para obtener instrucciones sobre cómo instalar y configurar el compilador protobuf y descargar un proyecto que incluya los esquemas y el código de ejemplo.
Delimitado por Protobuf (búferes de protocolo)
Importante
Actualmente solo se admite la versión 2.5.0 de protobuf.
Los archivos son archivos comprimidos GZIP que contienen mensajes de búfer de protocolo delimitados por longitud. Cada registro es un varint que especifica la longitud del mensaje, seguido del propio mensaje protobuf. Una razón para usar nuestro formato delimitado por protobuf en lugar de nuestro formato protobuf es que la lectura de archivos delimitados por protobuf no requiere Hadoop o Hadoop con compatibilidad nativa con Snappy.
Todos los esquemas especifican que los campos son opcionales y null los valores son campos no establecidos en el mensaje protobuf. Consulte las páginas de servicio de fuente individuales para conocer las condiciones que hacen que el valor de un campo sea null y para obtener más información sobre la disponibilidad de las columnas.
Consulte Instalación y configuración de Protobuf para obtener instrucciones sobre cómo instalar y configurar el compilador protobuf y descargar un proyecto que incluya los esquemas y el código de ejemplo.
Avro
Avro es un marco de serialización de datos que agrupa esquemas con datos. Para la compresión, se usa el códec DEFLATE (nivel = 1). Para obtener más información, consulte la documentación de Avro.
Nota:
A diferencia de nuestros formatos protobuf, null los valores nunca se usan. Los campos que faltan o no se establecen se codifican con sus valores predeterminados, tal como se especifica en el esquema de fuente.
Avro se ofrece para una integración más sencilla con sistemas en la nube de terceros existentes. Debido a las incompatibilidades encontradas al probar las integraciones, un campo que es "enum" en protobuf se envía como Avro "int".