Base di conoscenze

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 metadata (metadati) per il flusso radio inviato dal tuo encoder Streaming radio .

Utilizzare l'URL a disposizione

Basta fare un GET su un URL di tipo:

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

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

1. Clicca qui per accedere alla gestione del prodotto sul Manager Infomaniak (Hai bisogno di aiuto?).
2. Clicca direttamente sul nomeattribuito al prodotto in questione.
3. Fare clic sul nome del flusso audio in questione.
4. Clicca su Impostazioni nel menu laterale sinistro.
5. Fare clic sul pulsante per copia Il link delle metadata:
   

Per saperne di più

Per gli sviluppatori che codificano un Player, ci sono librerie che possono cercare le informazioni trasmesse e visualizzarle perché nei dati del feed i dati vengono trasmessi. L'altra possibilità è quella di recuperare le informazioni dal feed sul 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 rimuovere il prodotto completo.

Cancellare una radio

Per accedere al servizio Streaming ed eliminare uno dei feed:

1. Clicca qui per accedere alla gestione del prodotto sul Manager Infomaniak (Hai bisogno di aiuto?).
2. Clicca direttamente su il nomeattribuito al prodotto in esame:
   
3. Fare clic sul nome della radio in questione:
   
4. Clicca su il menu di azionesituato a destra dell'elemento interessato.
5. Clicca su Rimuovi:
   
6. Immettere il nome della radio per convalidare 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 prodotto sul Manager Infomaniak (Hai bisogno di aiuto?).
2. Clicca direttamente sul nomeattribuito al prodotto in questione.
3. Fare clic sul nome della radio.
4. Clicca sul pulsante Aggiungere un flusso:
   
5. poi una seconda volta sul pulsante Aggiungere un flusso:
   
6. Aggiungere un flusso standard:
   
7. Scegli le opzioni desiderate:
   
8. Clicca sul pulsante Salva.

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

In questo modo, se il flusso principale non è disponibile, il flusso di emergenza si rilascerà automaticamente dalla trasmissione.

Creare un flusso di emergenza

Per accedere al servizio di streaming radio:

1. Clicca qui per accedere alla gestione del prodotto sul Manager Infomaniak (Hai bisogno di aiuto?).
2. Clicca direttamente sul nomeattribuito al prodotto in questione.
3. Fare clic sul nome della radio.
4. Clicca sul pulsante Aggiungere un flusso per creare un nuovo flusso e unirgli un flusso di emergenza o Configurare un flusso esistente per attivare l'opzione:
   
5. Fare clic sul pulsante a failover (toggle switch) per attivare il flusso di emergenza sul flusso:
   
6. Copia le informazioni a tua disposizione per impostare il tuo encoder di emergenza.
7. Salvare l'attivazione del flusso di emergenza in basso a destra della pagina.

Nello stesso punto è possibile impostare il flusso di emergenza come un relè di flusso per inserire manualmente i parametri corrispondenti al flusso audio di emergenza:

Salvare le nuove informazioni in basso a destra della pagina.

Questa guida riguarda le informazioni di ascolto di Streaming Radio che possono essere esportati in ACPM (ex OJD digitale).

Preambolo

• L’ACPM, Alleanza per i Cifre 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, confronto e strutturazione delle loro strategie.
• Collocata sotto la governance delle sue istanze composte da professionisti dei media, l’ACPM garantisce trasparenza, indipendenza e rigore metodologico; assicura certificazioni affidabili e in linea con gli sviluppi del settore dei media.
• Prendi anche conoscenza di quest'altra guida 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, si prega di contattare questo servizio via e-mail:equipe-ojdnumerique@acpm.fr.
• Una volta stabilito il contratto con questi ultimi,Contatta il supporto Infomaniakindicando 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 prodotto sul Manager Infomaniak (Hai bisogno di aiuto?).
2. Clicca direttamente sul nomeattribuito al prodotto in questione.
3. Fare clic sul nome del flusso audio in questione.
4. Clicca su Impostazioni nel menu laterale sinistro.
5. Attivare o disattivare l'esportazione dei log in ACPM con il pulsante a failover (toggle switch):
   ‍

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

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

Preambolo

• Il principio è semplice: ad ogni connessione, effettuerai una richiesta all'API Infomaniak che ti restituirà in cambio un token unico con una durata limitata e parametrizzabile. Questo token permetterà a chiunque lo possiede di consumare il flusso durante questo periodo.
• È possibile proteggere un flusso MP3/AAC o HLS indipendentemente l'uno dall'altro (idem per la geolocalizzazione altrove).
• 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 chiave unica

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

1. Clicca qui per accedere alla gestione del prodotto sul Manager Infomaniak (Hai bisogno di aiuto?).
2. Clicca direttamente sul nomeattribuito al prodotto in questione.
3. Fare clic sul nome del flusso audio in questione.
4. Clicca su Restrizioni nel menu laterale sinistro.
5. Scegliere HLS se necessario.
6. Clicca sul menu di azione ⋮situato a destra dell'elemento interessato.
7. Clicca su Restrizioni per token:
   
    

Attivate quindi la protezione.

Attenzione, nel momento in cui si attiva questa opzione, l'accesso al feed verrà immediatamente bloccato per le nuove connessioni. Adatta i tuoi Player per tenere conto della restrizione, come illustrato nell'esempio seguente:

 

Creare un token API Radio

Per accedere all'API Radio, è necessario prima di tutto autenticarsi con un token applicazione. Questo passo deve essere fatto solo una volta. Per creare questo token di applicazione, leggere questa guida.

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

Esempio di utilizzo in linguaggio PHP

Per MP3/AAC o HLS, il codice può essere sostanzialmente lo stesso, solo l'URL chiamato in POST cambia 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 decompone 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 strada 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 strada sarà: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Esempio nel caso di MP3 / AAC, considera 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 feed. Dopo questo periodo, il token scadrà e il feed 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 tempo nel miglior modo possibile.

Dovrai anche sostituire di seguito l'URL di lettura del tuo feed al posto di quello indicato mantenendo l'impostazione $token Alla fine. Infine, viene visualizzato il Player (qui un semplice tag html5, ma naturalmente si può aggiungere qualsiasi strato superiore dopo che il token è passato nelle impostazioni $_GET dell'url).

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