Webcast Metrics et Streaming Metrics

Les exigences techniques et de service minimum suivantes s’appliquent au service WEBCAST METRICS de Triton Digital.

Configuration et exigences opérationnelles

À moins que le client n'utilise les services de streaming et de diffusion du fournisseur de services, le client doit soit (a) mettre en place la dernière version du suivi des auditeurs de l'API du fournisseur de services, fournie au client par le fournisseur de services, ou (b) permettre au fournisseur de services de recueillir des informations sur l'activité à partir des serveurs de diffusion du client ou du réseau de distribution de contenu (collecte de journaux).

Les exigences décrites ci-dessous s'appliquent, en fonction de la configuration du client.

Collecte de journaux

Type de journal et exigences HLS

Ce service ne prend en charge que les journaux de session, qui doivent caractériser une session d'écoute humaine depuis la lecture initiale jusqu'à la prochaine pause/arrêt. Il ne prend pas en charge les blocs HLS et les entrées de journal m3u8, et il ne les réassemble pas afin de recréer des informations de session. Par conséquent, les CDN ou les éditeurs sont responsables de la fourniture des informations de session, même en cas de HLS.

Livraison et fréquence des fichiers journaux

Les fichiers journaux sont extraits par Triton Digital depuis le FTP ou SFTP (point de collecte) de l'éditeur. Les éditeurs doivent fournir les identifiants nécessaires à l'obtention des fichiers journaux.

Les fichiers journaux doivent atteindre le point de collecte au moins une fois par jour, mais ils peuvent être plus fréquents, surtout si les journaux sont plus gros et en plusieurs morceaux. Triton Digital s'attend à recevoir les informations de la session dans les quatre jours suivant le début de la session. Si le journal de session est reçu après ce délai, il ne sera pas pris en compte dans les mesures agrégées.

Nom du fichier

Les fichiers journaux doivent porter un nom unique, la date faisant partie du nom du fichier. Chaque fichier nommé doit arriver au point de collecte lorsque le journal est terminé (plutôt que l'ouverture du FTP dans le dossier de journalisation où les fichiers sont en cours d'écriture active). Chaque nom de fichier unique est récupéré/traité une seule fois. Un exemple d'un nom de fichier approprié à cette fin est : MSLT20170830-00.tsv.gz, où 20170830 est la date, et -00 est un suffixe, si nécessaire, pour l'heure, le numéro de fichier de cette date, ou une autre valeur de séquençage/d'identification unique.

Pour des raisons d'efficacité, chaque fichier journal doit être compressé dans une archive à fichier unique au format « .gz ».

Format du fichier

Les fichiers journaux doivent être dans l'un des formats suivants :

Format de sortie standard du serveur de streaming. La sortie par défaut du journal d'accès de la plupart des services de streaming audio actuels est souvent utilisable, et ce, sans modification de la configuration.
Format selon le format de journaux étendu W3C (https://www.w3.org/TR/WD-logfile-960221.html). Ce format est couramment utilisé pour la sortie du serveur de streaming. Il s'agit essentiellement d'un fichier délimité par des tabulations ou des espaces avec un en-tête qui identifie les noms des champs pour chaque colonne des données.
Format sous la forme de valeurs séparées par des tabulations (tsv). Détails : caractère de tabulation (comme \t ou 0x09). Fin de ligne (\n ou 0x0A). Caractère # d’une ligne commentée. La ligne d'en-tête est recommandée mais facultative. Si ce format est utilisé, veuillez contacter votre responsable de la réussite client Triton Digital et lui fournir les informations concernant le format/les champs de sortie prévus afin que nous puissions nous assurer de la bonne correspondance à un schéma d'analyse de fichiers journaux.

Champs obligatoires et facultatifs des lignes de journaux

Champs requis (LC/LT)	Description
`ip`	Adresse IP de l'hôte distant (ou nom d'hôte si les recherches DNS sont activées) du client.
`date`	Date à laquelle la transaction est conclue. Le format est AAAA-MM-JJ.
`time` (end)	Horodatage de la fin de la session. Le format est HH:MM:SS où HH est l’heure au format 24 heures .
`time-taken` (duration)	Numérique, jusqu'à neuf chiffres. Ceci est la durée de la session d'écoute, en secondes entières.
`uri`	URI (ou URL) complet jusqu’à 2048 caractères. Cette valeur doit être renseignée avec un point de publication unique (URI), de façon à ce que l'enregistrement puisse être appliqué à cette station dans notre système. En d'autres termes, une partie de ce champ sera utilisée comme clé de correspondance avec une station de la base de données de Triton Digital.
`user-agent`	Contenu de l'en-tête HTTP « agent d'utilisateur ». Cet en-tête HTTP d'agent utilisateur contient une chaîne de caractères qui permet aux pairs du protocole réseau d'identifier le type d'application, le système d'exploitation, le fournisseur de logiciel ou la version du logiciel de l'agent utilisateur du logiciel demandeur.
Optional Fields	Description *(Ces champs peuvent être indépendants ou, dans certains cas, positionnés dans les paramètres de requête URI d’origine)*
`autoplay`	Indicateur signalant si la session a été lancée à partir d'un lecteur automatique. Les valeurs possibles sont `autoplay=0` (non lancée à partir d'un lecteur automatique) et `autoplay=1` (lancée à partir d'un lecteur automatique). La lecture automatique du contenu audio est fortement déconseillée car dans certains cas, les flux diffusés automatiquement ne sont pas audibles, car le volume peut être mis en sourdine alors que le flux est toujours actif. Triton Digital recommande que tout déclenchement de la lecture instantanée d'un contenu audio soit déterminé par un geste direct de l'utilisateur, comme un tapotement ou un clic.
`referrer`	Adresse de la page Web précédente à partir de laquelle un lien vers la page actuellement demandée a été suivi.
`start-time`	Horodatage du début de la session. Le format est HH:MM:SS.
`sid`	Identifiant de la station où l'auditeur a commencé une session d'écoute. Si cette valeur est présente, elle peut substituer l'URI comme clé de correspondance avec une station de la base de données de Triton Digital.
`vid`	Un identifiant unique de visiteur qui peut être utilisé pour identifier un auditeur et qui doit provenir d'un mécanisme d'enregistrement de l'auditeur.
`lsid`	Le LSID Triton Digital (autrement dit, l'UUID). Il s’agit de l’identifiant d’application/cookie/publicité tel qu’il est présenté dans la rubrique Gestion de l’identifiant de l’auditeur de la spécification technique de publicité. En règle générale, sur un appareil mobile, il s’agit d’un gaid Google ou d’un idfa Apple, ou s’il n’est pas disponible, d’un identifiant généré par l’application. Sur les ordinateurs de bureau, il doit s'agir d'un identifiant de cookie.
`gender`	Genre de l’auditeur (M , F ou U). U peut être utilisé pour « autre » ou « genre inconnu ».
`yob`	Année de naissance de l'auditeur, selon le format AAAA.
`age`	Âge de l'auditeur.
`zip`	Code postal de l'auditeur (5 chiffres, alphanumérique, sans espace).
`hasads`	Indication signalant si la session d'écoute peut recevoir de la publicité. Les valeurs possibles sont 0 et 1. L’envoi de 0 indique que la session ne peut pas recevoir de publicité.
`dev`	Propriété supplémentaire utilisée pour spécifier sur quel périphérique la session est lancée. Triton Digital peut établir une liste non exhaustive des dispositifs disponibles, mais les clients peuvent compléter cette liste selon leurs propres besoins.
`dist`	Propriété supplémentaire qui peut être utilisée pour générer un regroupement indiquant sur quel distributeur/partenaire la session a été lancée. Par exemple, l'éditeur A partage son flux avec le diffuseur/partenaire B, la propriété du Distributeur est donc « B ».
`ss`	Propriété supplémentaire qui peut être utilisée pour produire un regroupement montrant l'éditeur du flux. Par exemple, l'éditeur A partage son flux avec l'associé B, donc la propriété ss est « A ». Cette méthode est rarement utilisée, car les fichiers journaux sont généralement produits par l'éditeur.
`ps`	Propriété supplémentaire utilisée pour spécifier sur quel lecteur la session est lancée. Triton Digital peut établir une liste non exhaustive de tous les lecteurs disponibles, mais les clients peuvent compléter cette liste selon leurs besoins.
QUERY PARAMS	Toutes les autres chaînes de paramètres URI Query peuvent être fournies en vue d'une éventuelle utilisation future.
Personnalisation/autres	Tout autre paramètre envoyé sera ignoré par nos systèmes.

Configuration basée sur le suivi des auditeurs .

Pour plus d’informations sur le suivi des auditeurs, reportez-vous au Guide des mesures Triton Digital.

Le suivi des auditeurs ne doit pas être utilisé en conjonction avec le suivi basé sur les journaux pour suivre les mêmes appareils. En outre, le suivi des auditeurs ne peut être installé que sur des appareils permettant la modification du code source.

Changement d'équipement

Le client doit informer le fournisseur de services avant toute modification apportée à l'équipement client (défini comme tout matériel, logiciel, réseau, infrastructure et tout autre type d’équipement utilisé dans le cadre des services, qu’il appartienne au client ou à un tiers, et qui n’est pas sous le contrôle direct du fournisseur de services) ou des processus susceptibles d’affecter, directement ou indirectement, les résultats de la mesure, y compris, mais sans s’y limiter, les modifications apportées au réseau de distribution de contenu du Client, aux données brutes ou à la mise en œuvre du suivi des auditeurs. Indépendamment des dispositions de l'accord relatives à la notification, ladite notification doit être effectuée par courriel à l'adresse measurement@tritondigital.com.

Lecteur Web et directives d'application pour Webcast Metrics

Le lecteur Web et les directives d’application sont décrits dans le Guide des mesures Triton Digital. Les sujets abordés sont les suivants :

Statistiques en temps réel

Dans le cadre de notre offre de base, nous permettons aux stations d’obtenir des rapports en temps réel du nombre d'auditeurs en direct toutes les cinq minutes de la journée. Pour accumuler ces statistiques, les données d'audience en temps réel doivent être fournies par le réseau de distribution de contenu à l'aide d'un flux XML accessible au public qui affiche le nombre d'auditeurs en cours pour chaque flux hébergé pour une station de radio en particulier.

Cette condition est déjà remplie si vous utilisez Triton Digital en tant que réseau de distribution de contenu et que les statistiques en temps réel sont incluses dans le WCM basé sur le suivi des auditeurs.