Not:Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.
Bu sayfada, içerik sahiplerinin YouTube Analytics API aracılığıyla alabilecekleri raporlar listelenmektedir. İçerik sahibi raporları, belirli bir YouTube içerik sahibine bağlı kanallarla ilgili metrikleri içerir. Metrikler kullanıcı etkinliğinin, reklam performansının veya tahmini gelirin ayrı ayrı ölçümleridir.
Video raporları, içerik sahibinin kanallarındaki videolara ait kullanıcı etkinliği, reklam performansı ve tahmini gelir metriklerini içerir.
Oynatma listesi raporları, özellikle bir oynatma listesi bağlamında gerçekleşen video görüntülemeleriyle ilgili istatistikler sağlar. Oynatma listesi raporları, video raporlarıyla aynı boyut ve filtrelerin çoğunu kullanır.
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 içerik sahibi raporu almak için API'nin reports.query yöntemini çağırın ve API isteğindeki ids parametre değerini contentOwner==OWNER_NAME olarak ayarlayın. Burada OWNER_NAME, içerik sahibinin kimliğini belirtir. Değerden emin değilseniz iş ortağı yöneticinize danışın.
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: Yıldız işareti (*) ile işaretlenen metrikler için https://www.googleapis.com/auth/yt-analytics-monetary.readonly kapsamına erişim izni veren bir yetkilendirme jetonu gerekir.
Filtreler
İçerik sahibi raporlarını almak için yapılan tüm API istekleri; video boyutunu, channel boyutunu, isCurated boyutunu veya claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonunu kullanarak verileri filtrelemelidir. (Desteklenen kombinasyonlar uploaderType boyutunun tanımında listelenmiştir.)
Desteklenen raporları açıklayan tablolar, belirli bir rapor için kullanılabilecek filtreleri tanımlar. Açıklamalarda, parantez içinde gösterilen filtreler isteğe bağlıdır. Örneğin, bir raporda filtreleme seçeneği olarak video(,country) belirtilmişse rapor, yalnızca belirli bir videoya ilişkin verileri ya da yalnızca belirli bir ülkedeki belirli bir videonun verilerini içerecek şekilde filtrelenebilir.
API; video, playlist ve channel 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.
Önemli: İçerik sahibi video raporlarını almak için yapılan tüm API istekleri; video boyutu, kanal boyutu, grup boyutu veya claimedStatus ile uploaderType boyutlarının desteklenen bir kombinasyonunu kullanarak verileri filtrelemelidir. (Bazı raporlar bu seçeneklerin tümünü desteklemez.) uploaderType boyutunun tanımında da listelenen desteklenen kombinasyonlar şunlardır:
uploaderType==self
claimedStatus==claimed
claimedStatus==claimed;uploaderType==self
claimedStatus==claimed;uploaderType==thirdParty
Video raporları
Temel istatistikler
Temel istatistikler (abone sayıları dahil)
Bu rapor, bir içerik sahibinin tüm kanallarındaki kullanıcı işlemleriyle ilgili istatistikler sağlar. Raporu, yalnızca belirli bir video veya ülke için veri döndürecek şekilde filtreleyebilirsiniz. Yalnızca hak talebinde bulunulan içeriklere (içerik sahibi, üçüncü taraflarca veya her ikisi tarafından yüklenen hak talebinde bulunulan içerikler dahil) dair istatistikleri almak için de kullanılabilir.
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.
Bu rapor, belirli zaman aralıklarında bir içerik sahibinin tüm kanallarındaki 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 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.
Bu rapor, içerik sahibinin tüm kanalları için ülke bazında kullanıcı etkinliğiyle ilgili istatistikler sağlar. Raporu, yalnızca belirli bir video veya kanal için veri 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.
Oynatma ayrıntıları raporları, aşağıdaki görüntüleme özellikleriyle ilgili istatistikler sağlar:
Görüntü, canlı bir video yayını mı yoksa isteğe bağlı bir video muydu?
İzleyici videonun sahibi olan kanala abone miydi?
Görüntüleme işlemi hangi YouTube ürününde gerçekleşti?
Teknik olarak, bu raporların desteklediği oynatma ayrıntısı boyutlarının tümü isteğe bağlıdır. İsteğinize oynatma ayrıntısı boyutlarını dahil etmezseniz döndürülen rapor aslında temel istatistikler, zamana dayalı veya kullanıcı coğrafyası raporlarından birine benzer.
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 içerik sahibinin içeriği 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 raporu alırken insightPlaybackLocationType filtresini EMBEDDED olarak ayarlamanız gerekir.
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, içerik sahibinin 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 rapor, içerik sahibinin içeriklerinin en çok görüntülendiği reklam türlerini veya görüntüleme süresini listeler.
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 içeriklerinizi izlerken kullandığı cihaz türüne göre görüntüleme istatistiklerini toplar. Örneğin, tabletlerde veya oyun konsollarında gerçekleşen görüntüleme 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.
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.
Ülkeye, kıtaya veya alt kıtaya göre genel olarak en iyi videolar (<= 200 sonuç)
Bu raporda, belirtilen filtreleme ve sıralama ölçütlerine göre içerik sahibinin en popüler videoları listelenir.
ABD eyaletlerine göre toplam en iyi videolar (<= 200 sonuç)
Bu raporda, içerik sahibinin belirli bir ABD eyaleti veya District of Columbia'daki en popüler videoları listelenir. 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 raporda, abone olan veya olmayan izleyiciler için en popüler videolar listelenir. 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, en popüler videoları listeler ve oynatma ayrıntıları ile coğrafi filtreleri destekler. Bu rapor öncekine benzerdir ancak daha az sayıda metriği destekler ve youtubeProduct filtresi için destek ekler.
Oynatma ayrıntısı filtrelerine sahip en popüler videolar (<= 200 sonuç)
Bu rapor, bir veya daha fazla oynatma ayrıntısı boyutuna göre filtrelenerek içerik sahibinin en popüler videolarını listeler: liveOrOnDemand, subscribedStatus ve youtubeProduct. Rapor, bölgeye göre filtrelemeyi de destekler.
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 içerik sahibinin kanallarındaki oynatma listelerinde bulunan videolarla etkileşimleriyle ilgili istatistikler sağlar. Raporda gerekli boyut yok.
Bu rapor, kullanıcıların belirli zaman aralıklarında içerik sahibinin kanallarındaki oynatma listelerindeki videolarla etkileşimiyle ilgili istatistikler sağlar. Raporu, yalnızca belirli bir oynatma listesi veya kanal 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 filters parametre değerine country==US eklediniz.
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, içerik sahibinin oynatma listeleri 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, kullanıcıların oynatma listesi içeriğinize ulaşma şekline göre görüntüleme istatistiklerini toplar. Örneğin, bir Google arama veya kanal sayfası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, içerik sahibinin oynatma listeleri 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 ve insightTrafficSourceDetail boyutunun tanımı, raporun kullanılabildiği trafik kaynaklarını tanımlar. Örneğin insightTrafficSourceType filtresini ADVERTISING olarak ayarlarsanız rapor, içerik sahibinin oynatma listeleri için en çok görüntüleme sağlayan reklam türlerini veya görüntüleme süresini listeler.
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
Oynatma listeleri için cihaz türü
Bu rapor, kullanıcıların oynatma listenizdeki içerikleri izlemek için kullandığı cihaz türüne göre görüntüleme istatistiklerini bir araya getirir. Ö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 oynatma listesi görüntülemelerinin sayısını tanımlar.
Oynatma listeleri için işletim sistemi ve cihaz türü
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 oynatma listesi görüntülemelerinin sayısını tanımlar.
Not: Bu rapordaki viewerPercentage değerleri, oynatma ayrıntıları boyutları için farklı değerler veya değer kombinasyonları (subscribedStatus ve youtubeProduct) için normalleştirilmez.
Örneğin, subscribedStatus boyutunu kullanan bir rapor, abone olan görüntülemeler için yüzde 100'e varan viewerPercentage verileri döndürür. aboneliği iptal eden görüntülemeler için {/150görüntüleme verileri çıkarır. 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.
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 içerik sahibinin 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.
