Metrics

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

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

Temel metrikler

YouTube Analytics API, Hizmet Şartları'nda tanımlanan Kullanımdan Kaldırma Politikası'na tabi olsa da temel olmayan metrikler (ve temel olmayan boyutlar) bu politikaya tabi değildir. Bu sayfadaki tanımlarda, temel metrik olan herhangi bir metrik açıkça bu şekilde belirtilmiştir.

Aşağıdaki listede API'nin temel metrikleri tanımlanmaktadır.

Not: Aşağıdaki temel metrikler tamamen kullanımdan kaldırılmıştır:
  • earnings temel metriği, 4 Ağustos 2016 tarihinde kullanımdan kaldırılarak estimatedRevenue olarak yeniden adlandırıldı. Hizmet Şartları'nda tanımlanan Kullanımdan Kaldırma Politikası uyarınca earnings ve estimatedRevenue metrikleri 10 Ağustos 2017'ye kadar eşzamanlı olarak desteklendi.
  • favoritesAdded ve favoritesRemoved temel metrikleri 31 Mart 2015 tarihinde kullanımdan kaldırılmıştır. Bu metrikler yalnızca YouTube Analytics API aracılığıyla alınabilir.

Daha fazla bilgi için Kullanımdan Kaldırma Politikası'na tabi YouTube API'lerinin listesine bakın.

Metrikleri görüntüleyin

görüntüleme sayısı (temel metrik)
Bu metrik, farklı rapor türlerinde farklı sayıları temsil eder:
  • Video raporlarında bu metrik, bir videonun görüntülenme sayısını belirtir.
  • isCurated boyutunu kullanmayan oynatma listesi raporlarında bu metrik, görüntülemelerin oynatma listesi bağlamında gerçekleşip gerçekleşmediğinden bağımsız olarak oynatma listesindeki videoların toplam görüntüleme sayısını belirtir. Metrik değerinin yalnızca kanal sahibinin videolarının görüntüleme sayısını içerdiğini unutmayın.

    Bu raporlardaki playlistViews metriği, oynatma listesi videolarının belirli bir oynatma listesi bağlamında kaç kez görüntülendiğini belirtir.
  • isCurated boyutunu kullanan oynatma listesi raporlarında bu metrik, videoların belirli bir oynatma listesi bağlamında görüntülenme sayısını belirtir. Bu raporlarda playlistViews metriğinin desteklenmediğini unutmayın.
This is a core metric and is subject to the Deprecation Policy.
playlistViews
Bu metrik, oynatma listesi metrikleri bölümünde tanımlanır.
redViews
Bir videonun YouTube Premium (eski adıyla YouTube Red) üyeleri tarafından görüntülenme sayısı.
uniques (27 Eylül 2016'da kullanımdan kaldırıldı)
Bir videoyu izleyen tekil izleyici sayısıdır. Bu hesaplama benzersiz çerezlerin sayısına göre yapılır ve bu nedenle birden fazla cihaz veya tarayıcı kullanan kullanıcıları fazla sayar.
uniques metriği 27 Eylül 2016 tarihinde kullanımdan kaldırılmıştır. Temel bir metrik değildir ve 31 Ekim 2016 tarihine kadar desteklenecektir.
viewerPercentage (temel metrik)
Videoyu veya oynatma listesini izlerken giriş yapan izleyicilerin yüzdesidir. 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ıdır. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
YouTube Premium (eski adıyla YouTube Red) üyelerinin bir videoyu izlediği dakika sayısı.
averageViewDuration (temel metrik)
Video oynatmalarının saniye cinsinden ortalama uzunluğu. 13 Aralık 2021 tarihinden itibaren bu metrik, klipleri döngüye alma trafiğini hariç tutacaktır. Oynatma listesi raporundaki bu metrik, oynatma listesi bağlamında gerçekleşen video oynatmalarının saniye cinsinden ortalama uzunluğunu belirtir. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
Bir videonun, video oynatılırken ortalama izlenme yüzdesi. 13 Aralık 2021 tarihinden itibaren bu metrik, klipleri döngüye alma trafiğini hariç tutacaktır.

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'ne göz atın. This is a core metric and is subject to the Deprecation Policy.
beğeni sayısı (temel metrik)
Kullanıcıların bir videoyu olumlu oy vererek 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 bir videoyu olumsuz puan vererek beğenmediklerini belirtme sayısı. This is a core metric and is subject to the Deprecation Policy.
paylaşımlar (temel metrik)
Kullanıcıların Share düğmesi üzerinden video paylaşma sayısı. Daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın. This is a core metric and is subject to the Deprecation Policy.
subscribersGained (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österilen rehber gibi birçok yerde abone kazanabilir veya kaybedebilir. Kanal raporlarında bu metrik, bu yerlerin herhangi birinden elde edilen aboneleri içerir. Ancak yanıtı yalnızca belirli bir videoya ilişkin verileri 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 bir kanaldaki aboneliklerini iptal etme sayısı. This is a core metric and is subject to the Deprecation Policy.

Bu metriğin verileri, subscribersGained metriğiyle benzer şekilde raporlanır. Kanal raporlarında bu metrik, kullanıcıların kanal aboneliğinden çıkmak için kullandığı mekanizmalar üzerinden kaybedilen aboneleri içerir. Ancak yanıtı yalnızca belirli bir videoya ilişkin verileri içerecek şekilde kısıtlamak için video boyutunu veya filter parametresini kullanan raporlarda, bu metrik yalnızca belirtilen videonun izleme sayfasından aboneliği iptal eden kullanıcıları içerir.
videosAddedToPlaylists
Videoların herhangi bir YouTube oynatma listesine 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 içerir. Ancak kanalın yüklenen oynatma listesi veya kullanıcıların izleme geçmişi gibi videoların otomatik olarak eklendiği oynatma listelerini dahil etmez.

Bu metrik, mutlak sayı döndürür. Yani, bir kullanıcı bir videoyu oynatma listesine ekler, kaldırır ve sonra tekrar eklerse metrik değeri, oynatma listesine eklenen videoyu iki kez yansıtır. Bu metriğe ilişkin veriler 1 Ekim 2014'ten önceki tarihler için kullanılamaz.
videosRemovedFromPlaylists
Videoların herhangi bir YouTube oynatma listesinden kaldırılma sayısıdır. 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 kaç kez kaldırıldığını belirtir.

Bu metrik, mutlak bir sayı döndürür. Yani bir kullanıcı bir videoyu oynatma listesine ekler, sonra da tekrar ekler ve sonra tekrar kaldırırsa metrik değeri, oynatma listesinden iki kez kaldırılan videoyu yansıtır. Bu metriğe ilişkin veriler 1 Ekim 2014'ten önceki tarihler için kullanılamaz.

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

Aşağıdaki metriklerin her ikisi de 31 Mart 2015 tarihinde kullanımdan kaldırılan temel metriklerdir.

favoritesAdded (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'ne göz atın. This is a core metric and is subject to the Deprecation Policy.
favoritesRemoved (temel metrik) (31 Mart 2015'te kullanımdan kaldırılmıştır)
Kullanıcıların favori video listelerindeki bir videoyu kaldırma sayısı. Daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın. This is a core metric and is subject to the Deprecation Policy.

Oynatma listesi metrikleri

Oynatma listesi raporları, izleyicilerin bir oynatma listesindeki videolarla nasıl etkileşimde bulunduğunu açıklayan iki tür metrik içerir:

  • Toplu video metrikleri, 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.

    Desteklenen toplu video metriklerinin tanımları için bu belgenin görüntüleme metrikleri ve izlenme süresi metrikleri bölümlerine bakın.

  • Oynatma listesi içi metrikler, kullanıcı etkinliğini ve etkileşimi oynatma listesi sayfası bağlamında yansıtır. Bu metrikler, videoların sahibi olan kanaldan bağımsız olarak oynatma listesindeki tüm videoların izlenme sayısını içerir ancak yalnızca oynatma listesi bağlamında gerçekleşen görüntülemeleri sayar.

Aşağıda listelenen metriklerin çoğu oynatma listesi içi metriklerdir. Listede kalan metrikler (ör. playlistSaves metriği), oynatma listesindeki videolarla değil, oynatma listesinin kendisiyle olan kullanıcı etkileşimleriyle ilgilidir. Bu nedenle, bu metrikler toplu video metrikleri veya oynatma listesi içi metrik olarak nitelendirilmez.

averageTimeInPlaylist
Oynatma listesi başlatıldıktan sonra bir izleyicinin oynatma listesindeki videoları görüntülediği tahmini ortalama süredir (dakika cinsinden). Bu metriğin yalnızca web'de gerçekleşen oynatma listesi görüntülemelerini içerdiğini unutmayın.
playlistAverageViewDuration
Oynatma listesi görüntülemesi başına saniye cinsinden tahmini ortalama uzunluk. Bu metriğin, oynatma listesindeki her bir videonun ortalama görüntüleme uzunluğunu temsil ettiğini unutmayın. averageTimeInPlaylist metriği ise her izleyicinin oynatma listesini bir bütün olarak izlemek için harcadığı ortalama süreyi temsil eder. Bu metrik, diğer kanallara ait oynatma listesi videolarının verilerini içerir.
playlistEstimatedMinutesWatched
Kullanıcıların oynatma listesi içeriğini oynatma listesi kapsamında izlediği dakika sayısıdır. Diğer bağlamlarda gerçekleşen izlenme süresi (ör. izleyiciler aynı videoyu başka oynatma listeleri kapsamında izlerken gerçekleşen görüntülemelerden elde edilen izlenme süresi) sayılmaz. Bu metrik, diğer kanallara ait oynatma listesi videolarının verilerini içerir.
playlistSaves
Kullanıcıların bir oynatma listesini net olarak kaç kez kaydettiği. Kayıtlı oynatma listeleri hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne bakın. Bu metrik net değişiklik sayısı döndürür. Yani bir kullanıcı bir oynatma listesini kaydeder, kayıtlı oynatma listeleri listesinden kaldırır ve tekrar kaydederse metrik değeri, eklenen bir oynatma listesi kaydını yansıtır.
playlistStarts
İ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.
playlistViews
Oynatma listesindeki videoların ilgili oynatma listesi bağlamında izlenme sayısıdır. Bu metrik, diğer kanallara ait oynatma listesi videolarına ait verileri içerir.
viewsPerPlaylistStart
Oynatma listesi her başlatıldığında gerçekleşen ortalama video görüntüleme 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 metrikleri için veri döndürür. Ayrıca, YouTube Analytics API raporları yalnızca 16 Temmuz 2013 tarihinden itibaren kalan ek açıklama metrikleri için veri döndürür.

annotationImpressions
Ek açıklama gösterimlerinin toplam sayısıdır.
annotationClickableImpressions
Gösterilen ve tıklanabilen ek açıklamaların sayısı.
annotationClicks
Tıklanan ek açıklama sayısı.
annotationClickThroughRate (temel metrik)
İzleyicilerin tıkladığı ek açıklamaların toplam tıklanabilir ek açıklama gösterimi sayısına oranı. This is a core metric and is subject to the Deprecation Policy. YouTube Yardım Merkezi'nden ek açıklama oluşturma ve bağlantı ek açıklamalarını kullanma hakkında daha fazla bilgi edinebilirsiniz.
annotationClosableImpressions
Gösterilen ve kapatılabilecek ek açıklamaların sayısı.
annotationCloses
Kapalı ek açıklamaların sayısı.
annotationCloseRate (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 ile ilgili daha ayrıntılı talimatlar yer alır.

cardImpressions
Kartların gösterilme sayısı. Kart paneli açıldığında, videonun her bir kartı için bir kart gösterimi kaydedilir.
cardClicks
Kartların tıklanma sayısı.
cardClickRate
Kartlar için tıklama oranıdır. Kart tıklama sayısının kart gösterim sayısına oranı olarak hesaplanır.
cardTeaserImpressions
Kart bilgilerinin gösterilme sayısıdır. Bir video görüntülemesi, birden fazla teaser gösterimi oluşturabilir.
cardTeaserClicks
Kart bilgilerinin tıklanma sayısıdır. Kart simgesi tıklamaları, kullanıcıya gösterilen son bilgiyle ilişkilendirilir.
cardTeaserClickRate
Kart bilgileri için tıklama oranıdır. Kart bilgilerinin tıklanma sayısının, kart bilgisi gösterimlerinin toplam sayısına oranı olarak hesaplanır.

Kitleyi elde tutma metrikleri

audienceWatchRatio
Videoyu belirli bir noktada izleyen kullanıcıların mutlak oranı. Bu oran, videonun bir bölümünün izlenme sayısının toplam görüntülenme sayısıyla karşılaştırılmasıyla hesaplanır. elapsedVideoTimeRatio boyutu, videonun metriğin karşılık gelen bölümünü tanımlar.

Belirli bir video görüntülemesinde videonun bir bölümünün birden fazla kez izlenebileceğini (veya hiç izlenemediğini) unutmayın. Örneğin, kullanıcılar bir videoyu geri sarıp videonun aynı bölümünü birden çok kez izlerse videonun bu bölümünün mutlak oranı, 1 değerinden daha büyük olabilir.

Aşağıdaki örneklerde değerin nasıl hesaplandığı gösterilmektedir:
  • Bir dakikalık video 100 kez izlenir. İzleyicilerin yarısı 15 saniye sonra izlemeyi bırakırken kalanlar videonun tamamını izliyor. İzleyicilerin hiçbiri videonun hiçbir bölümünü birden fazla kez izlemez. Bu durumda, bu metriğin değeri videonun ilk çeyreğindeki zaman grupları için 1, geri kalanı için ise 0.50 olur.
  • Bir dakikalık video 100 kez izlenir. İzleyicilerin tümü videonun tamamını izliyor ancak 20 tanesi videonun 45. saniyesine kadar izliyor, ardından videonun 30. saniyesine kadar atlıyor ve videonun geri kalanını izliyor. Bu durumda metriğin değeri, videonun ilk yarısındaki veya son çeyreğindeki zaman grupları için 1 olur. Ancak izleyicilerin %100'ü video segmentini iki kez izlerken bu segmentlerin %20'si segmenti iki kez izlediği için değer, videonun üçüncü çeyreğinde zaman aralıkları için 1.2 olur.
relativeRetentionPerformance
Bir videonun, benzer uzunluktaki tüm YouTube videolarına kıyasla oynatma sırasında izleyicileri ne kadar iyi elde tuttuğunu gösteren ölçüm. Metrik, 0 ile 1 arasında bir değere sahiptir. Bu değer, videonun belirli bir noktasındaki göreli elde tutma performansını tanımlar. Videodaki nokta, elapsedVideoTimeRatio boyutu tarafından sağlanır.

0 değeri videonun izleyicileri benzer uzunluktaki diğer tüm videolardan daha kötü şekilde elde tuttuğunu; 1 değeri ise videonun benzer uzunluktaki diğer tüm videolardan daha iyi korunduğunu ifade eder. 0.5 ortanca değeri, benzer uzunluktaki videoların yarısının izleyicileri daha iyi tutarken yarısının daha kötü izleyicileri elde tuttuğunu gösterir.

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 yüzde 90'ı üç dakika sonra izlemeye devam ederken yüzde 70'i sekiz dakika sonra izlemeye devam ediyor. Ancak 10 dakikalık belirli bir videoyu izleyenlerin yalnızca yüzde 80'i üç dakika sonra izlemeye devam ediyor. Ancak tüm bu izleyiciler sekiz dakika sonra izlemeye devam ediyor.
  • Videonun üçinci dakikasına karşılık gelen elapsedVideoTimeRatio değerinde relativeRetentionPerformance metriği 0.5 altında bir değere sahip olur çünkü bu sırada video ortalama videodan daha kötü performans gösterir.
  • Videonun sekiz dakikasına karşılık gelen elapsedVideoTimeRatio değerinde relativeRetentionPerformance metriği, 0.5 değerinden daha yüksek bir değere sahip olur çünkü bu sırada video, benzer uzunluktaki diğer videolardan daha iyi performans gösterir.

Tahmini gelir metrikleri

Not: Tahmini gelir metrikleri, ay sonu düzenlemelerine tabidir ve iş ortağı tarafından satılan ve sunulan reklamları içermez. Tahmini gelir rakamları hakkında ek bilgi ve notlar için lütfen YouTube Yardım Merkezi'ni ziyaret edin.

Varsayılan olarak, tüm tahmini gelir rakamları ABD doları cinsinden raporlanır. Bununla birlikte YouTube Analytics API, bazı tahmini gelir ve reklam performansı metrikleri için currency parametresini destekleyerek 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ının yanı sıra reklam dışı kaynaklardan elde edilen toplam tahmini net gelir. This is a core metric and is subject to the Deprecation Policy.

Tahmini gelir metrikleri ay sonunda düzenlemeye tabidir. İş ortakları tarafından satılan ve sunulan reklamlar dahil değildir.
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 toplam tahmini net gelir.

Tahmini gelir metrikleri ay sonunda düzenlemeye tabidir 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 (eski adıyla YouTube Red) aboneliklerinden elde edilen toplam tahmini gelirdir. Bu metriğin değeri, hem müzik hem de müzik dışı içeriklerden elde edilen geliri yansıtır ve ay sonu ayarlamasına tabidir.

Reklam performansı metrikleri

grossRevenue
Seçilen tarih aralığı ve bölge için Google 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 ya da sahiplik payınıza ya da gelir paylaşımı sözleşmelerinize dahil edilen net gelirle karıştırılmamalıdır.
cpm (eski adıyla impressionBasedCpm)
Bin reklam gösterimi başına tahmini brüt gelirdir.
adImpressions (eski adıyla impressions)
Yayınlanan doğrulanmış reklam gösterimlerinin sayısıdır.
monetizedPlaybacks
Bir izleyicinin 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 reklamı izlemeyi bırakırsa bu, para kazanılan oynatma sayılır. Bu değer için beklenen tahmini hata ±%2'dir.
playbackBasedCpm
Bin oynatma başına tahmini brüt gelirdir.