Fuente del conservador
La fuente del conservador de Log-Level proporciona datos sobre las impresiones con transacciones de las ofertas seleccionadas. La fuente contiene una fila por impresión con transacciones. A continuación, los conservadores pueden usar estos datos para desarrollar eficaces modelos de atribución sin conexión, paneles e informes personalizados, así como otras soluciones.
El nombre interno de Xandr para esta fuente es curator_feed
.
Secuencia
Las columnas siguientes aparecen en el mismo orden en que aparecen en el archivo de fuente de nivel de registro (de arriba abajo, de izquierda a derecha en el archivo).
Precisiónes recomendadas/longitudes de tipos de datos
En la tabla Columnas siguiente, algunos valores de la columna Type contienen una precisión o una longitud recomendadas entre paréntesis. Por ejemplo, string(100)
significa "esta cadena es probablemente (pero no se garantiza que sea) menor o igual que 100 caracteres de longitud".
En el caso de los enteros, los tamaños se describen en la sección Clave de entero .
Para numeric
los tipos de datos (punto flotante), se recomienda poder aceptar una precisión de (18,6), lo que significa que esperamos que haya un total máximo de 18 dígitos: 12 a la izquierda del separador decimal y 6 a la derecha.
En string
el caso de los tipos de datos, la longitud recomendada del campo varía en función del campo. Consulte la tabla siguiente.
Advertencia
Estas son recomendaciones, no garantías.
Los tipos de datos están diseñados para ser precisos según lo documentado. Sin embargo, la precisión o la longitud recomendadas para un tipo de datos determinado no deben leerse como garantía. Por ejemplo, el valor de una cadena o columna numérica puede superar la longitud o precisión sugeridas que se enumeran en esta página.
Las recomendaciones están diseñadas para ayudarle a compilar el sistema para ingerir estos datos. Es posible que tenga que realizar un procesamiento adicional en la salida de la fuente del conservador para que funcione con su integración concreta.
Clave de entero
- tinyint = 1 byte (8 bits)
- smallint = 2 bytes (16 bits)
- int = 4 bytes (32 bits)
- bigint = 8 bytes (64 bits)
Columnas
Índice de columna | Nombre de columna | Tipo | Description |
---|---|---|---|
01 | auction_id_64 | Bigint | Identificador de subasta único de Xandr. |
02 | date_time | Tiempo de época de UNIX | Hora y fecha del evento (por ejemplo, 1526057561 que tendría que traducirse a Friday, May 11, 2018 4:52:41 PM (UTC) ). Consulte event_type para obtener una lista de eventos. |
03 | user_tz_offset | Tinyint | Zona horaria del usuario frente a UTC. Útil para el destino de daypart. |
04 | media_type | Tinyint | El estilo de visualización general de la creatividad, clasificado por subtipo multimedia. Para asignar identificadores de subtipo multimedia a sus nombres y tipos de medios primarios, use el servicio subtipo multimedia. Para el tipo de medio de vídeo, el valor de las creative_width columnas y creative_height será 1 . |
05 | event_type | enumeración | Posibles valores: - imp = impresión- click - served = Se ha servido vasto creativo- started = Se inició VAST Creative- skipped = Se omitió vasto creativo- error = Se produjo un error al reproducir la creatividad VAST.- 25_pct = La creatividad VAST jugó continuamente durante al menos el 25 % de la duración total a velocidad normal.- 50_pct = La creatividad VAST jugó continuamente durante al menos el 50 % de la duración total a velocidad normal.- 75_pct = La creatividad VAST jugó continuamente durante al menos el 75 % de la duración a velocidad normal- 100_pct = La creatividad VAST se jugó hasta el final a una velocidad normal para que se jugara el 100% de la creatividad. |
06 | user_id_64 | Bigint | El identificador de usuario de 64 bits de Xandr almacenado en el almacén de cookies de Xandr Este campo es 0 cuando:- Xandr no tiene una coincidencia para este usuario; O - el navegador del usuario no acepta cookies; O - no tiene una base legal para acceder y procesar datos personales para una impresión en la que se aplica el RGPD. -1 Será para usuarios no admitidos o no consentidos. Nota: Si ha recibido la hashed_user_id_64 versión de este campo, no recibirá la versión sinhashed. |
07 | hashed_user_id_64 | bytes | Versión con hash del identificador de usuario de 64 bits de Xandr que se proporcionará como proxy en determinados casos en los que Xandr no puede proporcionar el valor real user_id_64 . No podrá dirigirse a los usuarios a través de su identificador de usuario con hash. Sin embargo, puede usar este identificador para calcular usuarios únicos, la frecuencia del usuario y la recencia del usuario. A continuación se proporciona un ejemplo:user_id_64: XXXXXX304391387YYYY hashed_user_id_64: 0000f47b074866470613d9397f0bd7efa78c7adec992aac5e117cbe2d55993a94767 Nota: Si recibe la user_id_64 versión de este campo, no recibirá la versión con hash. |
08 | ip_address | string | Dirección IP del usuario. Este campo tiene un máximo de 40 caracteres. |
09 | ip_address_trunc | string | La dirección IP del usuario con el último octeto quitado. Este campo tiene un máximo de 40 caracteres. |
10 | country | string | El país geográfico de la impresión. Derivado de la dirección IP del usuario o proporcionado por el sitio asociado a la impresión. Usa códigos de país ISO 3166 . |
11 | Región | string | Región geográfica de la impresión. Derivado de la dirección IP del usuario o proporcionado por el sitio asociado a la impresión. Usa códigos ISO-3166-2 para regiones de EE. UU. y Canadá, y códigos FIPS para regiones de todos los demás países. |
12 | Dma | Entero | Especifica el identificador del área de mercado designada para esta impresión. Use el Servicio de área de mercado designada para buscar el área asociada con el identificador. |
13 | city | Entero | El identificador de la ciudad para esta impresión. Derivado de la dirección IP del usuario o proporcionado por el sitio asociado a la impresión. Use el Servicio de ciudad para buscar la ciudad asociada al identificador. |
14 | postal_code | string | Código postal de la ubicación del usuario. Derivado de la dirección IP del usuario o proporcionado por el sitio asociado a la impresión. Para obtener códigos postales, consulte Servicio de códigos postales. |
15 | latitude | string | Latitud de la ubicación del usuario, cuando los datos GPS están disponibles desde un dispositivo móvil. Expresado en el formato "snn.ddd,snn.ddd", por ejemplo +12.345 , o -45.123 , donde south se representa como negativo. Puede haber un máximo de 5 posiciones decimales de precisión. |
16 | latitude_trunc | string | Valor truncado (limitado a 3 posiciones decimales) de la latitud de la ubicación del usuario, cuando los datos GPS están disponibles desde un dispositivo móvil. Expresado en el formato "snn.ddd,snn.ddd". Por ejemplo: - +12.345 o- -45.123 (donde el sur se representa como negativo). |
17 | longitude | string | Longitud de la ubicación del usuario, cuando los datos GPS están disponibles desde un dispositivo móvil. Expresado en el formato "snn.ddd,snn.ddd", por ejemplo +12.345 , o -45.123 , donde west se representa como negativo. Puede haber un máximo de 5 posiciones decimales de precisión. |
18 | longitude_trunc | string | Valor truncado (limitado a 3 posiciones decimales) de la longitud de la ubicación del usuario, cuando los datos GPS están disponibles desde un dispositivo móvil. Expresado en el formato "snn.ddd,snn.ddd". Por ejemplo: - +12.345 o- -45.123 (donde oeste se representa como negativo). |
19 | device_unique_id | string | Identificador único que representa el dispositivo móvil. El prefijo numérico indica el tipo de identificador de dispositivo único: - 0 = IDFA (Id. de Apple para publicidad)- 1 = SHA1- 2 = MD5- 3 = ODIN- 4 = OPENUDID- 5 = AAID (Id. de publicidad de Android)- 6 = WINDOWSADID (id. de Microsoft Advertising)- 7 = RIDA (Id. de Roky para publicidad)- 8.9 = AFAI (Amazon Fire OS)- 8.10 = TIFA (identificador de Tizen para publicidad (Id. de anuncio de Samsung))- 8.11 = VIDA (Vizio Advertising ID)- 8.12 = LGUDID (ID de dispositivo único de LG) |
20 | device_type | Entero | Tipo de dispositivo. Los posibles valores son: - 0 = Otros dispositivos- 1 = Equipos de escritorio y portátiles- 2 = Teléfonos móviles- 3 = Tabletas- 4 = TV- 5 = Consola de juegos- 6 = Reproductores multimedia- 7 = Establecer el cuadro superior |
21 | tc_string | string | La cadena de transparencia y consentimiento representa la cadena del marco de consentimiento y transparencia de IAB . La cadena está codificada con seguridad de url base 64 y se puede descodificar mediante la especificación técnica del marco de transparencia y consentimiento del RGPD de IAB. La cadena contiene derechos de datos, uso e información de privacidad. |
22 | curated_deal_id | Entero | Identificador de la transacción del conservador a través de la cual se transcedió la impresión. |
23 | gross_revenue_dollars | Numérico | La cantidad de gasto que el comprador envió al conservador para la impresión (incluidos los honorarios del comprador, si procede). Esto es lo mismo que el costo multimedia del comprador (excepto que el costo multimedia no incluye las tarifas del comprador). Este es el mismo valor que curator_revenue en el informe de análisis del conservador. |
24 | curator_margin | Numérico | Beneficio que el conservador realizó en la transacción. |
25 | total_tech_fees_dollars | Numérico | Los honorarios que Xandr cargó a un conservador en la impresión. |
26 | total_cost_dollars | Numérico | Cantidad que el conservador gastó en comisiones de cambio (a Xandr) y los medios de vendedor para la impresión. Esto no incluye las tarifas de margen de conservador o conservador. Este es el mismo valor que curator_total_cost en el informe de análisis del conservador. |
27 | net_media_cost_dollars | Numérico | Cantidad que el conservador gastó en los medios de vendedor para la impresión. Esto no incluye las tarifas del conservador ni el margen de conservador (si procede). Esto es lo mismo que los ingresos brutos del vendedor (que incluye las cuotas de vendedor). |
28 | seller_member_id | Entero | Id. de miembro del vendedor. |
29 | publisher_id | Entero | Identificador del publicador de la ubicación. El miembro del conservador puede asignar el identificador del publicador a un nombre mediante el servicio de reventa de inventario si el vendedor ha elegido exponer al publicador. La exposición al conservador depende del perfil de visibilidad del vendedor. |
30 | site_id | Entero | Identificador del sitio asociado a la ubicación. No se puede asociar con un nombre, excepto por el miembro vendedor propietario del sitio. La exposición al conservador depende del perfil de visibilidad del vendedor. |
31 | site_domain | string | El identificador más granular del sitio que podemos ofrecer (pero no el dominio completo). Este puede ser el dominio de un asociado de suministro (por ejemplo, doubleclick.com), la red propietaria del inventario de reventa o simplemente "inventario reventa". La exposición al conservador depende de la configuración del perfil de visibilidad del vendedor. Este campo tiene un máximo de 100 caracteres. |
32 | tag_id | Entero | Identificador de la etiqueta de selección de ubicación de la impresión. No se puede asociar con un nombre, excepto por el miembro del vendedor propietario de la etiqueta. La exposición al conservador depende del perfil de visibilidad del vendedor. |
33 | application_id | string | Identificador de la aplicación móvil (si procede). |
34 | mobile_app_instance_id | Entero | Especifica el identificador de la instancia de la aplicación móvil para esta impresión. Use Mobile App Instance Service para buscar la instancia de aplicación móvil asociada al identificador. |
35 | buyer_member_id | Entero | Identificador de miembro del comprador. |
36 | creative_id | Entero | Identificador de la creatividad servida. |
37 | brand_id | Entero | Identificador de la marca de la creatividad. El miembro del conservador puede asignar a brand_id un nombre mediante el Servicio de marca. |
38 | deal_id | Entero | Asociado seller_deal_id a la impresión, o 0 si el conservador originó la impresión del intercambio abierto. |
39 | view_result | enumeración | Resultado de la medición de la visibilidad de Xandr de la impresión. Posibles valores: - 0 = VIEW_UNKNOWN- 1 = VIEW_DETECTED- 2 = VIEW_NOT_DETECTED- 3 = VIEW_NOT_MEASURABLE- -1 = UNKNOWNNota: Para obtener más información sobre la visualización, consulte Introducción a la visualización. |
40 | view_non_measurable_reason | Entero | La razón por la que no se pudo medir la visibilidad de una impresión. Posibles valores: - 0 = N/A. La impresión se midió para la visibilidad- 1 = SCRIPT_NOT_SERVED. El script de visualización no se sirvió con la creatividad. Por ejemplo, en el inventario de aplicaciones móviles. - 2 = NO_SCRIPT_CALLBACK. El script de visualización se sirvió con la creatividad, pero no se recibió ninguna devolución de llamada o evento. Por ejemplo, el usuario dejó la página antes de que se enviara la creatividad. - 3 = TECHNICAL_LIMITATION. El script de visualización se sirvió y cargó, pero no pudo medir por un motivo técnico. Por ejemplo, un iframe entre dominios con Flash deshabilitado. - -1 = UNKNOWN. La razón es desconocida. Nota: Para obtener más información sobre la visualización, consulte Introducción a la visualización. |
41 | supply_type | enumeración | Tipo de suministro. Posibles valores: - 0 = WEB- 1 = MOBILE_WEB- 2 = MOBILE_APP- 5 = BARRA DE HERRAMIENTAS |
42 | creative_width | Smallint | Ancho de la creatividad. |
43 | creative_height | Smallint | El alto de la creatividad. |
44 | partition_time_millis | Tiempo de época de UNIX | La partición por hora en la que se encuentra cualquier fila de registro, representada como un valor de marca de tiempo de época unix (en milisegundos). Útil para definir particiones por hora al cargar en una base de datos o un almacenamiento de datos. Para el formato Avro, a este campo se le asigna el tipo lógico timestamp-millis para la detección de marca de tiempo nativa. Por ejemplo, 1568077200000 también se puede representar como martes, 10 de septiembre de 2019 a las 13:00 (UTC). |
45 | operating_system | Smallint | Sistema operativo en el que se produjo la impresión. Use el servicio del sistema operativo para buscar el sistema operativo asociado al identificador. |
46 | Explorador | Smallint | Explorador en el que se produjo la impresión. Use el servicio browser para buscar el explorador asociado al identificador. |
47 | language | Smallint | Configuración de idioma del explorador en el que se produjo la impresión. Use language service para buscar el idioma asociado al identificador. |
48 | device_id | Smallint | Modelo del dispositivo en el que se produjo la impresión. Use device model service para buscar el modelo de dispositivo asociado al identificador. |
49 | extended_ids | matriz de mensajes | Una lista de identificadores extendidos disponibles en la subasta, independientemente de si influyeron específicamente en la transacción. Consulte la tabla de extended_ids siguiente para obtener más detalles. |
50 | curated_deal_code | Cadena | curated_deal_code le permite recibir convenientemente el código que puede haber rellenado en el objeto de oferta seleccionado. |
51 | split_id | int32 | El identificador de la división que agregó la oferta seleccionada a la subasta donde el comprador compró la impresión. |
52 | external_campaign_id | string | Los CSP de valor opcional pueden pasar en el campo cid en su respuesta de puja, donde pueden indicar el identificador de elemento de línea en su sistema que envió la oferta. Dado que el campo cid es opcional, el campo external_campaign_id solo tendrá datos cuando los CSP externos lo rellenen en su respuesta de puja. Consulte la especificación Open RTB para obtener más información sobre el campo cid. |
53 | external_bidrequest_id | Bigint | Identificador único generado por Microsoft para la solicitud de puja. Los CSP pueden usar este identificador para asociar su respuesta de puja a una solicitud de puja y, potencialmente, registrar el identificador de solicitud de puja en sus propios datos de nivel de registro. |
54 | external_bidrequest_imp_id | Bigint | Identificador único de la impresión dentro de la solicitud de puja. Una única solicitud de puja puede tener varias oportunidades de impresión, cada una de ellas con su propio identificador, lo que permite a los proveedores de servicios asociar su respuesta a la puja con una impresión de solicitud de puja y registrar potencialmente el identificador de impresión de la solicitud de puja en sus propios datos de nivel de registro. |
55 | postal_code_ext_id | int32 | solo Estados Unidos. El código postal 9 digital de EE. UU. de la ubicación del usuario, en el formato 12345-1234. Derivado de la dirección IP del usuario o proporcionado por el sitio asociado a la impresión. Para obtener códigos postales, consulte Servicio de códigos postales. |
extended_ids
Índice de columna | Nombre de columna | Tipo | Descripción |
---|---|---|---|
1 | id_type | unsigned 32 bit int | Origen del identificador extendido: - 10 = Trade Desk ID (Id. unificado 1.0)- 11 = Id. de Criteo- 12 = NetID- 13 = RampID- 15 = UID 2.0 |
2 | id_value | string | Valor del identificador extendido (por ejemplo "ID0001" , ). Nota: Solo verá el valor de este campo si se le ha concedido permiso. |