Questa guida riguarda le informazioni di ascolto di Streaming Radio che possono essere esportate grazie al protocollo FTP; questi log (da cui derivano anche le statistiche di ascolto dopo la "pulizia" o "pulizia") vengono quindi trasferiti automaticamente tramite FTP per essere successivamente elaborati.

Premessa

• I log della tua radio saranno forniti sotto forma di file compresso xyz.mp3-20140805.log.gz (la data del log è nel formato YYYYMMDD).
• Ogni log inizia alle 04:00 ora svizzera e termina alle 03:59:59 il giorno successivo.
• Il log è nel formato 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

  • Può capitare che la riga del log sia malformata, a causa di un referer troppo lungo ad esempio; questo comportamento di Icecast non può essere modificato.
• Gli indirizzi dell'intervallo IP 84.16.67.128/25 devono essere ignorati perché sono i server di streaming.
• Dalla pagina delle impostazioni sul Manager, è possibile richiedere nuovamente i log dei giorni passati.
• È possibile esportarli direttamente verso ACPM o Mediapulse.

Attivare l'invio dei log tramite FTP

Per fare questo:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Fai clic sul nome del flusso audio interessato.
4. Fai clic su Impostazioni nel menu laterale sinistro.
5. Attiva l'esportazione dei log tramite FTP con l'interruttore a scorrimento (toggle switch).
6. Inserisci un nome host: indirizzo del server FTP.
7. Inserisci un nome utente: nome dell'account FTP.
8. Inserisci una password: quella del account FTP.
9. Inserisci la directory sul server in cui memorizzare i log.
10. Clicca sul pulsante Salva in fondo alla pagina:
    

Elaborare i log

Il meglio è utilizzare un'espressione regolare come quella qui sotto:

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

Questa sintassi è quella della funzione PHP preg_match e dovrà essere adattata se vengono utilizzate altre funzioni/linguaggi.

La funzione preg_match restituisce un array con le seguenti posizioni significative: 

Questa guida spiega come trasmettere i metadati per il flusso radio inviato dal tuo encoder di Streaming radio.

Utilizzare l'URL a disposizione

Basta fare una GET su un'URL di tipo:

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

L'URL completa è disponibile sull'interfaccia di amministrazione:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Fai clic sul nome del flusso audio interessato.
4. Clicca su Impostazioni nel menu laterale sinistro.
5. Clicca sul pulsante per copiare il link dei metadati:
   

Saperne di più

Per gli sviluppatori che codificano un Player, esistono librerie che possono cercare le informazioni trasmesse e visualizzarle perché nei dati del flusso, i dati sono trasmessi. L'altra possibilità è recuperare le informazioni del flusso direttamente dal server stesso.

Questa guida riguarda le statistiche di ascolto e di audience di Streaming Radio che ti permettono di consultare tutte le informazioni riguardanti gli ascoltatori e i diversi pubblici dei tuoi flussi radiofonici.

Premessa

• Consultate questa guida se desiderate elaborare personalmente i log grezzi.

Accedere alle statistiche di ascolto

Per accedere a queste informazioni:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Clicca su Statistiche nel menu laterale sinistro:
   
4. Clicca sui diversi menu nel menu laterale sinistro:

Panoramica

Audience in tempo reale

Consulta questa guida per ulteriori informazioni.

Ascoltatori

Tempo di ascolto

Consumo

Geolocalizzazione

L'esportazione in formato .csv è possibile:

Giocatori

Questa guida spiega come rimuovere un flusso audio dal tuo Streaming Radio, senza eliminare il prodotto completo.

Eliminare una radio

Per accedere al servizio di Streaming e rimuovere uno dei flussi:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Fai clic direttamente sul nome assegnato al prodotto interessato:
   
3. Fai clic sul nome della radio interessata:
   
4. Clicca sul menu delle azioni ⋮ situato a destra dell'elemento interessato.
5. Clicca su Elimina:
   
6. Inserisci il nome della radio per confermare l'eliminazione.

Questa guida spiega come configurare correttamente un flusso sul Streaming radio Infomaniak.

Configurare la trasmissione di un flusso radio

Per accedere al servizio di Streaming radio:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Fai clic sul nome della radio.
4. Clicca sul pulsante Aggiungi un flusso:
   
5. poi di nuovo sul pulsante Aggiungi un flusso:
   
6. Aggiungere un flusso standard:
   
7. Seleziona le opzioni desiderate:
   
8. Clicca sul pulsante Salva.

Questa guida spiega come specificare un flusso audio di backup sul Streaming radio Infomaniak.

In questo modo, se il tuo flusso principale diventa indisponibile, il flusso di backup prenderà automaticamente il relais della trasmissione.

Creare un flusso di backup

Per accedere al servizio di Streaming radio:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Fai clic sul nome della radio.
4. Clicca sul pulsante Aggiungi un flusso per creare un nuovo flusso e aggiungere un flusso di riserva o Configura un flusso esistente per attivare l'opzione:
   
5. Fai clic sul pulsante di commutazione (toggle switch) per attivare il flusso di backup sul tuo flusso:
   
6. Copiate le informazioni a vostra disposizione per configurare il vostro encoder di backup.
7. Salva l'attivazione del flusso di backup in basso a destra della pagina.

Nella stessa sezione, è possibile impostare il flusso di backup come un relais di flusso per inserire manualmente i parametri corrispondenti al flusso audio di backup:

Salva le nuove informazioni in basso a destra della pagina.

Questa guida riguarda le informazioni di ascolto di Streaming Radio che possono essere esportate verso ACPM (ex-OJD Numérique).

Premessa

• L’ACPM, Alliance per i Numeri della Stampa e dei Media, è un'organizzazione indipendente in Francia che certifica i dati relativi alla diffusione, all'audience e alla frequentazione dei media.
• Questi dati, riconosciuti come riferimento ufficiale, supportano gli attori del mercato dei media e della pubblicità nell'analisi, il confronto e la strutturazione delle loro strategie.
• Sotto la governance dei suoi organi composti da professionisti dei media, l’ACPM garantisce trasparenza, indipendenza e rigore metodologico; essa fornisce certificazioni affidabili e in linea con le evoluzioni del settore dei media.
• Prendi anche visione di questa altra guida riguardante un servizio simile ma destinato alla Svizzera.

Gestire la certificazione ACPM

Prerequisiti

• L'Organizzazione in cui si trova il servizio di Streaming deve essere stabilita con un indirizzo in Francia.
• Per attivare la certificazione ACPM, contattare questo servizio via email: equipe-ojdnumerique@acpm.fr.
• Una volta stabilito il contratto con loro, contattate il supporto Infomaniak indicando le informazioni relative al vostro contratto ACPM e Infomaniak.

Per gestire l'attivazione o la disattivazione del servizio:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Fai clic sul nome del flusso audio interessato.
4. Clicca su Impostazioni nel menu laterale sinistro.
5. Attiva o disattiva l'esportazione dei log verso ACPM con l'interruttore a scorrimento (toggle switch):
   ‍

SpacialAudio SAM Cast è compatibile con l'offerta di streaming audio.

Questa guida spiega come mantenere il controllo sui tuoi flussi di Streaming Radio MP3/AAC o HLS attivando la protezione tramite chiave unica (token) per decidere, ad esempio, se un ascoltatore può ascoltare la tua radio o meno.

Premessa

• Il principio è semplice: ad ogni connessione, effettuerai una richiesta verso l'API Infomaniak che ti restituirà un token unico con una durata di vita limitata e parametrabile. Questo token autorizzerà chiunque lo possieda a consumare il flusso durante questo periodo.
• È possibile proteggere un flusso MP3/AAC o HLS indipendentemente l'uno dall'altro (stessa cosa per la geolocalizzazione).
• L'attivazione della restrizione comporta una modifica della configurazione del flusso che può richiedere alcuni minuti per essere replicata sui server.

Proteggere un flusso audio con una chiave univoca

Per farlo, basta andare nelle impostazioni delle restrizioni e attivare la protezione tramite token sul flusso che si desidera proteggere:

1. Clicca qui per accedere alla gestione del tuo prodotto su Manager Infomaniak (hai bisogno di aiuto?).
2. Clicca direttamente sul nome attribuito al prodotto interessato.
3. Fai clic sul nome del flusso audio interessato.
4. Clicca su Restrizioni nel menu laterale sinistro.
5. Scegliete HLS se necessario.
6. Clicca sul menu d'azione ⋮ situato a destra dell'elemento interessato.
7. Clicca su Restrizione per token:
   
    

Attiva quindi la protezione.

Attenzione, nel momento in cui attiverete questa opzione, l'accesso al flusso sarà istantaneamente bloccato per le nuove connessioni. Adattate i vostri player per tenere conto della restrizione, come illustrato nell'esempio qui sotto:

Creare un token API Radio

Per accedere all'API Radio, devi prima autenticarti utilizzando un token applicazione. Questa operazione va eseguita una sola volta. Per creare questo token applicazione, consulta questa guida.

L'ambito è radio e la durata di vita illimitata per evitare di dover rigenerare un codice in modo regolare. Una volta generato il token, copiarlo e incollarlo nell'esempio qui sotto.

Esempio di utilizzo in linguaggio PHP

Per MP3/AAC o HLS, il codice può essere sostanzialmente lo stesso, cambia solo l'URL chiamata in POST nella sua forma.

if (!defined('API_TOKEN')) {
     define('API_TOKEN', 'AYF5lSh3c7Xy5974Fs12RTkTThujT-L9R4Xk2ZfGyP6sV7QqJ1oC3jD8nFtKzIxUeMw5oNzR6');
}
/**
 * Fonction générique pour executer des requêtes cURL
 *
 * @param string $method Méthode HTTP (GET, POST, PUT, etc...)
 * @param string $url Url de l'api a requêter
 * @param array $headers Liste des en-têtes HTTP (l'autorisation doit être passée ici avec un ['Authorization: Bearer ']
 * @param array $payload Un tableau contenant les données pour créer un token
 * @return mixed
 */

function request(string $method, string $url, array $headers = [], array $payload = []): mixed{
    // prepare options array
    $opts = [
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_URL => $url,
        CURLOPT_CUSTOMREQUEST => strtoupper($method),
    ];

    // add payload if relevant
    if ($payload && $method !== 'GET') {
        $opts[CURLOPT_POSTFIELDS] = json_encode($payload);
    }
    $ch = curl_init();
    curl_setopt_array($ch, $opts);
    $result = curl_exec($ch);
    if(curl_errno($ch)){
        throw new Exception(curl_error($ch));
    }
    $data = json_decode($result, true);
    if ($data['result'] === 'error') {
        throw new Exception($data['error']['description'] ?? 'an error occured');

    }
    return $data['data'];
}

Creeremo il token, l'URL di creazione del token si compone come segue:

• Per un flusso MP3/AAC

POST https://api.infomaniak.com/1/radios/acl/streams/mountpoint.mp3/token

Esempio per proteggere https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac la rotta sarà: https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token

• Per un flusso HLS

POST https://api.infomaniak.com/1/radios/acl/hls_streams/<stream>/token

Esempio per proteggere https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8 la rotta sarà: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Esempio nel caso di MP3/AAC, assicurati di regolare:

$token = request(
    'POST',
   'https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token',
    // en-tête d'authorization
    [
        'Authorization: Bearer ' . API_TOKEN,
        'Content-Type: application/json',
    ],
    /**
     * payload pour créer le token, vous pouvez passer les valeurs suivantes
     * window     | 300               | optionnel | durée de validité du token (default: 5 minutes)
     */

    [
        'window' => 3600, // 1h validity
    ]
);

È importante notare che se questo codice viene generato al momento del caricamento della pagina, l'ascoltatore avrà "window" secondi per avviare la riproduzione del flusso. Oltre questo intervallo di tempo, il token scadrà e il flusso non potrà più essere avviato a meno che la pagina non venga ricaricata. A seconda delle vostre esigenze e del vostro caso d'uso, sarà necessario regolare questo intervallo nel miglior modo possibile.

Dovrete anche sostituire di seguito l'URL di riproduzione del vostro flusso al posto di quello indicato, mantenendo il parametro $token alla fine. Infine, visualizziamo il Player (qui una semplice etichetta html5, ma è possibile aggiungere qualsiasi sovrapposizione dopo, il token essendo passato nei parametri $_GET dell'url).

$streamUrl = "https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac?$token";
echo "<audio controls=""><source src="$streamUrl"></audio>";