Disponibilité des métriques par plateforme (API)

Lorsque vous demandez des analytiques de streaming via l’API publique de LabelGrid et que vous filtrez par une seule plateforme, la réponse vous indique si cette plateforme rapporte réellement la métrique demandée. Cela permet à votre intégration de distinguer « pas encore de données » de « cette plateforme ne rapporte jamais cette métrique ».

Le champ availability

Ajoutez un filtre de plateforme à n’importe quelle requête d’analytiques — par exemple filter[platform]=SPOTIFY — et la réponse inclura un champ availability à côté du data habituel :

• available — la plateforme rapporte cette métrique ; data est renseigné normalement.
• not_available_for_platform — la plateforme ne rapporte pas cette métrique. data est renvoyé vide. C’est un comportement attendu, pas une erreur.

Le champ availability n’apparaît que lorsque vous filtrez par une seule plateforme. Les requêtes sans filtre de plateforme renvoient data exactement comme avant, sans clé availability.

La forme de data est inchangée — availability est ajouté à côté, de sorte que les intégrations existantes continuent de fonctionner sans modification.

Endpoints de métrique individuelle

Chaque endpoint d’analytiques individuel renvoie une seule valeur availability de premier niveau à côté de son data :

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

L’endpoint de résumé des analytiques

L’endpoint /statistiques/summary renvoie plusieurs sections à la fois. Il porte une table availability parallèle avec une entrée par section, afin que vous puissiez savoir quelles sections la plateforme rapporte et lesquelles reviennent vides :

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

Quelles plateformes rapportent quelles métriques

Plateforme (filter[platform])	Métriques rapportées
SPOTIFY	Toutes les métriques d’analytiques
APPLE_MUSIC (ITUNES est également accepté)	Streams, auditeurs, streams par pays, streams par genre et streams par âge

Pour Apple Music, toute métrique en dehors de cette liste renvoie not_available_for_platform avec un data vide. Spotify rapporte chaque métrique d’analytiques.

Comment le gérer dans votre intégration

• Lisez availability avant de traiter un data vide comme « aucune activité ». Un résultat vide avec not_available_for_platform signifie que la plateforme ne rapporte pas du tout cette métrique.
• Lorsque vous demandez plusieurs métriques à la fois via /statistiques/summary, vérifiez la clé correspondante dans la table availability pour chaque section.
• Si vous ne filtrez pas par plateforme, il n’y a pas de champ availability — la réponse est la vue combinée de toutes les plateformes, exactement comme avant.

Associé

• Aperçu de l’API — authentification, endpoints et la référence complète
• Analytiques — le tableau de bord d’analytiques et ce que montre chaque onglet