This guide explains how to maintain control over your radio streaming flows, for example to decide whether a listener can listen to your radio, by activating GeoIP protection.

Protect an audio stream by GeoIP

The principle is simple and all you need to do is go to the restriction settings:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product in question.
3. Click on the name of the audio stream in question.
4. Click on Restrictions in the left sidebar.
5. Click on the action menu ⋮ to the right of the relevant stream in the displayed table.
6. Click on GeoIP restriction:

Then configure the restrictions:

1. Choose whether the listed countries will be allowed or blocked.
2. Search for a country to add it to the list.
3. Enable the advanced configuration if necessary.
4. Copy or paste a list of countries (useful for restricting other streams with a simple copy-paste).
5. Click to remove all countries listed on the page.
6. Click the blue button to save:
   

This guide concerns the listening information of Streaming Radio which can be exported using the FTP protocol; these logs (from which the listening statistics are also derived after "cleaning" or "purification") are then automatically transferred by FTP to be subsequently processed.

Preamble

• Your radio logs will be provided as a compressed file xyz.mp3-20140805.log.gz (the log date is in the format YYYYMMDD).
• Each log starts at 04:00 Swiss time and ends at 03:59:59 the next day.
• The log is in the form 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

  • It may happen that the log line is malformed, due to a referer that is too long for example; this behavior of Icecast cannot be modified.
• The IP range 84.16.67.128/25 should be ignored as these are the streaming servers.
• From the settings page on the Manager, you can request the logs from past days.
• You can also directly export them to ACPM or Mediapulse.

Enable FTP log sending

For this:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on the name of the audio stream in question.
4. Click on Settings in the left sidebar.
5. Enable FTP log export with the toggle switch.
6. Enter a hostname: FTP server address.
7. Enter a username: FTP account name.
8. Enter a password: that of the FTP account.
9. Enter the directory on the server where to store the logs.
10. Click on the Save button at the bottom of the page:
    

Process the logs

The best option is to use a regular expression like the one below:

"/^(\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";

This syntax is for the PHP function preg_match and will need to be adapted if other functions/languages are used.

The function preg_match returns an array with the following significant positions:

This guide explains how to transmit the metadata for the radio stream sent from your encoder of Streaming radio.

Use the available URL

You just need to do a GET on a URL of this type:

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

The full URL is available on the administration interface:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on the name of the audio stream in question.
4. Click on Settings in the left sidebar.
5. Click the button to copy the metadata link:
   

Learn more

For developers who would code a Player, there are libraries that can search for the transmitted info and display it because the data is transmitted in the stream data. The other possibility is to retrieve the stream info from the server itself.

This guide covers the audience and listening statistics for Streaming Radio, allowing you to view all information about listeners and different audiences for your radio streams.

Foreword

• Refer to this other guide if you wish to process the raw logs yourself.

Accessing listening statistics

To access this information:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on Statistics in the left sidebar:
   
4. Click on the different menus in the left sidebar:

Overview

Real-time audience

Refer to this other guide for more information on this topic.

Listeners

Listening time

Consumption

Geolocation

Exporting to .csv format is possible:

Players

This guide explains how to modify a Streaming Radio offer to, for example, increase the maximum monthly consumption limit or the quality of broadcast (max bitrate).

Modify the existing offer

To modify your existing radios:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product in question:
   
3. Click on the chevron ‍ to manage the product.
4. Click on Modify the offer in the dropdown menu:
   
5. Choose the new offer that best suits your needs:
   

The change is made after payment, with a prorated calculation of fees based on the remaining time until the initial expiration date.

This guide explains how to remove an audio stream from your Streaming Radio, without deleting the entire product.

Delete a radio station

To access the Streaming service and delete one of the streams:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product in question:
   
3. Click on the name of the radio in question:
   
4. Click on the action menu ⋮ located to the right of the relevant item.
5. Click on Delete:
   
6. Enter the name of the radio to confirm deletion.

This guide explains how to properly set up a stream on the Streaming radio Infomaniak.

Setting up radio stream broadcasting

To access the radio streaming service:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on the radio name.
4. Click on the Add a stream button:
   
5. then click again on the Add a stream button:
   
6. Add a standard stream (refer to this other guide regarding stream relays):
   
7. Choose the desired options:
   
8. Click on the Save button.

You can now configure an application with the parameters obtained at the end of this procedure.

This guide explains how to specify a backup audio stream on the Streaming radio Infomaniak.

Thus, if your main stream becomes unavailable, the backup stream will automatically take over the broadcast.

Create a backup stream

To access the radio streaming service:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the relevant product.
3. Click on the radio name.
4. Click the Add a stream button to create a new stream and add a backup stream to it or Configure an existing stream to activate the option:
   
5. Click the toggle switch to enable the backup stream on your stream:
   
6. Copy the information provided to configure your backup encoder.
7. Save the activation of the backup stream at the bottom right of the page.

In the same place, you can set the backup stream as a stream relay to manually enter the corresponding parameters for the backup audio stream:

Save the new information at the bottom right of the page.

This guide concerns the listening information of Streaming Radio that can be exported to ACPM (formerly OJD Numérique).

Preamble

• The ACPM, Alliance for Press and Media Figures, is an independent organization in France that certifies data related to the distribution, audience, and traffic of media outlets.
• These data, recognized as the official reference, support market players in the media and advertising sectors in their analysis, comparison, and structuring of their strategies.
• Governed by its bodies composed of media professionals, ACPM ensures transparency, independence, and methodological rigor; it provides reliable certifications in line with the evolution of the media sector.
• Also, refer to this other guide about a similar service but intended for Switzerland.

Manage ACPM certification

Prerequisites

• The Organization where the Streaming service is located must be established with an address in France.
• To activate ACPM certification, please contact this service by email: equipe-ojdnumerique@acpm.fr.
• Once the contract has been established with them, contact Infomaniak support by providing the information related to your ACPM and Infomaniak contract.

To manage the activation or deactivation of the service:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product in question.
3. Click on the name of the audio stream in question.
4. Click on Settings in the left sidebar.
5. Enable or disable the export of logs to ACPM with the toggle switch:
   ‍

SpacialAudio SAM Cast is compatible with the audio streaming offer.