Metrics

Bu dokümanda, 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 gelirin ayrı ayrı ölçümleridir. Kullanıcı etkinliği metrikleri, video görüntüleme sayıları ve derecelendirmeler (beğenme ve beğenmeme) gibi bilgileri 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 tüm metrikler açıkça belirtilmiştir.

Aşağıdaki listede API'nin temel metrikleri belirtilmiştir.

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

Metrikleri göster

engagedViews (temel metrik)
Kanalın videolarının ilk kareden sonraki izlenme sayısı veya kullanıcının oynatmak için tıklama/dokunma sayısı.
görüntüleme sayısı (temel metrik)
Bu metrik, farklı rapor türlerinde farklı sayıları temsil eder. Bu metrik, birden fazla kişi televizyon ekranında birlikte izlediğinde birlikte izleme sayısını içerir. This is a core metric and is subject to the Deprecation Policy.
playlistViews
Bu metrik, oynatma listesi metrikleri bölümünde tanımlanmıştı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 giriş yapmış 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 listesi için videoları izlediği dakika sayısı. Bu metrik, birden fazla kişinin televizyon ekranında birlikte izlediği ortak görüntülemeleri içerir. 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 itibarıyla bu metrik, döngüsel kliplerden gelen trafiği hariç tutmaktadır. Oynatma listesi raporunda bu 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.
averageViewPercentage
Bir videonun oynatılması sırasında ortalama izlenme yüzdesi. 13 Aralık 2021 itibarıyla bu metrik, döngüsel kliplerden gelen trafiği hariç tutar.

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 atabilirsiniz. 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 sayısı (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'ne göz atabilirsiniz. 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 rehber dahil olmak üzere çeşitli yerlerde abone kazanabilir veya kaybedebilir. Kanal raporlarında bu metrik, bu yerlerin 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ından alınan istatistikleri içerir.
subscribersLost (temel metrik)
Kullanıcıların bir kanalın aboneliğinden çıkma sayısıdır. 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 bir kanalın aboneliğinden çıkabileceği tüm mekanizmalar aracılığıyla 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ından abonelikten çıkan kullanıcıları içerir.
videosAddedToPlaylists
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" gibi varsayılan oynatma listelerine eklenme sayısını içerir. Ancak videoların otomatik olarak eklendiği oynatma listeleri (ör. bir kanalın yüklemeler oynatma listesi veya bir kullanıcının izleme geçmişi) hesaba katılmaz.

Bu metrik mutlak bir sayı döndürür. Yani bir kullanıcı bir videoyu oynatma listesine ekler, kaldırır ve tekrar eklerse metrik değeri, videonun oynatma listesine iki kez eklendiğini yansıtır. Bu metriğe ait veriler, 1 Ekim 2014'ten önceki tarihler için mevcut değildir.
videosRemovedFromPlaylists
Videoların YouTube oynatma listelerinden 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 kaldırılma sayısını içerir.

Bu metrik mutlak bir sayı döndürür. Yani bir kullanıcı bir videoyu oynatma listesine ekler, kaldırır, tekrar ekler ve tekrar kaldırırsa metrik değeri, videonun oynatma listesinden iki kez kaldırıldığını yansıtır. Bu metriğe ait veriler, 1 Ekim 2014'ten önceki tarihler için mevcut değildir.

Oynatma listesi metrikleri

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

  • Toplu video metrikleri, oynatma listesindeki tüm videolar için toplanan kullanıcı etkinliği ve gösterim metriklerini sağlar. Bu videolar, oynatma listesinin sahibi olan kanala aittir. Diğer kanallara ait videoların metrikleri, toplama işlemine dahil edilmez. Bu nedenle, 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ı için bu belgenin görüntüleme metrikleri ve izlenme süresi metrikleri bölümlerine bakın.

  • Oynatma listesi içi metrikler, oynatma listesi sayfası bağlamında kullanıcı etkinliğini ve etkileşimini yansıtır. Bu metrikler, hangi kanala ait olduğuna bakılmaksızın 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ının oynatma listesindeki videolarla değil, oynatma listesinin kendisiyle olan etkileşimleriyle ilgilidir. Bu nedenle, bu metrikler toplu video metrikleri veya oynatma listesi içi metrikler olarak tanımlanmaz.

averageTimeInPlaylist
Bir 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 saniye cinsinden tahmini ortalama izlenme süresini gösterir. Bu metriğin, bir oynatma listesindeki videoların ortalama görüntülenme süresini 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 listesinin bir parçası olarak izlediği dakika sayısı. Diğer bağlamlarda gerçekleşen izlenme süresi (ör. izleyiciler aynı videoyu diğer oynatma listelerinin bir 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ının net değeri. Kayıtlı oynatma listeleri hakkında daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin. Bu metrik, net değişiklik sayısını döndürür. Yani bir kullanıcı bir oynatma listesini kaydeder, kaydedilen oynatma listeleri listesinden kaldırır ve tekrar kaydederse metrik değeri, bir oynatma listesi kaydının eklendiğini 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, oynatma listesi bağlamında görüntülenme sayısıdır. Bu metrik, diğer kanallara ait oynatma listesi videolarıyla ilgili verileri içerir.
viewsPerPlaylistStart
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.

Not 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ı 16 Temmuz 2013 itibarıyla yalnızca kalan ek açıklama metriklerine ait verileri döndürür.

annotationImpressions
Notların toplam gösterim sayısı.
annotationClickableImpressions
Gösterilen 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 oluşturma ve bağlantı notlarını kullanma hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.
annotationClosableImpressions
Gösterilen ve kapatılabilen ek açıklamaların sayısı.
annotationCloses
Kapatılan ek açıklamaların 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

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

cardImpressions
Kartların gösterilme sayısıdır. 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ın tıklama oranı. Kart tıklama sayısının kart gösterim sayısına oranı olarak hesaplanır.
cardTeaserImpressions
Kart bilgilerinin gösterilme sayısı. Bir video görüntüleme, birden fazla bilgi gösterimi oluşturabilir.
cardTeaserClicks
Kart bilgilerinin tıklanma sayısı. Kart simgesi tıklamaları, 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ı olarak hesaplanır.

Canlı yayın metrikleri (eşzamanlı izleyici sayısı)

averageConcurrentViewers
Belirli bir videonun ortalama eşzamanlı izleyici sayısı. Bu metrik, birden fazla kişi televizyon ekranında birlikte izlediğinde birlikte izleyenleri içerir. Rapor için livestreamPosition boyutu belirtilmişse averageConcurrentViewers değeri, belirli bir segmentteki ortalama eşzamanlı izleyici sayısını belirtir
.
peakConcurrentViewers
Belirli bir videonun aynı anda izleyen kullanıcı sayısının ulaştığı en yüksek değerdir. Bu metrik, birden fazla kişi televizyon ekranında birlikte izlediğinde birlikte izleyenleri içerir. Rapor için livestreamPosition boyutu belirtilmişse peakConcurrentViewers değeri, videonun belirli bir segmenti sırasında eşzamanlı izleyici sayısının ulaştığı en yüksek değeri belirtir.

Kitleyi elde tutma metrikleri

audienceWatchRatio
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üleme sayısıyla karşılaştırılmasıyla hesaplanır. elapsedVideoTimeRatio boyutu, videonun metriğe karşılık gelen bölümünü tanımlar.

Videonun bir bölümünün, belirli bir video görüntülemesinde birden fazla kez izlenebileceğini (veya hiç izlenmeyebileceğini) unutmayın. Örneğin, kullanıcılar videonun aynı bölümünü geri sarıp birden fazla kez izlerse videonun o bölümünün mutlak oranı 1 değerinden büyük 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ıyor, geri kalanı ise videonun tamamını izliyor. İzleyicilerin hiçbiri videonun herhangi bir bölümünü birden fazla kez izlemiyor. Bu durumda, bu metriğin değeri videonun ilk çeyreğindeki zaman aralıkları için 1, videonun geri kalanı için ise 0.50 olur.
  • Bir dakikalık bir video 100 kez izlenir. İzleyicilerin tümü videonun tamamını izler ancak 20 izleyici videonun 45. saniyesine kadar izledikten sonra videonun 30. saniyesine geri atlar ve videonun geri kalanını izler. Bu durumda, videonun ilk yarısındaki veya son çeyreğindeki zaman dilimleri için metriğin değeri 1 olur. Ancak videonun üçüncü çeyreğindeki zaman aralıkları için değer 1.2 olur. Bunun nedeni, izleyicilerin %100'ünün videonun bu segmentini izlemesi ancak bu izleyicilerin %20'sinin segmenti iki kez izlemesidir.
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çümdür. Metrik, videonun belirli bir noktasındaki göreceli kitleyi elde tutma 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 elde tutma performansının benzer uzunluktaki diğer tüm videolardan daha düşük olduğunu gösterir. 1 değeri ise videonun izleyicileri elde tutma performansının benzer uzunluktaki diğer tüm videolardan daha yüksek olduğunu gösterir. 0.5 ortanca değeri, benzer uzunluktaki videoların yarısının izleyicileri daha iyi, diğer 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ı izleyenlerin ortalama %90'ı üç dakika, %70'i ise sekiz dakika geçtikten sonra videoyu izlemeye devam ediyor. Ancak 10 dakikalık belirli bir videoda, izleyicilerin yalnızca %80'i üç dakika sonra hâlâ izlemeye devam ederken bu izleyicilerin tümü sekiz dakika sonra hâlâ izlemeye devam ediyor.
  • Videonun üçüncü dakikasına karşılık gelen elapsedVideoTimeRatio değerinde, relativeRetentionPerformance metriğinin değeri 0.5'nin altında olur. Bunun nedeni, videonun o andaki performansının ortalama videodan daha düşük olmasıdır.
  • Videonun sekizinci dakikasına 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 anda benzer uzunluktaki diğer videolardan daha iyi performans göstermesidir.
startedWatching
Videonun belirli bir segmentinin, video oynatılırken görülen ilk segment olma sayısı.

Örneğin, X videosunun 5 dakika uzunluğunda olduğunu varsayalım. Bu rapor için YouTube, videoyu elapsedVideoTimeRatio boyutuyla tanımlanan 100 adet 3 saniyelik segmente böler. Bir izleyici YouTube'u ziyaret edip videonun ilk bir dakika on saniyesini izliyor. Bu süre, videonun ilk 24 segmentinin tamamını veya bir kısmını içeriyor. İzleyici, YouTube'u bir sonraki ziyaretinde videonun geri kalanını izler. Oynatma 24. segmentte devam eder ve 100. segmente kadar sürer.

Bu örnekte, aşağıdaki izleme metriği değerleri elde edilir:
  • startedWatching metriğinin değeri 1 ve 24 segmentleri için 1, diğer tüm segmentler için 0 olur.
  • stoppedWatching metriğinin değeri 24 ve 100 segmentleri için 1, diğer tüm segmentler için 0 olur.
  • totalSegmentImpressions metriğinin değeri, 24. segment için 2, diğer tüm segmentler için 1 olur.
stoppedWatching
Videonun belirli bir segmentinin, video oynatma sırasında görülen son segment olma 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ıdır. Bu metrik değerinin nasıl hesaplandığına dair bir örnek için startedWatching metriğinin tanımına bakın. Bir izleyicinin, videonun aynı segmentini aynı oynatma oturumunda birden çok kez izleyebileceğini unutmayın.

Üyelik iptali metrikleri

membershipsCancellationSurveyResponses
Raporlama döneminde belirtilen kanal için kanal üyeliğini iptal eden YouTube kullanıcılarının tamamladığı anket sayısı.

Tahmini gelir metrikleri

Not: Tahmini gelir metrikleri ay sonunda düzenlemeye tabidir ve iş ortağı tarafından satılan ve sunulan reklamları içermez. Tahmini gelir rakamları hakkında daha fazla bilgi ve not için YouTube Yardım Merkezi'ne göz atı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) (önceki adı 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 gelirdir. This is a core metric and is subject to the Deprecation Policy.

Tahmini gelir metrikleri ay sonunda düzenlemeye tabidir ve iş ortağı tarafından satılan ve sunulan reklamları içermez.
estimatedAdRevenue (önceki adı 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 gelirdir.

Tahmini gelir metrikleri ay sonunda düzenlemeye tabidir ve iş ortağı tarafından satılan ve sunulan reklamları içermez.
estimatedRedPartnerRevenue (önceki adıyla redPartnerRevenue)
Seçilen rapor boyutları için YouTube Premium (eski adıyla YouTube Red) aboneliklerinden elde edilen toplam tahmini gelir. Metriğin değeri, hem müzik hem de müzik dışı içeriklerden elde edilen geliri yansıtır ve ay sonunda düzenlemeye 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 gelirdir (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 (önceki adı impressionBasedCpm)
Bin reklam gösterimi başına tahmini brüt gelir.
adImpressions (önceki adı impressions)
Yayınlanan doğrulanmış reklam gösterimlerinin sayısı.
monetizedPlaybacks
İzleyicinin videonuzu oynattığı ve en az bir reklam gösterimi aldığı durumların sayısıdır. İzleyiciye videodan önce gösterilen reklam gösterilir ancak izleyici videonuz başlamadan önce reklamı izlemeyi bırakırsa bu, 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.