Metriklerin Platform Kullanılabilirliği (API)

LabelGrid herkese açık API’si üzerinden streaming analytics istediğinizde ve tek bir platforma göre filtrelediğinizde, yanıt size o platformun istediğiniz metriği gerçekten raporlayıp raporlamadığını bildirir. Bu, entegrasyonunuzun “henüz veri yok” ile “bu platform bu metriği hiç raporlamaz” arasında ayrım yapmasını sağlar.

availability alanı

Herhangi bir analytics isteğine bir platform filtresi ekleyin — örneğin filter[platform]=SPOTIFY — ve yanıt, her zamanki data alanının yanında bir availability alanı içerir:

• available — platform bu metriği raporlar; data normal şekilde doldurulur.
• not_available_for_platform — platform bu metriği raporlamaz. data boş döner. Bu beklenen bir davranıştır, hata değildir.

availability alanı yalnızca tek bir platforma göre filtrelediğinizde görünür. Platform filtresi olmayan istekler, data alanını tam olarak eskisi gibi, herhangi bir availability anahtarı olmadan döndürür.

data alanının biçimi değişmez — availability onun yanına eklenir, böylece mevcut entegrasyonlar değişiklik yapılmadan çalışmaya devam eder.

Tekil metrik uç noktaları

Her bağımsız analytics uç noktası, data alanının yanında üst düzey tek bir availability değeri döndürür:

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

Analytics özet uç noktası

/analizler/summary uç noktası birden çok bölümü aynı anda döndürür. Her bölüm için bir girdi içeren paralel bir availability haritası taşır, böylece platformun hangi bölümleri raporladığını ve hangilerinin boş döndüğünü görebilirsiniz:

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

Hangi platform hangi metrikleri raporlar

Platform (filter[platform])	Raporlanan metrikler
SPOTIFY	Tüm analytics metrikleri
APPLE_MUSIC (ITUNES de kabul edilir)	Stream’ler, dinleyiciler, ülkeye göre stream’ler, cinsiyete göre stream’ler ve yaşa göre stream’ler

Apple Music için bu listenin dışındaki her metrik, boş data ile not_available_for_platform döndürür. Spotify her analytics metriğini raporlar.

Entegrasyonunuzda bunu nasıl ele alırsınız

• Boş bir data alanını “etkinlik yok” olarak yorumlamadan önce availability alanını okuyun. not_available_for_platform ile gelen boş bir sonuç, platformun o metriği hiç raporlamadığı anlamına gelir.
• /analizler/summary aracılığıyla aynı anda birden çok metrik istediğinizde, her bölüm için availability haritasındaki ilgili anahtarı kontrol edin.
• Platforma göre filtrelemezseniz availability alanı yoktur — yanıt, tüm platformların birleşik görünümüdür, tam olarak eskisi gibi.

İlgili

• API’ye Genel Bakış — kimlik doğrulama, uç noktalar ve tam referans
• Analytics — analytics panosu ve her sekmenin gösterdikleri