Metrics

Bu belge, YouTube Analytics API'yi kullanarak alabileceğiniz metrikleri tanımlar. Bu API, özel YouTube Analytics raporları oluşturmak için gerçek zamanlı sorguları destekler.

Metrikler kullanıcı etkinliği, reklam performansı veya tahmini gelirin ayrı ayrı ölçümüdür. Kullanıcı etkinliği metrikleri video görüntüleme sayısı ve puanları (beğenme ve beğenmeme sayısı) gibi şeyleri içerir.

Temel metrikler

YouTube Analytics API, Hizmet Şartları'nda açıklanan Kullanımdan Kaldırma Politikası'na tabi olsa da temel olmayan metrikler (ve temel olmayan boyutlar) politikaya tabi değildir. Bu sayfadaki tanımlarda, temel metrik olan tüm metrikler açıkça bu şekilde tanımlanmıştır.

Aşağıdaki liste, API'nin temel metriklerini tanımlar.

Not: Aşağıdaki temel metrikler tamamen kullanımdan kaldırılmıştır:
  • earnings temel metriği 4 Ağustos 2016'da kullanımdan kaldırıldı ve estimatedRevenue olarak yeniden adlandırıldı. Hizmet Şartları'nda yer alan Kullanımdan Kaldırma Politikası'na uygun olarak, earnings ve estimatedRevenue metrikleri 10 Ağustos 2017'ye kadar eşzamanlı olarak desteklendi.
  • favoritesAdded ve favoritesRemoved temel metrikleri 31 Mart 2015'te kullanımdan kaldırıldı. Bu metrikler yalnızca YouTube Analytics API üzerinden alınabilir.

Daha fazla bilgi için Kullanımdan Kaldırma Politikası'na tabi olan YouTube API'leri listesini inceleyin.

Metrikleri görüntüleyin

görüntüleme sayısı (temel metrik)
Bir videonun görüntülenme sayısı. Oynatma listesi raporundaki metrik, bir videonun oynatma listesi bağlamında kaç kez görüntülendiğini belirtir. YouTube Yardım Merkezi, görüntülemelerin nasıl raporlandığı hakkında ek bilgiler sağlar. This is a core metric and is subject to the Deprecation Policy.
redViews
Bir videonun, YouTube Premium (önceki adıyla YouTube Red) üyeleri tarafından görüntülenme sayısı.
benzersiz kullanıcılar (27 Eylül 2016'da kullanımdan kaldırılmıştır)
Bir videoyu izleyen benzersiz izleyicilerin sayısı. Bu hesaplama, benzersiz çerezlerin sayısını temel alır. Bu nedenle, birden fazla cihaz veya tarayıcı kullanan kullanıcılar fazla sayılır.
uniques metriği 27 Eylül 2016'da kullanımdan kaldırılmıştır. Bu, temel bir metrik değildir ve 31 Ekim 2016 tarihine kadar desteklenir.
viewerPercentage (temel metrik)
Videoyu veya oynatma listesini izlerken giriş yapan izleyicilerin yüzdesi. This is a core metric and is subject to the Deprecation Policy.

İzlenme süresi metrikleri

estimatedMinuteswatched (temel metrik)
Kullanıcıların belirtilen kanal, içerik sahibi, video veya oynatma listesi için video izlediği dakika sayısı. This is a core metric and is subject to the Deprecation Policy.
tahminiRedDakika İzlendi
YouTube Premium (önceki adıyla YouTube Red) üyelerinin video izlediği dakika sayısı.
OrtalamaGörüntüleme Süresi (temel metrik)
Video oynatma sayısının saniye cinsinden ortalama uzunluğu. 13 Aralık 2021 itibarıyla, bu metrik dönüştürülen kliplerin trafiğini kapsamaz. Bir oynatma listesi raporundaki metrik, bir oynatma listesi bağlamında gerçekleşen video oynatmalarının saniye cinsinden ortalama uzunluğunu gösterir. This is a core metric and is subject to the Deprecation Policy.
OrtalamaGörüntüleme Yüzdesi
Video oynatma sırasında videonun ortalama izlenme yüzdesi. 13 Aralık 2021 itibarıyla, bu metrik dönüştürülen kliplerin trafiğini kapsamaz.

Etkileşim metrikleri

yorumlar (temel metrik)
Kullanıcıların bir videoya yorum yapma sayısı. Daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin. This is a core metric and is subject to the Deprecation Policy.
beğenme (temel metrik)
Kullanıcıların olumlu bir puan vererek bir videoyu beğendiklerini belirtme sayısı. This is a core metric and is subject to the Deprecation Policy.
beğenmeme sayısı (temel metrik)
Kullanıcıların olumsuz puan vererek bir videoyu beğenmediklerini gösterme sayısı. This is a core metric and is subject to the Deprecation Policy.
paylaşımlar (temel metrik)
Kullanıcıların Share düğmesiyle video paylaşma sayısı. Daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin. This is a core metric and is subject to the Deprecation Policy.
Kazanılan abone sayısı (temel metrik)
Kullanıcıların bir kanala abone olma sayısı. This is a core metric and is subject to the Deprecation Policy.

Kanallar; video izleme sayfası, kanal sayfası ve YouTube ana sayfasında görünen rehber gibi pek çok yerde abone kazanabilir veya abonelerini kaybedebilir. Kanal raporlarında bu metrik, bu yerlerden herhangi birinden kazanılan aboneleri içerir. Ancak, yanıtı yalnızca belirli bir videonun verilerini içerecek şekilde kısıtlamak için video boyutunu veya filter parametresini kullanan raporlarda subscribersGained metriği yalnızca belirtilen videonun izleme sayfasındaki istatistikleri içerir.
subscribersLost (temel metrik)
Kullanıcıların kanal aboneliğinden çıkma sayısı. This is a core metric and is subject to the Deprecation Policy.

Bu metriğe ait veriler subscribersGained metriğine benzer şekilde raporlanır. Kanal raporlarında bu metrik, kullanıcıların kanal aboneliğini iptal etmek için kullanabileceği tüm mekanizmalar nedeniyle kaybedilen aboneleri içerir. Ancak, yanıtı yalnızca belirli bir videonun verilerini içerecek şekilde kısıtlamak için video boyutunu veya filter parametresini kullanan raporlarda bu metrik, yalnızca belirtilen videonun izleme sayfasının aboneliğinden çıkan kullanıcıları içerir.
Videolara Oynatma Listeleri
Videoların YouTube oynatma listelerine eklenme sayısıdır. Videolar, video sahibinin oynatma listesine veya diğer kanalların oynatma listelerine eklenmiş olabilir.

Metrik değeri, videoların "Daha Sonra İzle" oynatma listesi gibi varsayılan oynatma listelerine kaç kez eklendiğini gösterir. Ancak bir kanalın yüklenen oynatma listesi veya kullanıcının izleme geçmişi gibi videonun otomatik olarak eklendiği oynatma listelerini saymaz.

Bu metrik mutlak bir sayı döndürür. Diğer bir ifadeyle, bir kullanıcı oynatma listesine video eklediğinde, videoyu kaldırıp tekrar eklediğinde bu metrik, videonun oynatma listesine eklenen videoyu iki kez yansıtır. Bu metrikle ilgili veriler, 1 Ekim 2014'ten önceki tarihler için kullanılamaz.
videosRemovedFromplaylists
Videoların YouTube oynatma listelerinden kaldırılma sayısı. Videolar video sahibinin oynatma listesinden veya diğer kanalların oynatma listelerinden kaldırılmış olabilir.

Metrik değeri, videoların "Daha Sonra İzle" oynatma listesi gibi varsayılan oynatma listelerinden kaldırılma sayısını içerir.

Bu metrik, mutlak bir sayı döndürür. Yani bir kullanıcı, bir oynatma listesine video ekler, bu videoyu tekrar kaldırır ve ardından videoyu tekrar kaldırırsa metrik değeri, videonun iki kez kaldırılan videoyu yansıttığını gösterir. Bu metrikle ilgili veriler, 1 Ekim 2014'ten önceki tarihler için kullanılamaz.

Kullanımdan kaldırılan etkileşim metrikleri

Aşağıdaki metrikler 31 Mart 2015 tarihinde kullanımdan kaldırılan temel metriklerdir.

favorites added (temel metrik) (31 Mart 2015'te kullanımdan kaldırılmıştır)
Kullanıcıların bir videoyu favori video olarak işaretleme sayısı. Daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (temel metrik) (31 Mart 2015'te kullanımdan kaldırıldı)
Kullanıcıların favori video listelerinden bir videoyu kaldırma sayısı. Daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin. This is a core metric and is subject to the Deprecation Policy.

Oynatma listesi metrikleri

oynatmalistesi
İzleyicilerin bir oynatma listesini başlatma sayısı. Bu metriğin yalnızca web'de gerçekleşen oynatma listesi görüntülemelerini içerdiğini unutmayın.
Görüntüleme Başına Oynatma Listesi Başlatma
Bir oynatma listesi her başlatıldığında gerçekleşen ortalama video görüntüleme sayısı. Bu metriğin yalnızca web'de gerçekleşen oynatma listesi görüntülemelerini içerdiğini unutmayın.
OrtalamaTimeInPlaylist
İzleyicinin, oynatma listesi başlatıldıktan sonra oynatma listesindeki videoları görüntülediği tahmini dakika sayısıdır. Bu metriğin yalnızca web'de gerçekleşen oynatma listesi görüntülemelerini içerdiğini unutmayın.

Ek açıklama metrikleri

Not: YouTube Analytics API raporları, 10 Haziran 2012 tarihinden itibaren yalnızca annotationClickThroughRate ve annotationCloseRate metriklerine ait verileri döndürür. Ayrıca YouTube Analytics API raporları, 16 Temmuz 2013 tarihinden itibaren yalnızca kalan ek açıklama metriklerine ait verileri döndürmektedir.

eknotGösterimler
Ek açıklama gösterimlerinin toplam sayısı.
notClickClickableGösterimler
Gösterilen ve tıklanabilen ek açıklamaların sayısı.
ek açıklamalıTıklamalar
Tıklanan ek açıklamaların sayısı.
notClickThroughRate (temel metrik)
İzleyicilerin tıkladığı ek açıklamaların, tıklanabilir ek açıklama gösterimlerinin toplam sayısına oranı. This is a core metric and is subject to the Deprecation Policy. YouTube Yardım Merkezi'nde ek açıklama oluşturma ve bağlantı ek açıklamalarını kullanma hakkında daha fazla bilgi bulabilirsiniz.
ek açıklamaClosableGösterimler
Gösterilen ve kapatılabilen ek açıklamaların sayısı.
Ek Açıklama Kapatılır
Kapatılan ek açıklama sayısı.
notesCloseRate (temel metrik)
İzleyicilerin kapattığı ek açıklamaların, toplam ek açıklama gösterimi sayısına oranı. This is a core metric and is subject to the Deprecation Policy.

Kart metrikleri

YouTube Yardım Merkezi'nde videolarınıza kart ekleme ve YouTube Analytics Kartlar Raporu hakkında daha ayrıntılı talimatlar yer alır.

cardGösterimler
Kartların görüntülenme sayısı. Kart paneli açıldığında video kartlarının her biri için bir kart gösterimi kaydedilir.
cardClicks
Kartların tıklanma sayısı.
kartTıklama Oranı
Kartların tıklama oranı. Bu oran, kart tıklama sayısının kart gösterim sayısına oranı olarak hesaplanır.
cardTeaserGösterimler
Kart bilgilerinin gösterilme sayısı. Video görüntüleme, birden fazla teaser gösterimi oluşturabilir.
cardTeaserClicks
Kart bilgilerinin tıklanma sayısı. Kart simgesi tıklamaları, kullanıcıya gösterilen son bilgiyle ilişkilendirilir.
kartTeaserTıklama Oranı
Kart bilgileri için tıklama oranı. Bu değer, kart bilgisi tıklamalarının toplam kart bilgisi gösterim sayısına oranı olarak hesaplanır.

Kitleyi elde tutma metrikleri

audienceTrackingRatio
Videonun belirli bir noktasında videoyu izleyen kullanıcıların mutlak oranı. Bu oran, videonun bir bölümünün izlenme sayısının videonun toplam görüntülenme sayısıyla karşılaştırılmasıyla hesaplanır. elapsedVideoTimeRatio boyutu, videonun metriğin karşılık geldiği kısmını tanımlar.

Videonun bir kısmının, belirli bir video görünümünde birden fazla kez izlenebileceğini (veya hiç izlenmediğini) unutmayın. Örneğin, kullanıcılar bir videonun aynı bölümünü birden fazla kez sarar ve izlerse videonun ilgili bölümünün mutlak oranı 1 değerinden fazla olabilir.

Aşağıdaki örnekler, değerin nasıl hesaplandığını göstermektedir:
  • Bir dakikalık video 100 kez izlenir. İzleyicilerin yarısı 15 saniye sonra videoyu izlemeyi bırakır, geri kalanı ise videonun tamamını izler. İzleyicilerin hiçbiri videonun herhangi bir bölümünü birden fazla kez izlememiştir. Bu durumda bu metriğin değeri, videonun ilk çeyreğindeki zaman grupları için 1 ve videonun geri kalanı için 0.50 olur.
  • Bir dakikalık video 100 kez izlenir. Tüm izleyiciler videonun tamamını izler ancak izleyicinin 20'si videonun 45 saniyelik işaretine kadar videoyu izler, ardından videonun 30 saniye işaretine döner ve videonun geri kalanını izler. Bu durumda metriğin değeri, videonun ilk yarısı veya son çeyreğindeki zaman grupları için 1 olur. Bununla birlikte, izleyicilerin %100'ü videonun bu bölümünü izlediği ancak bu izleyicilerin %20'sinin segmenti iki kez izlediği için videonun üçüncü çeyreğindeki zaman grupları için değer 1.2 olur.
göreli elde tutma performansı
Benzer uzunluktaki tüm YouTube videolarına kıyasla oynatma sırasında videonun izleyicileri elde tutma konusunda ne kadar başarılı olduğunu gösteren ölçüm. Metrik, videonun belirli bir noktasında göreli elde tutma performansını tanımlayan 0 ve 1 değerleri içerir. Videodaki nokta elapsedVideoTimeRatio boyutu tarafından sağlanır.

0 değeri, videonun benzer uzunluktaki diğer videolara göre daha kötü bir izleyici sayısını elde ettiğini gösterir. 1 değeri ise videonun, benzer uzunluktaki diğer videolara kıyasla daha iyi olduğunu gösterir. 0.5 değeri ortanca değeri, benzer uzunluktaki videoların yarısının daha iyi, diğer yarısının ise daha kötü performans gösterdiğini belirtir.

Aşağıdaki varsayımsal örnek, değerlerin bir raporda nasıl görünebileceğini göstermektedir. Ortalama olarak 10 dakikalık videoları izleyenlerin %90'ı üç dakika sonra, %70'i ise sekiz dakika sonra izlemeye devam ediyor. Bununla birlikte, 10 dakikalık belirli bir videoda izleyicilerin yalnızca %80'i üç dakika sonra izlemeye devam eder, ancak bu izleyicilerin tamamı sekiz dakika sonra izlemeye devam eder.
  • Videonun üç dakikasına karşılık gelen noktaya karşılık gelen elapsedVideoTimeRatio değerinde, relativeRetentionPerformance metriğinin 0.5 değerinin altında olması gerekir. Bu durumda video, ortalama videodan daha kötü performans gösterir.
  • Videoda sekiz dakikaya kadar olan noktaya karşılık gelen elapsedVideoTimeRatio değerinde, relativeRetentionPerformance metriğinin 0.5 değeri daha yüksek olur. Bunun nedeni, videonun benzer uzunluktaki diğer videolardan daha iyi performans göstermesidir.

Tahmini gelir metrikleri

Not: Tahmini gelir metrikleri ay sonu düzenlemelerine tabidir ve iş ortağı tarafından satılan ve iş ortağı tarafından sunulan reklamları içermez. Tahmini gelir rakamlarıyla ilgili daha fazla bilgi ve not için lütfen YouTube Yardım Merkezi'ne bakın.

Varsayılan olarak, tüm tahmini gelir rakamları ABD doları olarak raporlanır. Ancak YouTube Analytics API'si, bazı tahmini gelir ve reklam performansı metrikleri için currency parametresini destekler. Böylece, tahmini gelir verilerini diğer para birimlerinde almanıza olanak tanır.
estimatedRevenue (temel metrik) (eski adıyla earnings)
Seçilen tarih aralığı ve bölge için Google tarafından satılan tüm reklam kaynaklarından ve reklam dışı kaynaklardan elde edilen toplam tahmini net gelir. This is a core metric and is subject to the Deprecation Policy.

Tahmini gelir metriklerinde ay sonu düzenlemesi uygulanır ve iş ortağı tarafından satılan ve sunulan reklamları içermez.
estimatedAdRevenue (eski adıyla adEarnings)
Seçilen tarih aralığı ve bölge için Google tarafından satılan tüm reklam kaynaklarından elde edilen tahmini toplam net gelirdir.

Tahmini gelir metriklerinde ay sonu düzenlemesi uygulanır ve iş ortağı tarafından satılan ve sunulan reklamları içermez.
estimatedRedPartnerRevenue (eski adıyla redPartnerRevenue)
Seçilen rapor boyutları için YouTube Premium (önceki adıyla YouTube Red) aboneliklerinden elde edilen toplam tahmini gelir. Metriğin değeri hem müzik hem de müzik harici içeriklerden elde edilen geliri yansıtır ve ay sonu ayarlamasına tabidir.

Reklam performansı metrikleri

brütGelir
Seçilen tarih aralığı ve bölge için Google tarafından veya DoubleClick iş ortağı tarafından satılan tüm reklamlardan elde edilen tahmini brüt gelir (ABD doları cinsinden). Brüt gelir, her ayın sonunda düzenlenir ve iş ortağı tarafından sunulan reklamları içermez. Brüt gelir, tahmini gelirle veya net gelirle karıştırılmamalıdır. Bu gelir, sahiplik payınızı ve gelir paylaşımı sözleşmelerinizi hesaba katar.
bgbm (eski adıyla impressionBasedCpm)
Bin reklam gösterimi başına tahmini brüt gelir.
adGösterimler (eski adıyla impressions)
Yayınlanan doğrulanmış reklam gösterimlerinin sayısı.
para kazanılan oynatmalar
İzleyicinin videonuzu oynattığı ve en az bir reklam gösteriminin gösterildiği durumların sayısı. İzleyiciye videodan önce gösterilen reklam gösterilir ancak videonuz başlamadan önce reklamdan ayrılırsa bu, para kazanılan bir oynatma olarak sayılır. Bu rakam için beklenen tahmini hata ~%2,0'dır.
oynatmaya Dayalı BGBM
Bin oynatma başına tahmini brüt gelir.