Boş bir grafik ile sıfırlarla dolu bir grafik iki ayrı şey anlatır ve bunlardan yalnızca biri doğru olabilir. Boomplay dinlenmeleri ve ülke bazında dinlenmeleri bildirir. Kaydetme verisi bildirmez. Bu yüzden Boomplay için hazırlanan bir kaydetme grafiği, sıfırda düz bir çizgi çizip kimsenin parçayı kaydetmediğini düşündürmek yerine, mağazanın bu veriyi bildirmediğini söylemelidir.
Temmuzda yayına aldığımız analitik güncellemesi baştan sona bu ayrım üzerine kurulu. LabelGrid analitiği artık bize analitik veri akışı gönderen her mağazayı kapsıyor: Spotify, Apple Music, Deezer, Audiomack, Boomplay, AWA ve üç Tencent servisi olan Kugou, Kuwo ve QQ Music. Kataloğunuz çevresindeki sosyal ve UGC hareketliliği de bunların yanında duruyor: SoundCloud'dan Snapchat'e ve Meta uygulamalarına kadar. Dinlenme tarafına artık herkese açık API ve açık kaynaklı MCP sunucusu üzerinden programatik olarak da erişebilirsiniz.
Veri bildiren mağazalar ve her birinin neyi bildirdiği
Dağıtım bu listeden daha geniş bir alana ulaşıyor. Buradakiler, analitik veri akışlarını işlediğimiz mağazalar ve aradaki farkı bilmek işe yarar: bir mağaza analitik akışı yayımlasın ya da yayımlamasın, oradaki hareket telif raporlarınıza yansır, çünkü telif raporları ile analitik birbirinden ayrı hatlarda ilerler.
| Mağaza | Sıklık | Bildirdiği veriler |
|---|---|---|
| Spotify | Günlük | En kapsamlı veri seti: dinlenme, dinleyici, kaydetme, atlama, paylaşım, etkileşim oranları, dinlenme kaynakları, cihazlar, demografik veriler |
| Apple Music | Günlük | Dinlenme, dinleyici, kitaplığa eklemeler, editoryal çalma listesi eklemeleri, Shazam sayısı, ayrıca şehir ve ülke mağazası bazında kırılımlar |
| Deezer | Günlük | Dinlenme, coğrafya, cihazlar, dinleyici demografisi, ortalama dinleme süresi, yerleşimler |
| Audiomack | Günlük | Dinlenme, dinleyici, kaydetme, coğrafya |
| Boomplay | Günlük | Dinlenme, ülke bazında dinlenme |
| AWA | Günlük | Dinlenme |
| Kugou, Kuwo, QQ Music | Haftalık | Dinlenme |
Asıl mesaj tablonun biçiminde saklı. Atlama, paylaşım, dinlenme kaynağı, günün saati ve ses formatı yalnızca Spotify'dan geliyor. Shazam sayıları, kitaplığa eklemeler ve editoryal çalma listesi eklemeleri yalnızca Apple Music'ten geliyor, çünkü Shazam bir Apple sinyali ve başka hiçbir yerde karşılığı yok. Oynatmaları değil kişileri sayan dinleyici demografisi Spotify ve Deezer'dan geliyor. Ülke bazında dinlenme Spotify, Apple Music, Deezer, Boomplay ve Audiomack'i kapsıyor; AWA bunun dışında kalıyor, çünkü AWA'nın akışında ISO ülke kodları yerine Japonya'nın kendi iç bölge kodları var. Bunların hiçbirini ezberlemeniz gerekmiyor: gösterge paneli her mağazanın neyi desteklediğini gösteriyor, API de aynı matrisi veri olarak yayımlıyor.
Çalma listesi yerleşimleri de aynı mantıkla işliyor. Spotify satırlarında çalma listesinin adı ve sahibi, dinlenme sayılarıyla birlikte yer alıyor. Apple Music satırlarında editoryal çalma listeleri adlarıyla ve parçanın ulaştığı en iyi sırayla geliyor; bu satırların bir kısmında hiç oynatma sayısı bulunmuyor ve bu durum “bildirilmedi” olarak gösteriliyor. Deezer satırları, id çözümlenebildiğinde herkese açık çalma listesine bağlantı veriyor.
Mağazaları birleştirin, karşılaştırın ya da tek tek inceleyin
Bu verilerle yapılanların çoğunu üç görünüm modu karşılıyor. Birleşik görünüm tüm mağazaları tek bir rakamda toplar. Karşılaştırma modu mağazaları yan yana koyar; tümünü karşılaştırma ise yeni eklenen mağazaları kendiliğinden dahil eder, yani yeni bir mağazayı mevcut bir karşılaştırmaya elle eklemeniz gerekmez. Tekli görünüm sizi tek bir mağazanın tüm ayrıntısına götürür. Grafikler gün, hafta ya da ay bazında, isterseniz otomatik ayrıntı düzeyiyle çalışır. En iyi performans gösterenler her metrik için ayrı sekmelerde durur, yerleşimlerde ise mağaza bazlı bir filtre var.
Tencent mağazalarından haftada bir veri noktası
Kugou, Kuwo ve QQ Music haftalık veri bildirir. Her hafta parça başına tek bir veri noktası gelir; bu nokta raporun kapsadığı güne tarihlenir ve haftanın tamamını taşır. Haftalık toplamı asla uydurma günlük değerlere bölmeyiz. Bu yüzden günlük bir grafikte bu üç mağaza haftada yalnızca bir dolu tarih gösterir, arada boşluklar kalır.
Bu boşluklar eksiklik değil, doğrudur. Aralık toplamları yine tutar; raporlama sıklığı gösterge panelinde ve API yanıtında belirtilir, böylece bir entegrasyon haftalık bildirim yapan mağazayı sessiz bir mağazadan ayırt edebilir.
Bir metrik “mevcut değil” dediğinde
Gösterge panelinde, bir mağazanın bildirmediği metrik platform bazında böyle etiketlenir; API'de ise kullanılabilirlik matrisi ilgili hücreyi sıfır serisi yerine not_available_for_platform olarak döndürür. En çarpıcı örnek yerleşimler görünümünde: bir Apple Music editoryal satırı, yanında hiçbir oynatma sayısı olmadan çalma listesinin adını ve parçanın ulaştığı sırayı gösterebilir. Bu, bildirilmedi demektir. Bunu sıfıra çevirdiğinizde rakamın anlamı değişir ve o rakamdan hesaplanan her ortalamanın altına yapay bir taban koymuş olursunuz.
Gizlilik eşikleri aynı mantıkla, ters yönden çalışır. Demografik ve coğrafi kırılımlar k-anonimleştirilir: asgari dinleyici kitlesi eşiğinin altında kalan hücreler tümüyle çıkarılır, başka bir kategoriye aktarılmaz ve bastırılan rakamın hesaplanmasına imkân verecek hiçbir toplam yayımlanmaz. Küçük bir katalog bunu çoğunlukla ilk olarak Apple şehir kırılımlarında ve şehir bazlı Shazam verilerinde fark eder: dinlenmeler sağlıklı, şehir grafiği boş. Bu tasarım gereğidir ve aşmanın bir yolu yoktur, çünkü alternatifi, kimliği belirlenebilecek bir avuç dinleyici hakkında bilgi yayımlamak olurdu.
Rakamlar ne kadar güncel ve neden değişiyor
Mağazalar verileri gecikmeli bildirir ve farklı veri akışları farklı takvimlerle yayımlanır; bu yüzden herhangi bir günde bir metrik, diğerinden daha ileri bir tarihe kadar güncel olabilir. Bu nedenle her metrik iki tarih taşır: veri bulunan en son tarih olan rapor edilen son tarih ve kesinleşmiş sayılabilecek en son tarih olan kesinleşen son tarih. İkisi arasında kalan tarihler hâlâ dolmaya devam eder. Gösterge paneli bu aralıkları kısmi olarak işaretler, böylece yarım bildirilmiş bir gün çöküş gibi görünmez. Bir grafiğe tekrar baktığınızda son kısmın yükselmesini bekleyin. Grafiğin rapor edilen son tarihte kesilmesi, mağazanın daha sonraki tarihleri henüz bildirmediği anlamına gelir.
Geçmiş verinin derinliği de veri akışlarına göre ayrışır. Spotify ve Apple Music yıllar öncesine uzanır. Bu güncellemeyle eklenen mağazaların (Deezer, Boomplay, AWA, Audiomack ve üç Tencent servisi) geçmişi ise veri akışlarının gelmeye başladığı tarihte, yaklaşık 2026 Ocak sonunda başlar.
Kataloğunuz çevresindeki sosyal ve UGC hareketliliği
Sosyal platform verileri, insanların müziğinizle DSP'lerin dışında neler yaptığını izler ve her platform kendi kesitini bildirir:
- SoundCloud dinlenmeleri, ayrıca yeniden paylaşımlar ve favoriler, bunların geldiği bölgelerle birlikte
- Snapchat içerik oluşturma sayısı (yani müziğin kaç kez kullanıldığı), ayrıca bölgeye göre görüntüleme ve erişim
- Instagram ve Facebook'ta bölgeye göre içerik oluşturma ve görüntüleme, ayrıca sanatçı hesabındaki takipçi ve etkileşim artışı
- WhatsApp ve Messenger'da bölgeye göre içerik oluşturma ve görüntüleme; arkasında bir hesap akışı yok
- Threads için yalnızca görüntüleme ve erişim, çünkü akışı içerik oluşturmayı değil tüketimi bildiriyor
Bunlar, kendi veri akışları ve kendi platform ekseniyle dinlenme verisinden ayrı bir küme oluşturur ve ayrı kalır: bir UGC görüntülemesi ya da içerik oluşturma hiçbir zaman DSP dinlenme toplamına karışmaz. Yalnızca gösterge panelinde yer alırlar ve herkese açık API'de bilerek sunulmazlar; dolayısıyla /analytics/* okuyan bir entegrasyon orada SoundCloud ya da Meta rakamlarını asla bulamaz.
37 bölüm anahtarı ve hepsinin haritasını veren tek bir uç nokta
Dinlenme verileri herkese açık API'de yer alır, yalnızca kendi etiketlerinizi kapsar ve tanımlayıcı alanında anahtar olarak ISRC kullanılır. GET /analytics/summary bileşik uç noktadır: zorunlu metrics[] parametresiyle 37 bölüm anahtarından bir ila on iki tanesini seçersiniz. Parametreyi atlarsanız bilerek 422 döner; on ikiden fazlasını içeren bir seçim de reddedilir, bu durumda seçimi birbirinden bağımsız önbelleğe alınan birkaç isteğe bölersiniz. On beş bağımsız uç nokta ayrı serileri kapsar: dinlenme ve dinleyici sayısından kaydetme, atlama, tamamlanma oranı, cihaz dağılımı ve kaynak dağılımına kadar, ayrıca demografik ve coğrafi kesitler. Liderlik tabloları etikete, sanatçıya, yayına ya da parçaya göre filtrelenmiş ilk N sıralamasını verir; yerleşimler ise platforma göre filtrelenebilir.
GET /api/public/analytics/summary
?metrics[]=streams
&metrics[]=listeners
&metrics[]=streams-by-country
&filter[platform]=SPOTIFY
&filter[start_date]=2026-01-01
&filter[end_date]=2026-07-01filter[platform] SPOTIFY, APPLE_MUSIC, DEEZER, BOOMPLAY, AWA, AUDIOMACK, KUGOU, KUWO ve QQMUSIC değerlerini alır; parametre atlanırsa hesabınızda verisi olan tüm platformlar döndürülür. Her özet yanıtı, platformun raporlama sıklığını meta.platform_cadence içinde, her bölüm için de iki güncellik tarihini meta.sections_as_of ve meta.sections_complete_through olarak taşır. Böylece istemci, hâlâ dolmakta olan tarihleri geçici veri olarak gösterip dönem toplamlarının dışında tutabilir.
Özet ve on beş seri uç noktasında aralık 400 güne kadar çıkar; bu, tek çağrıda tam bir yıl artı bir karşılaştırma dönemi demektir. Liderlik tabloları ve yerleşimler 180 günde kalır, çünkü daha uzun bir dönemin sıralaması daha kısa pencerelerden dürüstçe birleştirilemez. 90 günden uzun aralıklar için yapılan istekler, standart analitik limitinin üstüne ikinci ve daha sıkı bir hız limiti havuzuna da yazılır; 90 gün ve altındaki istekler bundan etkilenmez.
Yukarıdaki mağaza ayrıntılarından herhangi birini koda gömmeden önce GET /analytics/availability çağrısını yapın. Parametre almaz, statiktir, önbelleğe alınabilir ve bölüm-platform matrisinin tamamını raporlama sıklığı haritasıyla birlikte tek yanıtta verir. Uygulamanızı buna göre kurarsanız akışa yeni bir mağazanın girmesi bir kod değişikliği değil, yalnızca bir veri değişikliği olur.
Ya da asistanınıza sorun
LabelGrid MCP sunucusu, aynı herkese açık API'nin üzerinde ince, tip tanımlı bir sarmalayıcıdır. Bu sayede Claude Desktop, Claude Code ya da Cursor gibi herhangi bir Model Context Protocol istemcisi kataloğunuzun performansını doğrudan okuyabilir. “Geçen ay Almanya'da hangi parçalarım yükseldi, hangi mağazada” sorusu, dört ayrı dışa aktarımı karşılaştırmak yerine sorduğunuz bir soruya dönüşür. Sarmalayıcı yukarıdaki her şeyi devralır: kullanılabilirlik kurallarını, haftalık sıklığı ve güncellik tarihlerini. Eksikleri de devralır; sosyal rakamlar API'de olmadığı için orada da yoktur. Kurulumu ve izin modelini MCP lansman yazısında bulabilirsiniz.
Hepsi şu anda gösterge panelinde kullanıma açık. Analitik, gelişmiş set de dahil, her standart planda yer alır; API ve MCP erişimi LabelGrid'in API planlarında sunulur. Mağaza bazında ayrıntılar analitik sayfasında, hangi planın neyi kapsadığı fiyatlandırma sayfasında yer alıyor.
