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.
annotationClickThroughRateannotationCloseRateaverageViewDurationcommentsdislikesengagedViewsestimatedMinutesWatchedestimatedRevenuelikessharessubscribersGainedsubscribersLostviewerPercentageviews
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.
- Kullanıcıların
Sharedüğ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çinvideoboyutunu veyafilterparametresini kullanan raporlardasubscribersGainedmetriğ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,subscribersGainedmetriğ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çinvideoboyutunu veyafilterparametresini 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.
averageTimeInPlaylistmetriğ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.
- Kart bilgilerinin gösterilme sayısı. Bir video görüntüleme, birden fazla bilgi gösterimi oluşturabilir.
- Kart bilgilerinin tıklanma sayısı. Kart simgesi tıklamaları, kullanıcıya gösterilen son bilgiyle ilişkilendirilir.
- 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
averageConcurrentViewersdeğ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
peakConcurrentViewersdeğ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.
elapsedVideoTimeRatioboyutu, 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ı1değ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 ise0.50olur. - 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
1olur. Ancak videonun üçüncü çeyreğindeki zaman aralıkları için değer1.2olur. Bunun nedeni, izleyicilerin %100'ünün videonun bu segmentini izlemesi ancak bu izleyicilerin %20'sinin segmenti iki kez izlemesidir.
- 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
- 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
0ile1arasında bir değere sahiptir. Videodaki nokta,elapsedVideoTimeRatioboyutu tarafından sağlanır.
0değeri, videonun izleyicileri elde tutma performansının benzer uzunluktaki diğer tüm videolardan daha düşük olduğunu gösterir.1değeri ise videonun izleyicileri elde tutma performansının benzer uzunluktaki diğer tüm videolardan daha yüksek olduğunu gösterir.0.5ortanca 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
elapsedVideoTimeRatiodeğerinde,relativeRetentionPerformancemetriğinin değeri0.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
elapsedVideoTimeRatiodeğerinde,relativeRetentionPerformancemetriği0.5değerinden daha yüksek bir değere sahip olur. Bunun nedeni, videonun o anda benzer uzunluktaki diğer videolardan daha iyi performans göstermesidir.
- Videonun üçüncü dakikasına karşılık gelen
- 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:startedWatchingmetriğinin değeri 1 ve 24 segmentleri için1, diğer tüm segmentler için0olur.stoppedWatchingmetriğinin değeri 24 ve 100 segmentleri için1, diğer tüm segmentler için0olur.totalSegmentImpressionsmetriğinin değeri, 24. segment için2, diğer tüm segmentler için1olur.
- 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
startedWatchingmetriğ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
startedWatchingmetriğ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.
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.