Configuration and Operational Requirements
Unless Client uses Service Provider’s Streaming and Delivery Services, Client shall either (a) implement the latest version of Service Provider’s Listener Tracking API, as provided to Client by Service Provider, or (b) allow Service Provider to collect logs from the Client's streaming servers or content delivery network (Log Collection).
The requirements described below apply, depending on the Client setup.
Log-collection
Log Type and HLS Requirements
This service only supports session logs, which need to characterize a human-listening session from initial play to the next pause/stop. It does not support HLS chunks and m3u8 log entries, and it does not re-assemble those in order to re-create session information. Therefore, the CDNs or publishers are responsible for providing session information even when doing HLS.
Entrega de archivos de registros y frecuencia
Triton Digital obtiene los archivos de registro del FTP o SFTP del publisher (punto de recogida). Los publishers deben proporcionar las credenciales necesarias para obtener los archivos de registro.
Los archivos de registro deben alcanzar el punto de recogida al menos a diario, pero puede ser más frecuente, en especial si los registros son más grandes y se encuentran en múltiples fragmentos. Triton Digital espera recibir información de la sesión en un plazo de cuatro días a partir del comienzo de la sesión. Si el registro de la sesión se recibe después de esta demora, no se tomará en cuenta en las mediciones agregadas.
Nombre del archivo
Los archivos de registro deben tener un nombre único, con la fecha como parte del nombre del archivo. Cada archivo con nombre debería llegar a la ubicación de recogida cuando el archivo está completo (en vez de abrir FTP en la carpeta de registro real donde los archivos se escriben activamente) y cada nombre de archivo único será recuperado/procesado una vez. An example of a good filename for this purpose is: MSLT20170830-00.tsv.gz, where 20170830 is the date, and -00 is a suffix, if needed, for the hour, file-number on that day, or some other sequencing/unique identifying value.
Para mayor eficiencia, cada archivo de registro debería ser comprimido en un archivo individual ".gz".
Formato del archivo
Los archivos de registro deben estar en uno de los siguientes formatos:
- Formateado en la salida estándar del servidor de streaming. La salida del registro de acceso predeterminado de los servicios de streaming de audio más actuales por lo general se usa sin hacer cambios especiales en la configuración.
- Formateado según el formato de archivo extendido W3C (https://www.w3.org/TR/WD-logfile-960221.html). Este formato se usa comúnmente para salida de servidor de streaming. Es básicamente un archivo delimitado por tabuladores o espacios con un encabezado que identifica los nombres de los campos en cada columna en los datos.
- Formateado como valores separados por tabuladores (tsv). Details: Tab character (As \t or 0x09). Line Ending (\n or 0x0A). The # character for a commented line. Se recomienda la línea del encabezado, pero es opcional. If this format is used, please contact your Triton Digital Client Success Manager with details on your planned output format/fields so that we can ensure it matches with a log parsing scheme.
Required and Optional Fields in the Log Lines
| Campos obligatorios (LC/LT) | Descripción |
|---|---|
| Dirección IP de alojamiento remoto (o nombre del sistema si las búsquedas de DNS están habilitadas) del cliente. |
| Date at which transaction is completed. Format is YYYY-MM-DD. |
| The timestamp of the session end. Format is HH:MM:SS where HH is the hour in 24 hour format. |
| Numérico, hasta nueve dígitos. Es la duración de la sesión de escucha, en segundos enteros. |
| Up to 2048 characters complete URI (or URL). Este valor debería completarse automáticamente con un punto de publicación (URI) único, de modo que el registro pueda aplicarse a esa estación en nuestro sistema. En otras palabras, una parte de este campo se usará como la clave para coincidir con una estación en la base de datos de Triton Digital. |
| Contenido de la cabecera HTTP de "agente de usuario". Esta cabecera HTTP de agente de usuario contiene una secuencia característica que permite a pares de protocolo de red identificar el tipo de aplicación, el sistema operativo, el distribuidor del software o la versión del software del agente de usuario del software solicitante. |
Campos opcionales | Descripción |
autoplay | Flag that indicates if the session has been initiated from a player auto-play. Possible values are autoplay=0 (not initiated via auto-play) and autoplay=1 (initiated via auto-play). Auto-play of audio content is strongly discouraged since in some cases, auto-played streams are not audible as the volume may be muted while the stream continues to be active. Triton Digital recommends that any initiation of audio content playback is determined by an overt user gesture, such as a tap or a click. |
| La dirección de la página web anterior desde la cual se siguió un enlace hacia la página actualmente solicitada. |
| The timestamp of the session start. Format is HH:MM:SS. |
| Identificador de la estación donde el oyente inició una sesión de escucha. Si este valor está presente, puede sustituir el URI como la clave para coincidir con una estación en la base de datos de Triton Digital. |
| Una ID de visitante única que puede usarse para identificar a un oyente y debe provenir del mecanismo de registro del oyente. |
| The Triton Digital LSID (también conocido como UUID). This is the App/Cookie/Advertising ID as presented in the Listener ID Management topic of the Advertising Technical Specification. Typically, on a mobile device, this is a Google gaid or Apple idfa, or if not available, an application-generated ID. En una computadora de escritorio, debería ser una ID de cookie. |
| Listener's gender (M or F or U). U can be used for "other" or "unknown" gender. |
| Listener's year of birth, using the YYYY format. |
| La edad del oyente. |
| El código postal del oyente (5 dígitos); también puede ser alfanumérico, sin espacios. |
| Macador que indica si la sesión de escucha puede recibir publicidad. Possible values are 0 and 1. Sending 0 indicates the session cannot receive advertising. |
| Propiedad adicional que se usa para especificar en qué dispositivo se inició la sesión. Triton Digital puede proporcionar una lista no exhaustiva de los dispositivos disponibles, pero los clientes pueden ampliar esa lista para su propio uso. |
| Propiedad adicional que puede usarse para producir una agregación que muestre en qué distribuidor/socio se inició la sesión. For example, Publisher A shares their stream on Distributor/Partner B, so the Distributor property is "B." |
| Propiedad adicional que puede usarse para producir una agregación que muestre el publisher del stream. Por ejemplo, Publisher A comparte su stream en Socio B, de modo que la propiedad ss es "A". Esto rara vez se usa, ya que el publisher generalmente produce los registros. |
| Propiedad adicional que se usa para especificar en qué reproductor se inició la sesión. Triton Digital puede proporcionar una lista no exhaustiva de todos los reproductores disponibles, pero los clientes pueden ampliar esa lista para su propio uso. |
QUERY PARAMS | Es posible que se proporcione cualquiera o todas las secuencias de parámetros de búsqueda URI para un posible uso futuro. |
Customs / Others | Cualquier otro parámetro enviado será ignorado por nuestros sistemas. |
Listener Tracking-based
For Listener Tracking information, see the Triton Digital Measurement Guide.
Cambio de equipos
Client shall notify Service Provider prior to any change made to Client Equipment (defined as any and all hardware, software, network, infrastructure and any other type of equipment which is used in connection with the Services, whether owned by Client or a third-party, and which is not under the direct control of Service Provider) or processes that may affect, directly or indirectly, the measurement output including, without limitation, changes in Client’s content delivery network, Raw Data or listener tracking implementation. Notwithstanding the notification provisions of the Agreement, such notification shall be made by way of email to measurement@tritondigital.com.
Web Player and Application Guidelines for Webcast Metrics
Web player and application guidelines are described in the Triton Digital Measurement Guide. Topics include:
- Stop vs. Pause
- Reproducción automática
- Iniciar y detener en el momento adecuado
- Silenciado/requisito de audibilidad
- Enlaces directos en navegadores web
- Sesiones largas
- Uso de ID de visitante (oyente) para la metodología LT
- Se requiere cache-busting para la metodología LT
- HTML5 Consideration: Pre-load/Pre-fetch
- HTML5 Consideration: Stopping the Audio
Real-time Statistics
As part of our basic offering we allow stations to get real-time reports of their live listeners for every five minute data point of every day. To accumulate these statistics, real-time audience data must be provided by the CDN using a publicly accessible XML feed that displays the current listener count for each stream that is hosted for a particular radio station.
This requirement is already met if you use Triton Digital as your CDN, and real-time statistics are included with Listener Tracking-based WCM.