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ği, reklam performansı veya tahmini gelirle ilgili bağımsız ölçümlerdir. Kullanıcı etkinliği metrikleri arasında video görüntüleme sayısı ve puanlar (beğenme ve beğenmeme) gibi metrikler yer alır.

Temel metrikler

YouTube Analytics API, Hizmet Şartları'nda tanımlanan Kullanımdan Kaldırma Politikası'na tabidir. Ancak temel olmayan metrikler (ve temel olmayan boyutlar) bu politikaya tabi değildir. Bu sayfada yer alan tanımlarda, temel metrik olan tüm metrikler açıkça belirtilir.

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

Daha fazla bilgi için Destek Sonlandırma Politikası'na tabi YouTube API'lerinin listesine bakın.

Metrikleri göster

engagedViews (temel metrik)
Videonun en az 4 saniye boyunca görüntülenme sayısı.
görüntülemeler (temel metrik)
Bu metrik, farklı rapor türlerinde farklı sayıları temsil eder. 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ı.
viewerPercentage (temel metrik)
Videoyu veya oynatma listesini izlerken oturum açmış olan 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 listesindeki videoları izleme süresi. This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
YouTube Premium (eski adıyla YouTube Red) üyelerinin bir videoyu izleme süresi.
averageViewDuration (temel metrik)
Video oynatmalarının saniye cinsinden ortalama uzunluğu. 13 Aralık 2021 itibarıyla bu metrik, döngü halinde oynatılan klipler trafiğini hariç tutar. Oynatma listesi raporunda bu metrik, oynatma listesi bağlamında gerçekleşen video oynatma işlemlerinin ortalama uzunluğunu (saniye cinsinden) gösterir. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
Video oynatımı sırasında videonun ortalama izlenme yüzdesidir. 13 Aralık 2021 itibarıyla bu metrik, döngü halinde oynatılan klipler trafiğini hariç tutar.

Etkileşim metrikleri

yorum (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ğeniler (temel metrik)
Kullanıcıların bir videoya olumlu puan vererek 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 bir videoya olumsuz puan vererek videoyu beğenmediklerini belirtme sayısı. This is a core metric and is subject to the Deprecation Policy.
paylaşım (temel metrik)
Kullanıcıların Share düğmesini kullanarak bir videoyu 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.
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örünen kılavuz dahil olmak üzere çeşitli yerlerde abone kazanabilir veya kaybedebilir. Kanal raporlarında bu metrik, bu yerlerden elde edilen aboneleri içerir. Ancak yanıtı yalnızca belirli bir videoya ait 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 kanaldan aboneliğini iptal etme sayısı. This is a core metric and is subject to the Deprecation Policy.

Bu metrik için veriler, subscribersGained metriğine benzer şekilde raporlanır. Kanal raporlarında bu metrik, kullanıcıların kanal aboneliğinden çıkabileceği herhangi bir mekanizmayla kaybedilen aboneleri içerir. Ancak, yanıtı yalnızca belirli bir videoya ait 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ğini iptal eden kullanıcıları içerir.
videosAddedToPlaylists
Videoların YouTube oynatma listelerine eklenme sayısı. 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 bir videonun otomatik olarak eklendiği oynatma listeleri (ör. kanalın yüklemeler oynatma listesi veya kullanıcının izleme geçmişi) bu metriğe dahil edilmez.

Bu metrik mutlak bir sayı döndürür. Yani bir kullanıcı bir videoyu oynatma listesine ekleyip kaldırdıktan sonra tekrar eklerse metrik değeri, videonun oynatma listesine iki kez eklendiğini gösterir. Bu metrik için 1 Ekim 2014'ten önceki tarihlere ait veriler 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 izle" oynatma listesi gibi varsayılan oynatma listelerinden kaç kez kaldırıldığını içerir.

Bu metrik mutlak bir sayı döndürür. Yani bir kullanıcı bir videoyu oynatma listesine ekleyip kaldırdıktan sonra tekrar ekleyip tekrar kaldırırsa metrik değeri, videonun oynatma listesinden iki kez kaldırıldığını gösterir. Bu metrik için 1 Ekim 2014'ten önceki tarihlere ait veriler kullanılamaz.

Oynatma listesi metrikleri

Oynatma listesi raporları, izleyicilerin oynatma listesindeki videolarla nasıl etkileşime geçtiğini açıklayan iki tür metrik içerir:

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

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

  • Oynatma listesi metrikleri, 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.

Aşağıdaki metriklerin çoğu oynatma listesi içi metriklerdir. Listedeki diğer metrikler (ör. playlistSaves metriği) kullanıcıların oynatma listesindeki videolarla değil, oynatma listesiyle olan etkileşimleriyle ilgilidir. Bu nedenle, bu metrikler toplu video metrikleri veya oynatma listesi metrikleri olarak nitelendirilmez.

averageTimeInPlaylist
Oynatma listesi başlatıldıktan sonra izleyicinin oynatma listesindeki videoları izlediği tahmini ortalama süre (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 tahmini ortalama izlenme süresi (saniye cinsinden). Bu metriğin, oynatma listesindeki videoların görüntülemelerinin ortalama süresini temsil ettiğini, averageTimeInPlaylist metriğinin ise her izleyicinin oynatma listesini bir bütün olarak izlemek için harcadığı ortalama süreyi temsil ettiğini unutmayın. 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 listesinin bir parçası olarak izledikleri dakika sayısı. Diğer bağlamlarda gerçekleşen izlenme süreleri (ör. izleyiciler aynı videoyu diğer oynatma listelerinin parçası olarak 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 kaydetme sayısı. Kayıtlı oynatma listeleri hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne göz atın. Bu metrik, net bir değişiklik sayısı döndürür. Yani bir kullanıcı bir oynatma listesini kaydedip kayıtlı oynatma listeleri listesinden kaldırıp tekrar kaydederse metrik değeri, bir oynatma listesi kaydının eklendiğini gösterir.
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, oynatma listesi bağlamında görüntülenme sayısı. Bu metrik, diğer kanallara ait oynatma listesi videolarının verilerini içerir.
viewsPerPlaylistStart
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.

Ek açıklama metrikleri

Not: YouTube Analytics API raporları yalnızca 10 Haziran 2012'den itibaren annotationClickThroughRate ve annotationCloseRate metrikleri için veri döndürür. Ayrıca, YouTube Analytics API raporları yalnızca 16 Temmuz 2013 itibarıyla kalan ek açıklama metriklerinin verilerini döndürür.

annotationImpressions
Ek açıklama gösterimlerinin toplam sayısı.
annotationClickableImpressions
Görüntülenen ve tıklanabilen ek açıklamaların sayısı.
annotationClicks
Tıklanan ek açıklamaların sayısı.
annotationClickThroughRate (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. Not ekleme ve bağlantı notlarını kullanma hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.
annotationClosableImpressions
Görüntülenen ve kapatılabilen ek açıklamaların sayısı.
annotationCloses
Kapatılan ek açıklama sayısı.
annotationCloseRate (temel metrik)
İzleyicilerin kapattığı ek açıklamaların toplam ek açıklama gösterim sayısına oranı. This is a core metric and is subject to the Deprecation Policy.

Kart metrikleri

Videolarınıza kart ekleme ve YouTube Analytics Kartlar Raporu hakkında daha ayrıntılı talimatlar için YouTube Yardım Merkezi'ni ziyaret edin.

cardImpressions
Kartların gösterilme sayısı. Kart paneli açıldığında videodaki her kart için bir kart gösterimi kaydı girilir.
cardClicks
Kartların tıklanma sayısı.
cardClickRate
Kartların tıklama oranıdır. Kart tıklama sayısının kart gösterim sayısına oranını belirtir.
cardTeaserImpressions
Kart bilgilerinin görüntülenme sayısı. Bir video görüntüleme birden fazla bilgi gösterimi oluşturabilir.
cardTeaserClicks
Kart bilgilerinin tıklanma sayısı. Kart simgesini tıklama sayısı, kullanıcıya gösterilen son bilgiyle ilişkilendirilir.
cardTeaserClickRate
Kart bilgilerinin tıklama oranı. Kart bilgilerinin tıklama sayısının toplam kart bilgisi gösterim sayısına oranını belirtir.

Canlı yayın metrikleri (anlık izleyici sayısı)

averageConcurrentViewers
Belirli bir videonun aynı anda izleyen ortalama kullanıcı sayısı. Rapor için livestreamPosition boyutu belirtilirse averageConcurrentViewers değeri, belirli bir segmentteki eşzamanlı izleyici sayısını belirtir
.
peakConcurrentViewers
Belirli bir videonun aynı anda izleyen kullanıcılarının en yüksek sayısı. Rapor için livestreamPosition boyutu belirtilmişse peakConcurrentViewers değeri, videonun belirli bir segmentinde eşzamanlı izleyici sayısının en yüksek değerini belirtir.

Kitleyi elde tutma metrikleri

audienceWatchRatio
Videonun belirli bir noktasında videoyu izleyen izleyici sayısının videonun toplam izleyici sayısına oranı. Bu oran, videonun bir kısmının izlenme sayısının videonun toplam görüntüleme sayısına bölünmesiyle hesaplanır. elapsedVideoTimeRatio boyutu, metriğin videonun hangi bölümüne karşılık geldiğini tanımlar.

Bir videonun belirli bir bölümünden birden fazla kez (veya hiç) görüntüleme elde edilebileceğini unutmayın. Örneğin, kullanıcılar bir videonun aynı bölümünü geri sararak birden fazla kez izliyorsa videonun bu bölümüne ait mutlak oran 1'ten yüksek olabilir.

Aşağıdaki örneklerde değerin nasıl hesaplandığı gösterilmektedir:
  • Bir dakikalık bir video 100 kez izlenir. İzleyicilerin yarısı 15 saniye sonra izlemeyi bırakırken geri kalanı videonun tamamını izler. İzleyicilerin hiçbiri videonun bölümlerini birden fazla kez izlemez. Bu durumda, bu metriğin değeri videonun ilk çeyreğindeki zaman kapsülleri için 1, videonun geri kalanı için ise 0.50 olur.
  • Bir dakikalık bir video 100 kez izlenir. Tüm izleyiciler videonun tamamını izler ancak 20 izleyici videonun 45. saniyesine kadar izler, ardından videonun 30. saniyesine geri atlar ve videonun geri kalanını izler. Bu durumda, videonun ilk yarısı veya son çeyreğindeki zaman kapsülleri için metriğin değeri 1 olur. Ancak izleyicilerin yüzde 100'ü videonun bu segmentini izlediğinden ve bu izleyicilerin yüzde 20'si segmenti iki kez izlediğinden, videonun üçüncü çeyreğindeki zaman kapsülleri için değer 1.2 olur.
relativeRetentionPerformance
Benzer uzunluktaki tüm YouTube videolarına kıyasla, bir videonun oynatma sırasında izleyicileri ne kadar iyi tuttuğunu gösteren ölçüm. Bu metrik, videonun belirli bir noktasındaki göreceli izleme performansını tanımlayan 0 ile 1 arasında bir değere sahiptir. Videodaki nokta, elapsedVideoTimeRatio boyutu tarafından sağlanır.

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

Aşağıdaki varsayımsal örnekte, değerlerin bir raporda nasıl görünebileceği gösterilmektedir. 10 dakikalık videoları izleyen izleyiciler, videonun üç dakikası dolduktan sonra ortalama yüzde 90'ı, sekiz dakikası dolduktan sonra ise ortalama yüzde 70'i videoyu izlemeye devam ediyor. Ancak 10 dakikalık bir videoda, üç dakika sonra izleyici sayısının yalnızca yüzde 80'i videoyu izlemeye devam ediyor. Ancak bu izleyicilerin tamamı sekiz dakika sonra videoyu izlemeye devam ediyor.
  • Videonun üç dakikalık bölümüne karşılık gelen elapsedVideoTimeRatio değerinde, relativeRetentionPerformance metriği 0.5 değerinin altında bir değere sahip olur. Bunun nedeni, videonun o sırada ortalama videodan daha kötü performans göstermesidir.
  • Videonun sekiz dakikalık bölümüne karşılık gelen elapsedVideoTimeRatio değerinde, relativeRetentionPerformance metriği 0.5 değerinden daha yüksek bir değere sahip olur. Bunun nedeni, videonun o sırada benzer uzunluktaki diğer videolardan daha iyi performans göstermesidir.
startedWatching
Videonun belirli bir segmentinin, video oynatıldığında ilk segment olarak görüntülenme sayısı.

Örneğin, X videosunun 5 dakika uzunluğunda olduğunu varsayalım. YouTube, bu rapor için videoyu elapsedVideoTimeRatio boyutuyla tanımlanan 100 adet 3 saniyelik segmente böler. Bir izleyici YouTube'u ziyaret eder ve videonun ilk bir dakika on saniyesini (videonun ilk 24 segmentinin tamamını veya bir kısmını içeren) izler. İzleyici, sonraki bir YouTube ziyaretinde videonun geri kalanını izler. Oynatma işlemini 24. segmentten başlatır ve 100. segmente kadar devam eder.

Bu örnekte, izleme metriği değerleri şu şekilde olur:
  • startedWatching metriğinin değeri 1 ve 24 numaralı segmentler için 1, diğer tüm segmentler için ise 0 olur.
  • stoppedWatching metriğinin değeri 24 ve 100 segmentleri için 1, diğer tüm segmentler için ise 0 olur.
  • totalSegmentImpressions metriğinin değeri 24. segment için 2, diğer tüm segmentler için ise 1 olur.
stoppedWatching
Videonun belirli bir segmentinin, video oynatılırken son segment olarak görülme sayısı. Bu metrik değerinin nasıl hesaplandığına dair bir örnek için startedWatching metriğinin tanımına bakın.
totalSegmentImpressions
Videonun belirli bir segmentinin görüntülenme sayısı. Bu metrik değerinin nasıl hesaplandığına dair bir örnek için startedWatching metriğinin tanımına bakın. İzleyicilerin, aynı video segmentini aynı oynatma işleminde birden çok kez izleyebileceğini unutmayın.

Üyelik iptal metrikleri

membershipsCancellationSurveyResponses
Raporlama döneminde belirtilen kanalın kanal üyeliğini iptal eden YouTube kullanıcılarının doldurduğu anketlerin sayısı.

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ıyla ilgili ek bilgi ve notlar için YouTube Yardım Merkezi'ne bakın.

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

Tahmini gelir metrikleri ay sonunda düzenlemeye tabi tutulur 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 reklamcılık kaynaklarından elde edilen toplam tahmini net gelir.

Tahmini gelir metrikleri ay sonu düzenlemesine tabidir ve iş ortağı tarafından satılan ve iş ortağı tarafından 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. Metrik değeri hem müzik hem de müzik dışı içeriklerden elde edilen geliri yansıtır ve ay sonu düzenlemesine tabidir.

Reklam performansı metrikleri

grossRevenue
Seçilen tarih aralığı ve bölge için Google tarafından satılan 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, sahiplik payınızı ve gelir paylaşımı sözleşmelerinizi hesaba katan tahmini gelir veya 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ı.
monetizedPlaybacks
Bir izleyicinin videonuzu oynattığı ve en az bir reklam gösterimi gösterildiği durumların sayısı. Bir izleyiciye videodan önce gösterilen reklam gösterilir ancak izleyici videonuz başlamadan önce reklamı izlemeyi bırakırsa para kazanılan oynatma olarak sayılır. Bu rakam için beklenen tahmini hata ±%2,0'dir.
playbackBasedCpm
Bin oynatma başına tahmini brüt gelir.