Plattformstillgänglighet för mätvärden (API)

När du begär streaming-analytics via LabelGrids publika API och filtrerar på en enda plattform talar svaret om ifall den plattformen faktiskt rapporterar det mätvärde du bad om. Det låter din integration skilja mellan “inga data ännu” och “den här plattformen rapporterar aldrig det här mätvärdet”.

Fältet availability

Lägg till ett plattformsfilter i valfri analytics-begäran — till exempel filter[platform]=SPOTIFY — så innehåller svaret ett fält availability bredvid det vanliga data:

• available — plattformen rapporterar det här mätvärdet; data fylls i som vanligt.
• not_available_for_platform — plattformen rapporterar inte det här mätvärdet. data returneras tomt. Det är förväntat beteende, inte ett fel.

Fältet availability visas endast när du filtrerar på en enda plattform. Begäranden utan plattformsfilter returnerar data precis som förut, utan någon availability-nyckel.

Formen på data är oförändrad — availability läggs till bredvid, så befintliga integrationer fortsätter fungera utan ändring.

Endpoints för enskilda mätvärden

Varje fristående analytics-endpoint returnerar ett enda availability-värde på toppnivå bredvid sitt data:

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

Endpointen för analytics-sammanfattning

Endpointen /analys/summary returnerar flera sektioner samtidigt. Den bär med sig en parallell availability-karta med en post per sektion, så att du kan se vilka sektioner plattformen rapporterar och vilka som kommer tillbaka tomma:

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

Vilken plattform rapporterar vilka mätvärden

Plattform (filter[platform])	Rapporterade mätvärden
SPOTIFY	Alla analytics-mätvärden
APPLE_MUSIC (ITUNES accepteras också)	Streams, lyssnare, streams per land, streams per kön och streams per ålder

För Apple Music returnerar varje mätvärde utanför den listan not_available_for_platform med tomt data. Spotify rapporterar varje analytics-mätvärde.

Så hanterar du det i din integration

• Läs availability innan du tolkar ett tomt data som “ingen aktivitet”. Ett tomt resultat med not_available_for_platform betyder att plattformen inte rapporterar det mätvärdet alls.
• När du begär flera mätvärden samtidigt via /analys/summary, kontrollera motsvarande nyckel i availability-kartan för varje sektion.
• Om du inte filtrerar på plattform finns inget availability-fält — svaret är den kombinerade vyn över alla plattformar, precis som förut.

Relaterat

• API-översikt — autentisering, endpoints och den fullständiga referensen
• Analytics — analytics-panelen och vad varje flik visar