Ce guide explique comment maintenir un contrôle sur vos flux de Streaming radio, pour p.ex décider si un auditeur peut écouter votre radio, en activant la protection par géolocalisation.

Protéger un flux audio par GeoIP

Le principe est simple et il suffit de se rendre dans les paramètres de restrictions: 

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur le nom du flux audio concerné.
4. Cliquez sur Restrictions dans le menu latéral gauche.
5. Cliquez sur le menu d'action ⋮ à droite du flux concerné dans le tableau qui s'affiche.
6. Cliquez sur Restriction par géolocalisation:

Configurez ensuite les restrictions:

1. Choisissez si les pays listés seront ceux autorisés ou interdits.
2. Cherchez un pays pour l'ajouter à la liste.
3. Activez la configuration avancée si nécessaire.
4. Copiez ou collez une liste de pays (utile pour restreindre d'autres flux par un simple copier-coller).
5. Cliquez pour retirer tous les pays listés sur la page.
6. Cliquez sur le bouton bleu pour sauvegarder:
   

Ce guide concerne les informations d'écoute de Streaming Radio qui peuvent être exportées grâce au protocole FTP ; ces logs (dont sont également issus les statistiques d'écoute après “épuration" ou "nettoyage”) sont alors automatiquement transférés par FTP pour être ensuite traités.

Préambule

• Les logs de votre radio seront fournis sous forme de fichier compressé xyz.mp3-20140805.log.gz (la date du log est sous forme YYYYMMDD).
• Chaque log commence à 04:00 heure suisse et finit à 03:59:59 le lendemain.
• Le log est sous la forme ip user-identifier authuser [date-time] "request" status octets "referer" "useragent" listening-time:

  • 81.56.215.98 - - [09/Apr/2019:08:23:18 +0200] "GET /toto.mp3 HTTP/1.1" 200 1211297 "-" "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.0.8) Gecko/2019032711 Ubuntu/8.10 (intrepid) Firefox/3.0.8" 69

  • Il peut arriver que la ligne de log soit mal formée, à cause d'un referer trop long p.ex ; ce comportement d'Icecast ne peut être modifié.
• Les adresses de la rangée IP 84.16.67.128/25 doivent être ignorées car ce sont les serveurs de streaming.
• Depuis la page des paramètres sur le Manager, vous pouvez redemander les logs des jours passés.
• Vous pouvez également directement les exporter vers ACPM ou Mediapulse.

Activer l'envoi de logs par FTP

Pour cela:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur le nom du flux audio concerné.
4. Cliquez sur Paramètres dans le menu latéral gauche.
5. Activez l'export de logs par FTP avec le bouton à bascule (toggle switch).
6. Entrez un nom d'hôte: adresse du serveur FTP.
7. Entrez un nom d'utilisateur: nom du compte FTP.
8. Entrez un mot de passe: celui du compte FTP.
9. Entrez le répertoire sur le serveur dans lequel stocker les logs.
10. Cliquez sur le bouton Enregistrer en bas de page:
    

Traiter les logs

Le mieux est d'utiliser une expression régulière comme celle ci-dessous: 

"/^(\S+)\s(.+)\s(\S+)?\s\[((\d\d)\/([a-zA-Z]{3,3})\/(\d\d\d\d)\:(\d\d)\:(\d\d)\:(\d\d)\s\+\d\d\d\d)\]\s"GET\s\/([\-a-z0-9]{1,40}(\.)?(mp3|aac|ogg){0,1})(.*)?"\s(\d{3,3})\s(\d+)\s"(.+)"\s"(.+)"\s(\d+)$/i";

Cette syntaxe est celle de la fonction PHP preg_match et devra être adaptée si d'autres fonctions/langages sont utilisés.

La fonction preg_match donne un tableau dont voici les positions significatives: 

Ce guide explique comment transmettre les metadata (métadonnées) pour le flux radio envoyé depuis votre encodeur de Streaming radio .

Utiliser l'URL à disposition

Il suffit de faire un GET sur une URL de type:

https://[flux]:[password]@api.infomaniak.com/1/radios/stats/metadata?data=artist - title

L'URL au complet est disponible sur l'interface d'administration:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur le nom du flux audio concerné.
4. Cliquez sur Paramètres dans le menu latéral gauche.
5. Cliquez sur le bouton pour copier le lien des métadata:
   

En savoir plus

Pour les développeurs qui coderaient un Player, il existe des librairies qui peuvent chercher l'info transmise et l'afficher car dans les données du flux, les données sont transmises. L'autre possibilité est de récupérer les infos du flux sur le serveur lui-même. 

Ce guide concerne les statistiques d'audimat et d'écoute de Streaming Radio qui vous permettent de consulter toutes les informations au sujet des auditeurs & différentes audiences de vos flux radio.

Préambule

• Prenez connaissance de cet autre guide si vous souhaitez traiter vous-même les logs bruts.

Accéder aux statistiques d'écoute

Pour accéder à ces informations:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur Statistiques dans le menu latéral gauche:
   
4. Cliquez sur les différents menus dans le menu latéral gauche:

Vue d'ensemble

Audience en temps réel

Prenez connaissance de cet autre guide à ce sujet.

Auditeurs

Temps d'écoute

Consommation

Géolocalisation

L'exportation au format .csv est possible:

Players

Ce guide explique comment modifier une offre de Streaming Radio afin de par exemple augmenter la limite max de consommation mensuelle ou la qualité de diffusion (bitrate max).

Modifier l'offre existante

Pour modifier vos radios existantes:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné:
   
3. Cliquez sur le chevron ‍  pour gérer le produit.
4. Cliquez sur Modifier l'offre dans le menu déroulant:
   
5. Choisissez la nouvelle offre qui convient le mieux à vos besoins:
   

Le changement est effectué après paiement, un calcul des frais est établit au prorata du temps restant jusqu'à l'échéance initiale.

Ce guide explique comment retirer un flux audio de votre Streaming Radio, sans supprimer le produit complet.

Effacer une radio

Afin d'accéder au service de Streaming et d'en supprimer l'un des flux :

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné:
   
3. Cliquez sur le nom de la radio concernée:
   
4. Cliquez sur le menu d'action ⋮ situé à droite de l'élément concerné.
5. Cliquez sur Supprimer:
   
6. Entrez le nom de la radio afin de valider la suppression.

Ce guide explique comment configurer correctement un flux sur le Streaming radio Infomaniak.

Configurer la diffusion d'un flux radio

Afin d'accéder au service de Streaming radio :

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur le nom de la radio.
4. Cliquez sur le bouton Ajouter un flux:
   
5. puis une seconde fois sur le bouton Ajouter un flux:
   
6. Ajouter un flux standard (prenez connaissance de cet autre guide au sujet des relais de flux):
   
7. Choisissez les options désirées:
   
8. Cliquez sur le bouton Enregistrer.

Vous pouvez désormais configurer une application avec les paramètres obtenus à la fin de cette procédure.

Ce guide explique comment spécifier un flux audio de secours sur le Streaming radio Infomaniak.

Ainsi si votre flux principal devient indisponible, le flux de secours prendra automatiquement le relais de la diffusion.

Créer un flux de secours

Afin d'accéder au service de Streaming radio :

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur le nom de la radio.
4. Cliquez sur le bouton Ajouter un flux pour créer un nouveau flux et lui joindre un flux de secours ou Configurer un flux existant afin d'activer l'option:
   
5. Cliquez sur le bouton à bascule (toggle switch) pour activer le flux de secours sur votre flux:
   
6. Copiez les informations à votre disposition afin de paramétrer votre encodeur de secours.
7. Enregistrez l'activation du flux de secours en bas à droite de la page.

Au même endroit vous pouvez définir le flux de secours comme étant un relais de flux afin d'entrer manuellement les paramètres correspondants au flux audio de secours:

Enregistrez les nouvelles informations en bas à droite de la page.

Ce guide concerne les informations d'écoute de Streaming Radio qui peuvent être exportées vers ACPM (ex-OJD Numérique).

Préambule

• L’ACPM, Alliance pour les Chiffres de la Presse et des Médias, est une organisation indépendante en France, qui certifie les données relatives à la diffusion, l’audience, et la fréquentation des médias.
• Ces données, reconnues comme référence officielle, soutiennent les acteurs du marché des médias et de la publicité dans l’analyse, la comparaison et la structuration de leurs stratégies.
• Placée sous la gouvernance de ses instances composées de professionnels des médias, l’ACPM garantit transparence, indépendance et rigueur méthodologique ; elle assure des certifications fiables et en phase avec les évolutions du secteur des médias.
• Prenez également connaissance de cet autre guide au sujet d'un service similaire mais destiné à la Suisse.

Gérer la certification ACPM

Prérequis

• L'Organisation dans laquelle se trouve le service de Streaming doit être établie avec une adresse en France.
• Pour activer la certification ACPM, merci de prendre contact avec ce service par mail: equipe-ojdnumerique@acpm.fr.
• Une fois le contrat établi avec ces derniers, contactez le support Infomaniak en indiquant les informations relatives à votre contrat ACPM et Infomaniak.

Pour gérer l'activation ou désactivation du service:

1. Cliquez ici afin d'accéder à la gestion de votre produit sur le Manager Infomaniak (besoin d'aide ?).
2. Cliquez directement sur le nom attribué au produit concerné.
3. Cliquez sur le nom du flux audio concerné.
4. Cliquez sur Paramètres dans le menu latéral gauche.
5. Activez ou désactivez l'export des logs vers ACPM avec le bouton à bascule (toggle switch):
   ‍

SpacialAudio SAM Cast est compatible avec l'offre de streaming audio.