Bu sayfada, kanal sahiplerinin YouTube Analytics API ile alabilecekleri raporlar listelenmektedir. Kanal raporları, belirli bir kanal için kullanıcı etkinliği metriklerini sağlar ve video görüntüleme sayısı, derecelendirmeler ve abonelik sayıları gibi unsurları ölçer.
Video raporları, bir kanalın videolarıyla ilgili tüm kullanıcı etkinliklerine ilişkin istatistikleri sağlar.
Oynatma listesi raporları, özellikle bir oynatma listesi bağlamında gerçekleşen video görüntülemeleriyle ilgili istatistikler sağlar.
Reklam performansı raporları, gelir ve reklam performansıyla ilgili metrikleri içerir. Metrikleri video oynatmaları sırasında yayınlanan reklam türlerine göre gruplandırmak için adType boyutunu kullanırlar. Reklam performansı raporları bölümünde, API'nin desteklediği iki tür reklam performansı metriği açıklanmaktadır.
Rapor alma
Bir kanal raporu almak için API isteğinizdeki ids parametre değerini aşağıdaki değerlerden birine ayarlamanız gerekir:
channel==MINE: API, kimliği doğrulanmış kullanıcının YouTube kanalına ait verileri döndürür.
channel==CHANNEL_ID – CHANNEL_ID öğesini, verilerini aldığınız kanalın benzersiz kanal kimliğine ayarlayın. İsteği yetkilendiren kullanıcı, kanalın sahibi olmalıdır.
Kanal kimliği şu anda UC harfleriyle başlayan bir dizedir ancak biçimi değişebilir. (Kanalınızın kimliğini YouTube kanalınızın gelişmiş hesap ayarları sayfasında bulabilir veya YouTube Data API'schannels.list yöntemini kullanarak programatik olarak kanal kimliğini alabilirsiniz.)
Yetkilendirme
Tüm YouTube Analytics API istekleri yetkilendirilmelidir. Yetkilendirme kılavuzu, yetkilendirme jetonlarını almak için OAuth 2.0 protokolünün nasıl kullanılacağını açıklar.
YouTube Analytics API istekleri aşağıdaki yetkilendirme kapsamlarını kullanır:
YouTube içeriğinize ilişkin YouTube Analytics raporlarını görüntüleyin. Bu kapsam, görüntüleme sayısı ve puan sayısı gibi kullanıcı etkinliği metriklerine erişim sağlar.
YouTube içeriğinize ilişkin YouTube Analytics mali raporlarını görüntüleyin. Bu kapsam, kullanıcı etkinliği metriklerinin yanı sıra tahmini gelir ve reklam performansı metriklerine erişim sağlar.
https://www.googleapis.com/auth/youtube
YouTube hesabınızı yönetin. Kanal sahipleri, YouTube Analytics API'de YouTube Analytics gruplarını ve grup öğelerini yönetmek için bu kapsamı kullanır.
https://www.googleapis.com/auth/youtubepartner
YouTube öğelerini ve YouTube'daki ilişkili içeriği görüntüleyin ve yönetin. İçerik sahipleri, YouTube Analytics API'de YouTube Analytics gruplarını ve grup öğelerini yönetmek için bu kapsamı kullanır.
Not: Tahmini gelir ve reklam performansı metrikleri şu anda kanal raporları için desteklenmemektedir. Dolayısıyla, https://www.googleapis.com/auth/yt-analytics-monetary.readonly kapsamı şu anda bu raporlardaki parasal verilere erişim izni vermez.
Filtreler
Desteklenen raporları açıklayan tablolar, her bir rapor için kullanılabilecek filtreleri tanımlar. Tablolarda parantez içinde gösterilen filtreler isteğe bağlıdır. Örneğin, video(,country) filtreleme seçeneği için video filtresi zorunlu, ülke filtresi ise isteğe bağlıdır.
API, video ve playlist filtreleri için birden fazla değer belirtme özelliğini de destekler. Bu filtrelerden biri için birden çok değer belirtirseniz o filtreyi istek için belirttiğiniz boyutlar listesine de ekleyebilirsiniz. Bu, filtre belirli bir rapor için desteklenen boyut olarak listelenmemiş olsa bile geçerlidir.
Belirli bir değer veya değer grubu için API sonuçlarını nasıl filtreleyeceğinize dair kapsamlı bir açıklama için filters parametre tanımına bakın.
Rapor tablolarını anlama
Bu bölümde, API'nin desteklediği raporları tanımlayan tablolarda kullanılan biçimlendirme ve terminoloji açıklanmaktadır. Aşağıdaki tabloda zaman boyutu ve averageViewPercentage metriğini kullanan oynatma ayrıntıları video raporu için desteklenen boyutlar, metrikler ve filtreler listelenmektedir.
Tablo, boyutlar için iki satır, metrikler için bir satır ve filtreler için üç satır içerir. Boyutlar ve filtreler için, her bir satırdaki değerler, kombinasyon tablodaki kullanım kurallarına uygun olduğu sürece bir API isteğinde birleştirilebilir. Dolayısıyla, örneğin, bu rapor için geçerli dimensions parametre değerleri şunlardır:
dimensions=day
dimensions=day,liveOrOnDemand
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
Bununla birlikte, day,month parametre değeri zamana dayalı iki boyut kullandığından geçersizdir ancak istek 0 veya 1 değerini kullanabilir. Bu durumda, subscribedStatus,youtubeProduct parametre değeri aslında bir rapor döndürmez. Ancak metrikler gün, hafta, ay gibi ölçütlere göre toplanmaz (Bu rapor, belgelerde ayrı olarak belgelenmiştir.)
Rapor tablosu terminolojisi
Tablolar, boyutların gerekli mi yoksa isteğe bağlı mı olduğunu belirtmek için aşağıdaki terminolojiyi kullanır:
Bu terimler, bir değerin gerekli olduğu anlamına gelir:
Zorunlu: Değeri eklemeniz gerekir.
Tam olarak 1 değerini kullanın: Gruptan bir değer eklemeniz gerekir.
1 veya daha fazla değer kullanın: Gruptaki herhangi bir değeri veya tüm değerleri dahil edebilirsiniz ancak en az bir değer eklemeniz gerekir.
Bu terimler, değerin isteğe bağlı olduğu anlamına gelir:
İsteğe bağlı: Değeri dahil edebilirsiniz.
0 veya 1 kullanın: Gruptan bir değer ekleme seçeneğiniz vardır.
0 veya daha fazlasını kullan: Gruptaki değerlerden birini veya tümünü dahil edebilirsiniz.
Video raporları
Temel istatistikler
Temel kullanıcı etkinliği istatistikleri
Bu rapor, kullanıcıların bir kanaldaki işlemlerine ilişkin istatistikler sağlar. Raporu, yalnızca belirli bir video veya ülke için veri döndürecek şekilde filtreleyebilirsiniz.
ABD eyaletleri için temel kullanıcı etkinliği istatistikleri
Bu rapor, belirli bir ABD eyaleti veya District of Columbia ile ilgili istatistikler sağlar. Bu raporun yalnızca yukarıda açıklanan ülkeye özel raporda bulunan metriklerin bir alt kümesini desteklediğini unutmayın.
Belirli dönemlerde ülkeye göre kullanıcı etkinliği
Bu rapor, belirli zaman aralıklarında bir kanaldaki kullanıcı işlemleriyle ilgili istatistikler sağlar. Raporu, yalnızca belirli bir video veya ülke için veri döndürecek şekilde filtreleyebilirsiniz.
Belirli dönemler için ABD eyaletlerindeki kullanıcı etkinliği
Bu rapor, belirli bir ABD eyaleti veya District of Columbia'daki kullanıcı etkinliğiyle ilgili istatistikler sağlar. Bu raporun yalnızca yukarıda açıklanan ülkeye özel raporda bulunan metriklerin bir alt kümesini desteklediğini unutmayın.
Bu rapor, bir kanal için ülke bazında kullanıcı etkinliğiyle ilgili istatistikler sağlar. Raporu, yalnızca belirli bir videoya ilişkin verileri döndürecek şekilde filtreleyebilirsiniz.
Bu rapor, ABD eyaletleri ve District of Columbia için kullanıcı etkinliği istatistiklerini sağlar. Bu rapor için filters parametre değerini country==US olarak ayarlamanız gerekir.
Not: Bu rapor, maxResults parametresini 250 veya daha küçük bir tam sayı olarak ayarlamanızı gerektirir. Diğer raporların çoğundan farklı olarak bu rapor, sort istek parametresi için bir değer belirtmenizi de gerektirir.
Bu rapor, şehre göre kullanıcı etkinliği istatistiklerini sağlar.
Bu rapor, abone olan ve olmayan izleyiciler için kullanıcı etkinliği metriklerini sağlar. İstatistikler döneme (gün veya ay) göre gruplandırılabilir ve rapor, ülke, kıta veya subContinent'ya göre de filtrelenebilir.
Eyaletler için abone olma durumuna göre kullanıcı etkinliği
Bu rapor, ABD eyaletleri veya District of Columbia'daki abone olan ve abone olmayan izleyiciler için kullanıcı etkinliği metriklerini sağlar. Bu rapor, önceki rapora göre daha az metriği destekliyor.
İsteğe bağlı zaman boyutu bulunan oynatma ayrıntıları
Zaman boyutu (gün veya ay), raporun kapsayacağı tarih aralığını belirtmek için startDate ve endDate istek parametrelerini kullanmanız gerektiğinden bağımsız olarak bu raporlar için isteğe bağlıdır. Bu boyut (mevcutsa) rapordaki verilerin güne, aya vb. göre toplanmasını istediğinizi belirtir.
İsteğe bağlı zaman boyutu ve liveOrOnDemand istatistikleriyle oynatma ayrıntıları
Bu rapor, belirli zaman aralıkları için oynatma ayrıntıları istatistikleri sağlar. liveOrOnDemand boyutunu (ve filtresini) destekler.
Not: Bu rapor, maxResults parametresini 25 veya daha küçük bir tam sayı olarak ayarlamanızı gerektirir. Diğer raporların çoğundan farklı olarak bu rapor, sort istek parametresi için bir değer belirtmenizi de gerektirir.
Bu rapor, bir kanalın videoları için en çok görüntüleme veya görüntüleme süresi sağlayan yerleşik video oynatıcıları tanımlar.
Bu rapor, izleyicilerin video içeriğinize ulaşma şekline göre görüntüleme istatistiklerini toplar. Örneğin, bir Google aramasından veya ilgili bir videonun bağlantısından kaynaklanan görüntüleme sayısını tanımlar.
Not: Bu rapor, maxResults parametresini 25 veya daha küçük bir tam sayı olarak ayarlamanızı gerektirir. Diğer raporların çoğundan farklı olarak bu rapor, sort istek parametresi için bir değer belirtmenizi de gerektirir.
Bu rapor, kanal içeriğinin en çok görüntülenmesini sağlayan yönlendirenlere dayalı olarak görüntüleme istatistiklerini toplar. Yönlendirenler, trafik kaynağı türüne göre sınıflandırılır ve insightTrafficSourceDetail boyutunun tanımı, raporun kullanılabildiği trafik kaynaklarını tanımlar. Örneğin, insightTrafficSourceType filtresini ADVERTISING olarak ayarlarsanız raporda, kanal içerikleri için en çok görüntüleme sağlayan reklam türleri veya görüntüleme süresi listelenir.
Not: Bu rapor yalnızca belirli trafik kaynakları için desteklenir. Örneğin, NO_LINK_EMBEDDED trafik kaynağında ek ayrıntılar bulunmadığından bu raporu desteklemez. Bu raporu destekleyen trafik kaynaklarıyla ilgili ayrıntılar için insightTrafficSourceType tanımına bakın.
Cihaz türü ve işletim sistemi
Cihaz türü
Bu rapor, izleyicilerin video içeriğinize ulaşma şekline göre görüntüleme istatistiklerini toplar. Örneğin, mobil cihazlarda veya oyun konsollarında gerçekleşen görüntülemelerin sayısını tanımlar.
Bu rapor, izleyicilerin işletim sistemlerine göre görüntüleme istatistiklerini toplar. Örneğin, Android cihazlarda veya PlayStation'larda gerçekleşen görüntülemelerin sayısını tanımlar.
Bu rapor, izleyicilerin işletim sistemlerine ve cihaz türlerine göre görüntüleme istatistiklerini toplar. Örneğin, Android tabletlerde veya Windows masaüstü cihazlarda gerçekleşen görüntülemelerin sayısını tanımlar.
Not: Bu rapordaki viewerPercentage değerleri, oynatma ayrıntısı boyutlarına ait farklı değerler veya değer kombinasyonları için farklı değerler veya değer kombinasyonları için normalleştirilmez (subscribedStatus, liveOrOnDemand veya youtubeProduct).
Örneğin, subscribedStatus boyutunu kullanan bir rapor, viewerPercentage verileri 10'a kadar olan görüntülemeler için yüzdeye varan görüntüleme yüzdesi'ne %10}'a kadar abonelikten çıkan görüntülemeler'e % kadar %10}viewerPercentage (Rapordaki tüm viewerPercentage alanlarının toplam değeri yüzde 200'dür.)
Oynatma ayrıntısı boyutları için raporun yalnızca bir değere (veya değer kombinasyonuna) ilişkin viewerPercentage verilerini içerdiğinden emin olmak için filtreleri kullanabilirsiniz.
Etkileşim ve içerik paylaşımı
Bu rapor, kanalın videolarının farklı sosyal platformlarda ne sıklıkta paylaşıldığını gösteren istatistikler sağlar.
Bu rapor, bir videonun kitlesini elde tutma becerisini ölçer. elapsedVideoTimeRatio boyutu, ilgili metrik değerleri için geçen video miktarını ölçer. audienceWatchRatio ve relativeRetentionPerformance metrikleri, videonun kitleyi elde tutma konusunda ne kadar başarılı olduğunu gösteren iki ölçüm sağlar. Birincisi mutlak bir değerdir, ikincisi ise videonun benzer uzunluktaki diğer YouTube videolarına kıyasla nasıl performans gösterdiğini belirtir.
Not: Kitleyi elde tutma raporları, video filtresi için değerlerin virgülle ayrılmış listesini belirtme özelliğini desteklemez; değer, tek bir video kimliği belirtmelidir.
Not: Bu raporlar, maxResults parametresini 200 veya daha küçük bir tam sayı değerine ayarlamanızı gerektirir. 1 Ocak 2013 tarihinden önceki veriler yalnızca en popüler 10 videoya ilişkin mevcuttur. Diğer raporların çoğundan farklı olarak bu raporlar sort istek parametresi için bir değer belirtmenizi de gerektirir.
İsteğe bağlı bölgesel filtreler içeren en popüler videolar (<= 200 sonuç)
Bu rapor, kanalın en iyi videolarını listeler. Bu rapor; ülke, kıta veya subContinent'ya göre en popüler videoları listeleyecek şekilde filtrelenebilir.
Bu rapor, kanalın belirli bir ABD eyaletinde veya District of Columbia'da en çok izlenen videolarını listeler. Bu raporun yalnızca yukarıda açıklanan ülkeye özel raporda bulunan metriklerin bir alt kümesini desteklediğini unutmayın.
Abone olan veya abone olmayan izleyiciler için en popüler videolar(<= 200 sonuç)
Bu rapor, abone olan veya abone olmayan izleyiciler için kanalın en iyi videolarını listeler. Bu rapor; ülke, kıta veya subContinent'ya göre en popüler videoları listeleyecek şekilde filtrelenebilir. Önceki rapor, abone olan veya abone olmayan izleyiciler için belirli ABD eyaletlerindeki en iyi videoları almanıza olanak tanır ancak bu rapordan daha az metriği destekler.
YouTube Ürünü bazında en popüler videolar (<= 200 sonuç)
Bu rapor, kanalın en popüler videolarını listeler ve oynatma ayrıntılarını ve coğrafi filtreleri destekler. Bu rapor öncekine benzerdir ancak daha az sayıda metriği destekler ve youtubeProduct filtresi için destek ekler.
Oynatma listesi raporları, kanal sahibinin oynatma listelerindeki videolarla ilgili kullanıcı etkinliğiyle ilgili metrikleri içerir. Bu raporların iki sürümü mevcuttur. Aşağıdaki bölümlerde, her sürümün açıklaması bulunur:
Her bölümdeki Önerilen sekmesinde, ilgili raporu almak için tercih edilen API isteği biçimi açıklanmaktadır. Önerilen raporlar, hem toplu video metriklerini hem de oynatma listesi içi metrikleri içeren genişletilmiş bir metrik grubunu destekler. Bu istek biçimi, isCurated boyutunu kullanmaz.
Her bölümdeki isCurated kullanma sekmesinde, isCurated boyutunun gerekli olduğu eski bir API isteği biçimi açıklanmaktadır. Bu raporlar yalnızca oynatma listesi içi metrikleri destekler. isCurated boyutunun tüm raporlar için kullanımdan kaldırıldığını unutmayın. Aşağıdaki uyarı notunda, kullanımdan kaldırma programı açıklanmaktadır.
Aşağıdaki uyarı notunda, iki raporun sürümü arasındaki değişiklikler daha ayrıntılı olarak açıklanmaktadır.
Toplu video metrikleri
Bu metrikler, oynatma listesinin sahibi olan kanala ait olan ve oynatma listesindeki tüm videolar için toplanan kullanıcı etkinliği ve gösterim metrikleri sağlar. Diğer kanallara ait videoların metrikleri, toplama işleminde hesaplanmaz. Sonuç olarak, bir kanal yalnızca diğer kanallara ait videoları içeren bir oynatma listesi oluşturursa bu oynatma listelerinin raporları bu metrikler için değer sağlamaz.
Bu metrikler, oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimini yansıtır. Bu metrikler, videoların sahibi olan kanaldan bağımsız olarak oynatma listesindeki tüm videoların görüntüleme sayısını içerir ancak yalnızca oynatma listesi bağlamında gerçekleşen görüntülemeleri sayar.
Bu rapor, kullanıcıların kanalın oynatma listelerindeki videolarla olan etkileşimlerine ilişkin istatistikler sağlar. Raporu, yalnızca belirli bir oynatma listesi için veri döndürecek şekilde filtreleyebilirsiniz.
Bu rapor, kullanıcıların kanalın oynatma listelerindeki videolarla olan etkileşimlerine ilişkin istatistikler sağlar. Raporu, yalnızca belirli bir oynatma listesi için veri döndürecek şekilde filtreleyebilirsiniz.
Bu rapor, ABD eyaletleri ve District of Columbia için oynatma listesi etkinliği istatistikleri sağlar.
Bu rapor için, sonuçları yalnızca ABD'ye ilişkin verileri döndürecek şekilde filtrelemeniz gerekir.
Not: Bu rapor, maxResults parametresini 25 veya daha küçük bir tam sayı olarak ayarlamanızı gerektirir. Diğer raporların çoğundan farklı olarak bu rapor, sort istek parametresi için bir değer belirtmenizi de gerektirir.
Bu rapor, kanalın oynatma listelerindeki videolar için en çok görüntüleme veya görüntüleme süresi sağlayan yerleşik video oynatıcıları tanımlar.
Bu rapor, izleyicilerin oynatma listesi içeriğinize nasıl eriştiğine göre görüntüleme istatistiklerini toplar.
Örneğin, bir Google aramasından kaynaklanan görüntüleme sayısını tanımlar.
Not: Bu rapor, maxResults parametresini 25 veya daha küçük bir tam sayı olarak ayarlamanızı gerektirir. Diğer raporların çoğundan farklı olarak bu rapor, sort istek parametresi için bir değer belirtmenizi de gerektirir.
Bu rapor, kanalın oynatma listelerindeki videolar için en çok görüntülemeyi oluşturan yönlendirmelere dayalı olarak görüntüleme istatistiklerini toplar. Yönlendirenler, trafik kaynağı türüne göre sınıflandırılır. insightTrafficSourceDetail boyutunun tanımı, raporun kullanılabilir olduğu trafik kaynaklarını tanımlar.
Örneğin, insightTrafficSourceType filtresini ADVERTISING olarak ayarlarsanız raporda, kanalın oynatma listeleri için en çok görüntülemeyi veya görüntüleme süresini sağlayan reklam türleri listelenir.
Not: Bu rapor yalnızca belirli trafik kaynakları için desteklenir. Örneğin, NO_LINK_EMBEDDED trafik kaynağında ek ayrıntılar bulunmadığından bu raporu desteklemez. Bu raporu destekleyen trafik kaynaklarıyla ilgili ayrıntılar için insightTrafficSourceType tanımına bakın.
Cihaz türü ve işletim sistemi
Cihaz türü
Bu rapor, izleyicilerin oynatma listelerinizdeki videolara nasıl ulaştıklarına göre görüntüleme istatistiklerini toplar. Örneğin, mobil cihazlarda veya oyun konsollarında gerçekleşen görüntülemelerin sayısını tanımlar.
Bu rapor, izleyicilerin işletim sistemlerine göre görüntüleme istatistiklerini toplar. Örneğin, Android cihazlarda veya PlayStation'larda gerçekleşen görüntülemelerin sayısını tanımlar.
Bu rapor, izleyicilerin işletim sistemlerine ve cihaz türlerine göre görüntüleme istatistiklerini toplar.
Örneğin, Android tabletlerde veya Windows masaüstü cihazlarda kaç görüntülemenin gerçekleştiğini tanımlar.
Not: Bu rapordaki viewerPercentage değerleri, subscribedStatus oynatma ayrıntıları boyutunun farklı değerleri için normalleştirilmez.
Örneğin, subscribedStatus boyutunu kullanan bir rapor, abone olunan görüntülemeler için yüzde 100'e kadar olan viewerPercentage verilerini veviewerPercentage0'a varan verileri abonelikten çıkan görüntülemeler için yüzde 10'a kadar toplayarak döndürür. (Rapordaki tüm viewerPercentage alanlarının toplam değeri yüzde 200'dür.)
Raporun yalnızca subscribedStatus boyutlarının bir değeri için viewerPercentage verilerini içerdiğinden emin olmak için filtreleri kullanabilirsiniz.
En iyi oynatma listeleri
Not: Bu raporlar, maxResults parametresini 200 veya daha küçük bir tam sayı değerine ayarlamanızı gerektirir. 1 Ocak 2013 tarihinden önceki veriler yalnızca en iyi 10 oynatma listesinin kullanılabilir. Diğer raporların çoğundan farklı olarak bu raporlar sort istek parametresi için bir değer belirtmenizi de gerektirir.
Bu rapor, belirtilen filtreleme ve sıralama ölçütlerine göre kanalın en iyi oynatma listelerini listeler.
Not: Reklam performansı raporları için https://www.googleapis.com/auth/yt-analytics-monetary.readonly kapsamına erişim veren bir yetkilendirme jetonu gerekir.
Reklam performansı raporları, video oynatma sırasında yayınlanan reklamlar için gösterime dayalı metrikler sağlar. Bu metrikler her bir reklam gösterimini hesaba katar ve her video oynatma birden fazla gösterim sağlayabilir.
Gösterime dayalı reklam performansı metrikleri şunlardır:
Ayrıca bazı video raporları, aşağıdaki oynatmaya dayalı reklam performansı metriklerini destekler. Ancak, bu metrikler reklam performansı raporlarına dahil edilmez.
