Bu sayfada, kanal sahiplerinin YouTube Analytics API ile alabileceği raporlar listelenmektedir. Kanal raporları, belirli bir kanalın kullanıcı etkinliği metriklerini sağlar ve video görüntüleme sayısı, derecelendirme ve abone sayısı gibi metrikleri ölçer.
Video raporları, bir kanalın videolarıyla ilgili tüm kullanıcı etkinliklerine dair istatistikler 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
Kanal raporu almak için API isteğinizde ids parametresi 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 değerini, veri aldığınız kanalın benzersiz kanal kimliği olarak 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 alabilirsiniz.)
Yetkilendirme
Tüm YouTube Analytics API istekleri yetkilendirilmelidir. Yetkilendirme kılavuzunda, yetkilendirme jetonlarını almak için OAuth 2.0 protokolünün nasıl kullanılacağı açıklanmaktadır.
YouTube Analytics API istekleri aşağıdaki yetkilendirme kapsamlarını kullanır:
YouTube içeriğiniz için 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ğiniz için YouTube Analytics'teki parasal raporları görüntüleyin. Bu kapsam, kullanıcı etkinliği metriklerine, tahmini gelir ve reklam performansı metriklerine erişim sağlar.
https://www.googleapis.com/auth/youtube
YouTube hesabınızı yönetin. YouTube Analytics API'de kanal sahipleri, YouTube Analytics gruplarını ve grup öğelerini yönetmek için bu kapsamı kullanır.
https://www.googleapis.com/auth/youtubepartner
YouTube'daki YouTube öğelerini ve ilişkili içeriği görüntüleyin ve yönetin. YouTube Analytics API'de içerik sahipleri, 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. Sonuç olarak, https://www.googleapis.com/auth/yt-analytics-monetary.readonly kapsamı şu anda bu raporlardaki parasal verilere erişim izni vermemektedir.
Filtreler
Desteklenen raporları açıklayan tablolarda, her rapor için kullanılabilecek filtreler belirtilir. 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 zorunludur ve ülke filtresi 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 fazla değer belirtirseniz söz konusu filtreyi istek için belirttiğiniz boyutlar listesine de ekleyebilirsiniz. Bu durum, filtre belirli bir rapor için desteklenen bir boyut olarak listelenmemiş olsa bile geçerlidir.
API sonuçlarının belirli bir değere veya değer grubuna göre nasıl filtreleneceğine dair tam 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 boyutunu ve averageViewPercentage metriğini kullanan oynatma ayrıntıları video raporu için desteklenen boyutlar, metrikler ve filtreler listelenmiştir.
Tabloda boyutlar için iki, metrikler için bir ve filtreler için üç satır bulunur. Boyutlar ve filtreler için, her satırdaki değerler, kombinasyon tablodaki kullanım kurallarına uyduğu sürece bir API isteğinde birleştirilebilir. Örneğin, bu rapor için geçerli dimensions parametre değerleri şunlardır:
dimensions=day
dimensions=day,subscribedStatus
dimensions=month,subscribedStatus,youtubeProduct
dimensions=month,youtubeProduct
Ancak day,month parametre değeri, zamana dayalı iki boyut kullandığından geçersizdir ve istekte 0 veya 1 kullanılmalıdır.
Rapor tablosu terminolojisi
Tablolarda, boyutların gerekli mi yoksa isteğe bağlı mı olduğunu belirtmek için aşağıdaki terminoloji kullanılır:
Aşağıdaki terimler, bir değer gerektiğini gösterir:
Zorunlu: Değeri eklemeniz gerekir.
Tam olarak 1 tane kullanın: Gruptan bir değer eklemeniz gerekir.
1 veya daha fazlasını kullanın: Gruptaki herhangi bir değeri veya tüm değerleri dahil edebilirsiniz ancak en az bir değer eklemeniz gerekir.
Aşağıdaki terimler, bir değerin isteğe bağlı olduğunu gösterir:
İsteğe bağlı: Değeri ekleme seçeneğiniz vardır.
0 veya 1 kullanın: Gruptan bir değer ekleyebilirsiniz.
0 veya daha fazla değer kullanın: Gruptaki herhangi bir değeri veya tüm değerleri dahil edebilirsiniz.
Video raporları
Temel istatistikler
Temel kullanıcı etkinliği istatistikleri
Bu rapor, kullanıcıların bir kanaldaki işlemleriyle ilgili istatistikleri sağlar. Raporu yalnızca belirli bir video veya ülkeye ait verileri döndürecek şekilde filtreleyebilirsiniz.
ABD eyaletleri için temel kullanıcı etkinliği istatistikleri
Bu raporda, belirli bir ABD eyaleti veya District of Columbia ile ilgili istatistikler sunulur. Bu raporun, yukarıda açıklanan ülkeye özgü raporda bulunan metriklerin yalnızca bir alt kümesini desteklediğini unutmayın.
Belirli dönemlere göre ülkeye göre kullanıcı etkinliği
Bu rapor, belirli zaman aralıklarında bir kanaldaki kullanıcı işlemleriyle ilgili istatistikleri sağlar. Raporu yalnızca belirli bir video veya ülkeye ait verileri döndürecek şekilde filtreleyebilirsiniz.
ABD eyaletlerindeki kullanıcı etkinliği (belirli dönemler için)
Bu rapor, belirli bir ABD eyaleti veya District of Columbia için kullanıcı etkinliğiyle ilgili istatistikler sağlar. Bu raporun, yukarıda açıklanan ülkeye özgü raporda bulunan metriklerin yalnızca bir alt kümesini desteklediğini unutmayın.
Bu rapor, bir kanalın kullanıcı etkinliğiyle ilgili istatistikleri ülke bazında sağlar. Raporu yalnızca belirli bir videoya ait verileri döndürecek şekilde filtreleyebilirsiniz.
Bu rapor, ABD eyaletleri ve Washington D.C. 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 için maxResults parametresini 250 veya daha küçük bir tam sayı değerine ayarlamanız gerekir. Diğer raporların çoğundan farklı olarak bu raporda sort istek parametresi için bir değer belirtmeniz de gerekir.
Bu rapor, şehire göre kullanıcı etkinliği istatistiklerini sağlar.
Bu rapor, Belirlenen Pazar Alanı'na (TPA) göre kullanıcı etkinliği istatistiklerini sağlar. Bu rapor için filters parametre değerini country==US olarak ayarlamanız veya belirli bir ili (ABD eyaleti) filtrelemeniz gerekir.
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. Rapor ayrıca ülkeye, kıtaya veya subContinent göre de filtrelenebilir.
İllere göre abonelik durumuna göre kullanıcı etkinliği
Bu rapor, ABD eyaletlerindeki veya District of Columbia'daki abone olan ve aboneliği iptal eden izleyiciler için kullanıcı etkinliği metriklerini sağlar. Bu rapor, önceki rapora kıyasla daha az metriği destekler.
İsteğe bağlı zaman boyutu içeren oynatma ayrıntıları
Raporun kapsayacağı tarih aralığını belirtmek için startDate ve endDate istek parametrelerini kullanmanız gerektiğinden, zaman boyutu (gün veya ay) bu raporlar için isteğe bağlıdır. Mevcut olduğunda boyut, rapordaki verilerin güne, aya vb. göre birleştirilmesini istediğinizi gösterir.
İsteğe bağlı zaman boyutu ve liveOrOnDemand istatistikleri içeren 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 için maxResults parametresini 25 veya daha küçük bir tam sayı değerine ayarlamanız gerekir. Diğer raporların çoğundan farklı olarak bu raporda sort istek parametresi için bir değer belirtmeniz de gerekir.
Bu rapor, bir kanalın videoları için en çok görüntüleme veya izlenme süresi sağlayan yerleşik video oynatıcıları tanımlar.
Bu rapor, izleyicilerin video içeriğinize ulaşma şekline göre izleme istatistiklerini toplar. Örneğin, bir Google aramasından veya ilgili bir videonun bağlantısından gelen görüntüleme sayısını tanımlar.
Not:Sorgulanan video sayısı x tarih aralığındaki gün sayısı çarpımı 50.000'i aşarsa bu rapor hata döndürür. Örneğin, 500 video kimliğiyle ilgili verileri alan bir sorgu en fazla 100 günlük veri isteyebilir. Bir isteğin döndürdüğü satır sayısını azaltmak için sorgunuzu daha az video belirten veya daha kısa tarih aralıkları ayarlayan birden fazla sorguya bölün.
Not: Bu rapor için maxResults parametresini 25 veya daha küçük bir tam sayı değerine ayarlamanız gerekir. Diğer raporların çoğundan farklı olarak bu raporda sort istek parametresi için bir değer belirtmeniz de gerekir.
Bu rapor, kanalın içeriği için en fazla görüntüleme sağlayan yönlendiricilere göre görüntüleme istatistiklerini toplar. Yönlendirenler, trafik kaynağı türüne göre kategorize edilir ve insightTrafficSourceDetail boyutunun tanımı, raporun kullanılabildiği trafik kaynaklarını tanımlar. Örneğin, insightTrafficSourceType filtresini ADVERTISING olarak ayarlarsanız raporda, kanalın içeriği için en çok görüntüleme veya izlenme süresi sağlayan reklam türleri listelenir.
Not: Bu rapor yalnızca belirli trafik kaynakları için desteklenir. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES ve NO_LINK_EMBEDDED trafik kaynakları desteklenmeyen kaynaklardan bazılarıdır.
Cihaz türü ve işletim sistemi
Cihaz türü
Bu rapor, izleyicilerin video içeriğinize ulaşma şekline göre izleme istatistiklerini toplar. Örneğin, mobil cihazlarda veya oyun konsollarında gerçekleşen görüntüleme sayısını tanımlar.
Bu rapor, izleme istatistiklerini izleyicilerin işletim sistemlerine göre toplar. Örneğin, Android cihazlarda veya PlayStation'larda gerçekleşen görüntüleme sayısını tanımlar.
Bu rapor, görüntüleme istatistiklerini izleyicilerin işletim sistemlerine ve cihaz türlerine göre toplar. Örneğin, Android tabletlerde veya Windows masaüstü cihazlarda gerçekleşen görüntüleme sayısını tanımlar.
Örneğin, subscribedStatus boyutunu kullanan bir rapor, abone olunan görüntülemeler için yüzde 100'e ulaşan viewerPercentage verileri ve abone olunmayan görüntülemeler için yüzde 100'e ulaşan viewerPercentage verileri döndürür. (Rapordaki tüm viewerPercentage alanlarının toplam değeri yüzde 200'dür.)
Oynatma ayrıntısı boyutları için raporda yalnızca bir değere (veya değer kombinasyonuna) ait viewerPercentage verilerinin yer aldığından emin olmak üzere filtreler kullanabilirsiniz.
Etkileşim ve içerik paylaşımı
Bu rapor, kanalın videolarının farklı sosyal medya platformlarında ne sıklıkta paylaşıldığını gösteren istatistikleri sunar.
Bu rapor, bir videonun kitlesini elde tutma özelliğini ölçer ve videonun belirli bölümlerinin ne sıklıkta izlendiğini gösterir. elapsedVideoTimeRatio boyutu, ilgili metrik değerleri için videonun oynatıldığı süreyi ölçer. Metrikler iki kategoriye ayrılabilir:
Kitleyi elde tutma
Bu metrikler, videonun kitleyi ne kadar iyi tuttuğunu gösterir.
audienceWatchRatio, bir videonun bir bölümünün görüntülenme sayısının videonun toplam görüntüleme sayısına oranını gösteren bir orandır.
relativeRetentionPerformance, bir videonun oynatma sırasında izleyicileri ne kadar iyi elde tuttuğunu, benzer uzunluktaki diğer YouTube videolarına kıyasla gösterir.
Ayrıntılı izleme istatistikleri
Bu metrikler, videonun belirli bölümlerinin ne sıklıkta izlendiği hakkında bilgi sağlar.
startedWatching, izleyicilerin videonun belirli bir segmentinde videoyu izlemeye ne sıklıkta başladığını gösterir.
stoppedWatching, izleyicilerin videonun belirli bir segmentinde izlemeyi ne sıklıkta bıraktığını gösterir.
totalSegmentImpressions, videonun belirli bir segmentinin ne sıklıkta görüntülendiğini gösterir.
Not: Bu rapor, video filtresi için virgülle ayrılmış bir değer listesi belirtme özelliğini desteklemez. Değer, tek bir video kimliği belirtmelidir.
Bu rapor, canlı yayınlanan tek bir videonun belirli bir pozisyonunda aynı anda izleyen kullanıcı sayısını gösterir.
Filtre, videoyu belirtir. Konum boyutu genellikle tek bir dakikayı temsil eder.
Not: Bu raporlar için maxResults parametresini 200 veya daha düşük bir tam sayı değerine ayarlamanız gerekir. 1 Ocak 2013'ten önceki veriler yalnızca en popüler 10 video için kullanılabilir. Diğer raporların çoğundan farklı olarak bu raporlarda sort istek parametresi için bir değer belirtmeniz de gerekir.
İsteğe bağlı bölgesel filtrelerle en popüler videolar (<= 200 sonuç)
Bu raporda kanalın en popüler videoları listelenir. Rapor, en popüler videoları ülkeye, kıtaya veya subContinent göre listeleyecek şekilde filtrelenebilir.
Bu raporda, kanalın belirli bir ABD eyaletinde veya District of Columbia'da en çok izlenen videoları listelenir. Bu raporun, yukarıda açıklanan ülkeye özgü raporda bulunan metriklerin yalnızca bir alt kümesini desteklediğini unutmayın.
Abone olan veya aboneliği iptal eden izleyiciler için en popüler videolar(<= 200 sonuç)
Bu raporda, kanalın abone olan veya olmayan izleyiciler için en popüler videoları listelenir. Rapor, en popüler videoları ülkeye, kıtaya veya subContinent göre listeleyecek şekilde filtrelenebilir. Önceki rapor, abone olan veya aboneliği iptal eden izleyiciler için belirli bir ABD eyaletinde en çok izlenen videoları almanıza olanak tanır ancak bu rapordan daha az metriği destekler.
YouTube Ürününe göre en popüler videolar (<= 200 sonuç)
Bu raporda kanalın en popüler videoları listelenir. Oynatma ayrıntıları ve coğrafi filtreler desteklenir. Bu rapor öncekine benzer ancak daha az metriği destekler ve youtubeProduct filtresini 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ü vardır ve her rapor için aşağıdaki bölümlerde her bir sürümün açıklaması yer alır:
Her bölümdeki Önerilen sekmesinde, ilgili raporu almak için tercih edilen API istek biçimi açıklanır. Önerilen raporlar hem toplu video metriklerini hem de oynatma listesi metriklerini içeren geniş bir metrik grubunu destekler. Bu istek biçiminde isCurated boyutu kullanılmaz.
Her bölümdeki isCurated kullanma sekmesinde, isCurated boyutunun gerekli olduğu eski bir API istek biçimi açıklanmaktadır. Bu raporlar yalnızca oynatma listesi metriklerini destekler. isCurated boyutunun tüm raporlarda desteğinin sonlandırıldığını unutmayın. Aşağıdaki uyarı notunda desteğin sonlandırılma planı açıklanmaktadır.
Aşağıdaki uyarı notunda, iki rapor sürümü arasındaki değişiklikler daha ayrıntılı olarak açıklanmaktadır.
Toplu video metrikleri
Bu metrikler, oynatma listesindeki ve oynatma listesinin sahibi olan kanala ait tüm videolar için toplu 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 listeleriyle ilgili raporlarda bu metrikler için değerler sağlanmaz.
Bu metrikler, oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimini yansıtır. Bu metrikler, 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 etkileşimleriyle ilgili istatistikleri sağlar. Raporu yalnızca belirli bir oynatma listesinin verilerini döndürecek şekilde filtreleyebilirsiniz.
Bu rapor, kullanıcıların kanalın oynatma listelerindeki videolarla etkileşimleriyle ilgili istatistikleri sağlar. Raporu yalnızca belirli bir oynatma listesinin verilerini döndürecek şekilde filtreleyebilirsiniz.
Bu rapor, ABD eyaletleri ve Washington D.C. için oynatma listesi etkinliği istatistiklerini sağlar.
Bu rapor için sonuçları yalnızca Amerika Birleşik Devletleri'ne ait verileri döndürecek şekilde filtrelemeniz gerekir.
Not: Bu rapor için maxResults parametresini 25 veya daha düşük bir tam sayı değerine ayarlamanız gerekir. Diğer raporların çoğundan farklı olarak bu raporda sort istek parametresi için bir değer belirtmeniz de gerekir.
Bu rapor, kanalın oynatma listelerindeki videolar için en fazla görüntüleme veya izlenme süresi sağlayan yerleşik video oynatıcıları gösterir.
Bu rapor, izleyicilerin oynatma listesi içeriğinize nasıl ulaştığına göre izleme istatistiklerini toplar.
Örneğin, bir Google aramasından kaynaklanan görüntüleme sayısını tanımlar.
Not: Bu rapor için maxResults parametresini 25 veya daha küçük bir tam sayı değerine ayarlamanız gerekir. Diğer raporların çoğundan farklı olarak bu raporda sort istek parametresi için bir değer belirtmeniz de gerekir.
Bu rapor, kanalın oynatma listelerindeki videolar için en fazla görüntüleme sağlayan yönlendiricilere göre görüntüleme istatistiklerini toplar. Yönlendirenler, trafik kaynağı türüne göre kategorize edilir ve insightTrafficSourceDetail boyutunun tanımı, raporun kullanılabildiği trafik kaynaklarını tanımlar.
Örneğin, insightTrafficSourceType filtresini ADVERTISING olarak ayarlarsanız raporda, kanalın oynatma listeleri için en fazla görüntüleme veya görüntüleme süresi sağlayan reklam türleri listelenir.
Not: Bu rapor yalnızca belirli trafik kaynakları için desteklenir. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES ve NO_LINK_EMBEDDED trafik kaynakları desteklenmeyen kaynaklardan bazılarıdır.
Cihaz türü ve işletim sistemi
Cihaz türü
Bu rapor, izleyicilerin oynatma listelerinizdeki videolara nasıl ulaştığına göre izleme istatistiklerini toplar. Örneğin, mobil cihazlarda veya oyun konsollarında gerçekleşen görüntüleme sayısını tanımlar.
Bu rapor, izleme istatistiklerini izleyicilerin işletim sistemlerine göre toplar. Örneğin, Android cihazlarda veya PlayStation'larda gerçekleşen görüntüleme sayısını tanımlar.
Bu rapor, görüntüleme istatistiklerini izleyicilerin işletim sistemlerine ve cihaz türlerine göre toplar.
Örneğin, Android tabletlerde veya Windows masaüstü cihazlarda kaç görüntüleme gerçekleştiğini tanımlar.
Not: Bu rapordaki viewerPercentage değerleri, subscribedStatus oynatma ayrıntısı boyutunun farklı değerleri için normalleştirilmez.
Örneğin, subscribedStatus boyutunu kullanan bir rapor, abone olunan görüntülemeler için toplam yüzde 100'e ulaşan viewerPercentage verileri ve abone olunmayan görüntülemeler için toplam yüzde 100'e ulaşan viewerPercentage verileri 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 verileri içermesini sağlamak üzere filtreler kullanabilirsiniz.
En iyi oynatma listeleri
Not: Bu raporlar için maxResults parametresini 200 veya daha düşük bir tam sayı değerine ayarlamanız gerekir. 1 Ocak 2013'ten önceki veriler yalnızca ilk 10 oynatma listesi için kullanılabilir. Diğer raporların çoğundan farklı olarak bu raporlarda sort istek parametresi için bir değer belirtmeniz de gerekir.
Bu raporda, belirtilen filtreleme ve sıralama ölçütlerine göre kanalın en popüler oynatma listeleri listelenir.
Not: Reklam performansı raporları için https://www.googleapis.com/auth/yt-analytics-monetary.readonly kapsamına erişim izni veren bir yetkilendirme jetonu gerekir.
Reklam performansı raporları, video oynatmaları sırasında yayınlanan reklamlar için gösterime dayalı metrikler sağlar. Bu metrikler her reklam gösterimini hesaba katar ve her video oynatma işlemi birden fazla gösterim sağlayabilir.
Gösterime dayalı reklam performansı metrikleri şunlardır:
Ayrıca bazı video raporları, oynatmaya dayalı aşağıdaki reklam performansı metriklerini destekler. Ancak bu metrikler reklam performansı raporlarına dahil edilmez.
