Metrics

Bu belgede, YouTube Analytics API'si kullanılarak alınabilecek 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 arasında video görüntüleme sayısı ve puanlar (beğenme ve beğenmeme) gibi bilgiler yer alır.

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 belirtilir.

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

Daha fazla bilgi için desteği sonlandırılma politikasına tabi YouTube API'lerinin listesine bakın.

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. 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 (önceki adı 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ı izlediği süre (dakika cinsinden). This is a core metric and is subject to the Deprecation Policy.
estimatedRedMinutesWatched
YouTube Premium (önceki adı YouTube Red) üyelerinin bir videoyu izlediği dakika sayısı.
averageViewDuration (temel metrik)
Video oynatmalarının ortalama süresi (saniye cinsinden). 13 Aralık 2021 itibarıyla bu metrik, döngüye alınan kliplerden gelen trafiği hariç tutar. Oynatma listesi raporunda bu metrik, oynatma listesi bağlamında gerçekleşen video oynatmalarının ortalama süresini saniye cinsinden gösterir. This is a core metric and is subject to the Deprecation Policy.
averageViewPercentage
Video oynatma sırasında videonun ortalama izlenme yüzdesi. 13 Aralık 2021 itibarıyla bu metrik, döngüye alınan 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 atın. This is a core metric and is subject to the Deprecation Policy.
Beğenmeler (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ğenmemeler (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 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örünen rehber dahil olmak üzere çeşitli yerlerde abone kazanabilir veya kaybedebilir. Kanal raporlarında bu metrik, bu yerlerden kazanılan aboneleri içerir. Ancak, yanıtı yalnızca belirli bir videonun verilerini içerecek şekilde kısıtlamak için video boyutunun veya filter parametresinin kullanıldığı raporlarda subscribersGained metriği yalnızca belirtilen videonun izleme sayfasındaki istatistikleri içerir.
subscribersLost (temel metrik)
Kullanıcıların bir kanalın 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 kanaldan aboneliklerini iptal edebilecekleri 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 boyutunun veya filter parametresinin kullanıldığı raporlarda bu metrik yalnızca belirtilen videonun izleme sayfasından aboneliğini iptal eden kullanıcıları içerir.
videosAddedToPlaylists
Videoların herhangi bir YouTube oynatma listesine 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 eklenme sayısını içerir. Ancak bu metrik, videoların otomatik olarak eklendiği oynatma listelerini (ör. kanalın yüklemeler oynatma listesi veya kullanıcının izleme geçmişi) hesaba katmaz.

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 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 izle" 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 metrikle ilgili veriler, 1 Ekim 2014'ten önceki tarihler için kullanılamaz.

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 ve oynatma listesinin sahibi olan kanala ait tüm videolar için toplu olarak sunulan kullanıcı etkinliği ve gösterim metriklerini sağlar. Diğer kanallara ait videoların metrikleri toplama işleminde hesaplanmaz. Bu nedenle, bir kanal yalnızca diğer kanallara ait videoları içeren bir oynatma listesi oluşturursa bu oynatma listeleriyle ilgili raporlarda bu metriklerin değerleri 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 listesindeki metrikler, oynatma listesi sayfası bağlamındaki 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ıları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) ise oynatma listesindeki videolarla değil, oynatma listesiyle ilgili kullanıcı etkileşimleriyle ilgilidir. Bu nedenle, bu metrikler toplu video metrikleri veya oynatma listesindeki metrikler olarak sınıflandırılmaz.

averageTimeInPlaylist
Bir izleyicinin, oynatma listesi başlatıldıktan sonra oynatma listesindeki videoları görüntülediğ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 izlenen tahmini ortalama süre (saniye cinsinden). Bu metriğin, oynatma listesindeki tek tek videoların ortalama görüntüleme süresini temsil ettiğini unutmayın. averageTimeInPlaylist metriği ise her izleyicinin oynatma listesini bir bütün olarak izlerken 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 süre (dakika). Diğer bağlamlarda gerçekleşen izlenme süresi (ör. izleyicilerin aynı videoyu diğer oynatma listelerinin bir parçası olarak izlediği sırada 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 değişiklik sayısı döndürür. Yani bir kullanıcı oynatma listesini kaydedip kayıtlı oynatma listeleri listesinden kaldırırsa ve 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
Bir oynatma listesi 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ı, 10 Haziran 2012'den itibaren yalnızca annotationClickThroughRate ve annotationCloseRate metrikleriyle ilgili verileri döndürür. Ayrıca, YouTube Analytics API raporları 16 Temmuz 2013'ten itibaren yalnızca kalan açıklama metrikleriyle ilgili verileri döndürmektedir.

annotationImpressions
Toplam not gösterimi sayısı.
annotationClickableImpressions
Görünen 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, tıklanabilir ek açıklama gösterimlerinin toplam sayısına oranıdır. 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örünen ve kapatılabilen ek açıklama 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

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

cardImpressions
Kartların gösterilme sayısı. Kart paneli açıldığında video üzerindeki 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ı olarak hesaplanır.
cardTeaserImpressions
Kart bilgilerinin gösterilme sayısıdır. Bir video görüntüleme, birden fazla bilgi gösterimi oluşturabilir.
cardTeaserClicks
Kart bilgilerinin tıklanma sayısıdır. Kart simgesini tıklama sayısı, kullanıcıya gösterilen son bilgiyle ilişkilendirilir.
cardTeaserClickRate
Kart bilgilerinin tıklama oranıdır. Kart bilgisi 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 anlık ortalama izleyici sayısı. Raporda livestreamPosition boyutu belirtilmişse averageConcurrentViewers değeri, belirli bir segment sırasında aynı anda izleyen kullanıcıların ortalama sayısını belirtir.
peakConcurrentViewers
Belirli bir videoyu aynı anda izleyen kullanıcıların en yüksek sayısı. Raporda livestreamPosition boyutu belirtilmişse peakConcurrentViewers değeri, videonun belirli bir bölümü sırasında aynı anda izleyen en yüksek kullanıcı sayısını belirtir.

Kitleyi elde tutma metrikleri

audienceWatchRatio
Videoyu belirli bir noktada izleyen izleyicilerin mutlak oranı. 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, metriğin karşılık geldiği video bölümünü tanımlar.

Bir videonun bir bölümünün, belirli bir video görüntülemede birden fazla kez izlenebileceğini (veya hiç izlenmeyebileceğini) unutmayın. Örneğin, kullanıcılar bir videonun aynı bölümünü geri sarıp birden çok kez izlerse videonun bu 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 izleniyor. İzleyicilerin yarısı 15 saniye sonra izlemeyi bırakıyor, diğer yarısı 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 izleniyor. Tüm izleyiciler videonun tamamını izliyor ancak 20 izleyici videonun 45. saniyesine kadar izleyip 30. saniyeye geri sarıyor ve videonun geri kalanını izliyor. Bu durumda, metriğin değeri videonun ilk yarısında veya son çeyreğindeki zaman grupları için 1 olur. Ancak, izleyicilerin %100'ü videonun bu bölümünü izlediği ve bu izleyicilerin %20'si bölümü iki kez izlediği için videonun üçüncü çeyreğindeki zaman aralıkları için değer 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, videonun belirli bir noktasındaki göreceli 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 benzer uzunluktaki diğer tüm videolardan daha kötü şekilde elde tuttuğunu, 1 değeri ise videonun izleyicileri benzer uzunluktaki diğer tüm videolardan daha iyi şekilde elde tuttuğunu gösterir. Ortanca değerin 0.5 olması, benzer uzunluktaki videoların yarısının izleyicileri daha iyi elde tuttuğunu, yarısının ise daha kötü elde tuttuğunu gösterir.

Aşağıdaki varsayımsal örnekte, değerlerin raporda nasıl görünebileceği gösterilmektedir. Ortalama olarak, 10 dakika uzunluğundaki videoları izleyenlerin %90'ı üç dakika sonra, %70'i ise sekiz dakika sonra izlemeye devam ediyor. Ancak 10 dakikalık belirli bir videoyu üç dakika sonra izlemeye devam eden izleyicilerin oranı yalnızca %80'dir. Bu izleyicilerin tamamı, videoyu sekiz dakika sonra da izlemeye devam eder.
  • Videonun üç dakikasını gösteren elapsedVideoTimeRatio değerinde, relativeRetentionPerformance metriği 0.5 değerinin altında olur. Bunun nedeni, bu noktada videonun ortalama bir videodan daha kötü performans göstermesidir.
  • Videoda sekizinci dakikaya denk gelen elapsedVideoTimeRatio değerinde, relativeRetentionPerformance metriğinin değeri 0.5 değerinden yüksek olur. Bunun nedeni, bu noktada videonun benzer uzunluktaki diğer videolardan daha iyi performans göstermesidir.
startedWatching
Videonun belirli bir segmentinin, video oynatma sırasında ilk görünen segment olma sayısı.

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

Bu örnek aşağıdaki izleme metrik değerlerini üretir:
  • startedWatching metriğinin değeri, 1 ve 24 numaralı segmentler için 1, diğer tüm segmentler için ise 0 olur.
  • 24 ve 100 numaralı segmentler için stoppedWatching metriğinin değeri 1, diğer tüm segmentler için ise 0 olur.
  • totalSegmentImpressions metriğinin değeri, 24 numaralı segment için 2, diğer tüm segmentler için ise 1 olur.
stoppedWatching
Videonun belirli bir bölümünün, video oynatma sırasında görülen son bölüm 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
Bir 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ı oynatma sırasında bir videonun aynı segmentini birden fazla kez izleyebileceğini unutmayın.

Üyelik iptali metrikleri

membershipsCancellationSurveyResponses
Raporlama döneminde belirtilen kanalın üyeliklerini iptal eden YouTube kullanıcıları tarafından tamamlanan anketlerin sayısı.

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ı 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 bildirilir. 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 (çekirdek metrik) (önceki adı 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 tabi tutulur ve iş ortağı tarafından satılan ve sunulan reklamları içermez.
estimatedAdRevenue (önceki 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ş ortakları tarafından satılıp yayınlanan reklamcılığı içermez.
estimatedRedPartnerRevenue (önceki adıyla redPartnerRevenue)
Seçilen rapor boyutları için YouTube Premium (önceki adı 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 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ın ve gelir paylaşımı sözleşmelerinizin dikkate alındığı tahmini gelir veya net gelir ile karıştırılmamalıdır.
cpm (eski 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österiminin gösterildiği durumların sayısı. İzleyiciye videodan önce gösterilen reklam gösterilirse ancak videonuz hiç başlamadan önce reklamı izlemeyi bırakırsa para kazanılan oynatma sayılır. Bu rakam için beklenen tahmini hata oranı ±%2,0'dır.
playbackBasedCpm
Bin oynatma başına tahmini brüt gelir.