Disponibilità delle metriche per piattaforma (API)

Quando richiedi analytics di streaming tramite l’API pubblica di LabelGrid e filtri per una singola piattaforma, la risposta ti indica se quella piattaforma riporta effettivamente la metrica richiesta. Questo consente alla tua integrazione di distinguere «ancora nessun dato» da «questa piattaforma non riporta mai questa metrica».

Il campo availability

Aggiungi un filtro per piattaforma a qualsiasi richiesta di analytics — ad esempio filter[platform]=SPOTIFY — e la risposta includerà un campo availability accanto al consueto data:

• available — la piattaforma riporta questa metrica; data viene popolato normalmente.
• not_available_for_platform — la piattaforma non riporta questa metrica. data viene restituito vuoto. È un comportamento previsto, non un errore.

Il campo availability compare solo quando filtri per una singola piattaforma. Le richieste senza filtro per piattaforma restituiscono data esattamente come prima, senza alcuna chiave availability.

La forma di data è invariata: availability viene aggiunto accanto, quindi le integrazioni esistenti continuano a funzionare senza modifiche.

Endpoint di metrica singola

Ogni endpoint di analytics singolo restituisce un unico valore availability di primo livello accanto al suo data:

{
  "availability": "not_available_for_platform",
  "data": []
}

L’endpoint di riepilogo analytics

L’endpoint /statistiche/summary restituisce più sezioni contemporaneamente. Porta con sé una mappa availability parallela con una voce per sezione, così puoi sapere quali sezioni riporta la piattaforma e quali tornano vuote:

{
  "availability": {
    "streams": "available",
    "listeners": "available",
    "streams_by_country": "available",
    "streams_by_gender": "available",
    "streams_by_age": "available",
    "saves": "not_available_for_platform"
  },
  "data": { }
}

Quali piattaforme riportano quali metriche

Piattaforma (filter[platform])	Metriche riportate
SPOTIFY	Tutte le metriche di analytics
APPLE_MUSIC (è accettato anche ITUNES)	Stream, ascoltatori, stream per paese, stream per genere e stream per età

Per Apple Music, qualsiasi metrica al di fuori di questo elenco restituisce not_available_for_platform con data vuoto. Spotify riporta ogni metrica di analytics.

Come gestirlo nella tua integrazione

• Leggi availability prima di trattare un data vuoto come «nessuna attività». Un risultato vuoto con not_available_for_platform significa che la piattaforma non riporta affatto quella metrica.
• Quando richiedi più metriche contemporaneamente tramite /statistiche/summary, controlla la chiave corrispondente nella mappa availability per ciascuna sezione.
• Se non filtri per piattaforma, non c’è alcun campo availability: la risposta è la vista combinata di tutte le piattaforme, esattamente come prima.

Correlati

• Panoramica dell’API — autenticazione, endpoint e il riferimento completo
• Analytics — la dashboard di analytics e cosa mostra ogni scheda