Metrics

Bu belgede, YouTube Reporting API'nin aldığı metrikler tanımlanmaktadır. Bu API, bir kanal veya içerik sahibine ait YouTube Analytics verilerini içeren toplu veri raporlarını alır.

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 Reporting 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. YouTube Analytics API'de de kullanılan bu metrikler ilgili API'deki temel metriklerdir.

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)
Bir videonun izlenme sayısı. Oynatma listesi raporundaki bu metrik, bir videonun oynatma listesi bağlamında görüntülenme sayısını belirtir. YouTube Yardım Merkezi'nde görüntülemelerin nasıl raporlandığı hakkında daha fazla bilgi edinebilirsiniz. This is a core metric and is subject to the Deprecation Policy.
red_views
Bir videonun YouTube Premium (eski adıyla YouTube Red) üyeleri tarafından görüntülenme sayısı.
views_percentage (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

watch_time_minutes (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.
red_watch_time_minutes
YouTube Premium (eski adıyla YouTube Red) üyelerinin bir videoyu izlediği dakika sayısı.
average_view_duration_seconds (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.
average_view_duration_percentage
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.
subscribers_gained (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. Video izleme sayfası aracılığıyla abone olmayan yeni kanal abonelerinin sayısını tespit etmek için temel kullanıcı etkinliği raporunda video_id boyut değerinin belirtilmediği bir satır bulunur. Bu satır, subscribersLost metriği için de bir değer belirtir ancak diğer metriklere ait değerleri belirtmez.
subscribers_lost (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, subscribers_gained metriğiyle benzer şekilde raporlanır. Abonelikten çıkan ancak bir video izleme sayfasında abonelikten çıkmayan kullanıcıların sayısını tespit etmek için temel kullanıcı etkinliği raporunda video_id boyut değerinin belirtilmediği bir satır bulunur. Bu satır, subscribers_gained metriği için de bir değer belirtir ancak diğer metriklere ait değerleri belirtmez.
videos_added_to_playlists
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.
videos_removed_from_playlists
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.

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.

playlist_starts
İ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.
playlist_saves_added (yalnızca YouTube Reporting API'de desteklenir)
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 bakın. Bu metrik mutlak bir sayı döndürür. Diğer bir deyişle, bir kullanıcı bir oynatma listesini kaydeder, listeyi kaydedilen oynatma listeleri listesinden kaldırır ve tekrar kaydederse metrik değeri, eklenen iki oynatma listesi kaydını yansıtır.
playlist_saves_removed (yalnızca YouTube Reporting API'de desteklenir)
Kullanıcıların oynatma listesini kendi kayıtlı oynatma listeleri listelerinden kaldırma sayısıdır. Bu metrik mutlak bir sayı döndürür. Diğer bir deyişle, bir kullanıcı bir oynatma listesini kaydederse, kaydedilen oynatma listeleri listesinden kaldırır, tekrar kaydeder ve tekrar kaldırırsa metrik değeri, kaldırılan iki oynatma listesi kaydını yansıtır.

Ek açıklama metrikleri

annotation_impressions
Ek açıklama gösterimlerinin toplam sayısıdır.
annotation_clickable_impressions
Gösterilen ve tıklanabilen ek açıklamaların sayısı.
annotation_clicks
Tıklanan ek açıklama sayısı.
annotation_click_through_rate (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.
annotation_closable_impressions
Gösterilen ve kapatılabilecek ek açıklamaların sayısı.
annotation_closes
Kapalı ek açıklamaların sayısı.
annotation_close_rate (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.

card_impressions
Kartların gösterilme sayısı. Kart paneli açıldığında, videonun her bir kartı için bir kart gösterimi kaydedilir.
card_clicks
Kartların tıklanma sayısı.
card_click_rate
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.
card_teaser_impressions
Kart bilgilerinin gösterilme sayısıdır. Bir video görüntülemesi, birden fazla teaser gösterimi oluşturabilir.
card_teaser_clicks
Kart bilgilerinin tıklanma sayısıdır. Kart simgesi tıklamaları, kullanıcıya gösterilen son bilgiyle ilişkilendirilir.
card_teaser_click_rate
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.

Bitiş ekranı metrikleri

Bitiş ekranları; içeriğinizi, kanalınızı ve web sitelerinizi tanıtmak için bir videonun son 5-20 saniyesinde gösterilen öğelerdir. YouTube Yardım Merkezi'nde, videolarınıza bitiş ekranı ekleme ile ilgili daha ayrıntılı talimatlar ve YouTube Analytics Bitiş Ekranları Raporu bulunur.

Not: Bitiş ekranı metrikleriyle ilgili veriler 1 Mayıs 2016 tarihinden itibaren kullanılabilmektedir.

end_screen_element_impressions
Görüntülenen bitiş ekranı öğelerinin sayısı. Gösterilen her bitiş ekranı öğesi için bir gösterim kaydedilir.
end_screen_element_clicks
Bitiş ekranı öğelerinin tıklanma sayısı.
end_screen_element_click_rate
Bitiş ekranı öğelerinin tıklama oranıdır. Bitiş ekranı öğesi tıklamalarının bitiş ekranı öğesi gösterimlerine oranı olarak hesaplanır.

Kitleyi elde tutma metrikleri

audience_retention_percentage
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. elapsed_video_time_percentage 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.

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.

YouTube Reporting API, tüm tahmini gelir ve kazanç rakamlarını ABD doları cinsinden raporlar.
estimated_partner_revenue (temel metrik)
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.
estimated_partner_ad_revenue
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.
estimated_partner_ad_auction_revenue (yalnızca YouTube Reporting API'de desteklenir)
Seçilen tarih aralığı ve bölge için AdSense üzerinden açık artırma ile satılan reklamlardan elde edilen toplam tahmini kazançlardır (net gelir). Bu metrik daha önce estimated_partner_ad_sense_revenue olarak adlandırılmıştı.
estimated_partner_ad_sense_revenue (yalnızca YouTube Reporting API'de desteklenir)
Seçilen tarih aralığı ve bölge için açık artırma ile satılan AdSense reklamlarından elde edilen toplam tahmini kazançlardır (net gelir).
estimated_partner_ad_reserved_revenue (yalnızca YouTube Reporting API'de desteklenir)
DoubleClick (DCLK) ve YouTube tarafından satılan diğer kaynaklar aracılığıyla ayrılan-satılan reklamlardan elde edilen toplam tahmini kazançlardır (net gelir). Bu metrik daha önce estimated_partner_double_click_revenue olarak adlandırılmıştı.
estimated_partner_double_click_revenue (yalnızca YouTube Reporting API'de desteklenir)
DoubleClick (DCLK) ve YouTube tarafından satılan diğer kaynaklar aracılığıyla ayrılan-satılan reklamlardan elde edilen toplam tahmini kazançlardır (net gelir).
estimated_partner_red_revenue (yalnızca YouTube Reporting API'de desteklenir)
YouTube Premium (eski adıyla YouTube Red) aboneliklerinden elde edilen toplam tahmini kazançlardır (net gelir).
estimated_partner_transaction_revenue (yalnızca YouTube Reporting API'de desteklenir)
Ücretli içerikler ve Hayran Bağışları gibi işlemlerden elde edilen toplam tahmini gelirden iş ortağı tarafından alınan geri ödemelerin çıkarılmasıyla elde edilen değer.

Reklam performansı metrikleri

estimated_youtube_ad_revenue
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.
estimated_cpm
Bin reklam gösterimi başına tahmini brüt gelirdir.
ad_impressions
Yayınlanan doğrulanmış reklam gösterimlerinin sayısıdır.
estimated_monetized_playbacks
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.
estimated_playback_based_cpm
Bin oynatma başına tahmini brüt gelirdir.