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ğ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 Reporting API, Hizmet Şartları'nda tanımlanan Desteği Sonlandırılan API 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ımlanmaktadır. YouTube Analytics API'de de kullanılan bu metriklerin tümü, söz konusu API'deki temel metriklerdir.

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

Metrikleri göster

engaged_views (temel metrik)
Kanalın videolarının ilk birkaç saniyeden sonra izlenme sayısı.
görüntülemeler (temel metrik)
Bir videonun görüntülenme sayısı. Oynatma listesi raporunda bu metrik, bir videonun oynatma listesi bağlamında kaç kez görüntülendiğini gösterir. Görüntülemelerin nasıl bildirildiğiyle ilgili daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz. 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 oturum açmış olan izleyicilerin yüzdesi. 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 listesindeki videoları izleme süresi. 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 izleme süresi.
average_view_duration_seconds (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.
average_view_duration_percentage
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.
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örünen kılavuz dahil olmak üzere çeşitli yerlerde abone kazanabilir veya kaybedebilir. Video izleme sayfası üzerinden abone olmayan yeni kanal abonelerinin sayısını belirlemek için temel kullanıcı etkinliği raporunda video_id boyut değeri belirtilmeyen bir satır bulunur. Bu satırda subscribersLost metriği için bir değer de belirtilir ancak diğer metrikler için değer belirtilmez.
subscribers_lost (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, subscribers_gained metriğine benzer şekilde raporlanır. Abonelikten çıkan ancak video izleme sayfasında abonelikten çıkmayan kullanıcıların sayısını belirlemek için temel bir kullanıcı etkinliği raporunda video_id boyut değeri belirtilmeyen bir satır bulunur. Bu satırda subscribers_gained metriği için bir değer de belirtilir ancak diğer metrikler için değer belirtilmez.
videos_added_to_playlists
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.
videos_removed_from_playlists
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 toplanan kullanıcı etkinliği ve gösterim metriklerini 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.

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 göz atın. Bu metrik mutlak bir sayı 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, iki oynatma listesi kaydının eklendiğini gösterir.
playlist_saves_removed (yalnızca YouTube Reporting API'de desteklenir)
Kullanıcıların oynatma listesini, kayıtlı oynatma listeleri listelerinden kaldırma sayısı. Bu metrik mutlak bir sayı döndürür. Yani bir kullanıcı bir oynatma listesini kaydedip kayıtlı oynatma listeleri listesinden kaldırır, tekrar kaydeder ve tekrar kaldırırsa metrik değeri, iki oynatma listesi kaydının kaldırıldığını gösterir.

Ek açıklama metrikleri

annotation_impressions
Ek açıklama gösterimlerinin toplam sayısı.
annotation_clickable_impressions
Görüntülenen ve tıklanabilen ek açıklamaların sayısı.
annotation_clicks
Tıklanan ek açıklamaların sayısı.
annotation_click_through_rate (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.
annotation_closable_impressions
Görüntülenen ve kapatılabilen ek açıklamaların sayısı.
annotation_closes
Kapatılan ek açıklama sayısı.
annotation_close_rate (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.

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

Bitiş ekranı metrikleri

Bitiş ekranları, içeriğinizi, kanalınızı ve web sitelerinizi tanıtmak için videonun son beş ila 20 saniyesinde gösterilen öğelerdir. Videolarınıza bitiş ekranı ekleme ve YouTube Analytics Bitiş Ekranları Raporu hakkında daha ayrıntılı talimatlar için YouTube Yardım Merkezi'ni ziyaret edin.

end_screen_element_impressions
Gösterilen 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ı. Bitiş ekranı öğesi tıklamalarının bitiş ekranı öğesi gösterimlerine oranı olarak hesaplanır.

Kitleyi elde tutma metrikleri

audience_retention_percentage
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. elapsed_video_time_percentage 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 izlemiş ancak bu izleyicilerin yüzde 20'si segmenti iki kez izlemiş olduğundan, videonun üçüncü çeyreğindeki zaman kapsülleri için değer 1.2 olur.

Ü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 göz atın.

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 reklamcılık kaynaklarından ve reklamcılık dışı kaynaklardan elde edilen toplam tahmini net gelirdir.
estimated_partner_ad_revenue
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.
estimated_partner_ad_auction_revenue (yalnızca YouTube Reporting API'de desteklenir)
Seçilen tarih aralığı ve bölge için AdSense aracılığıyla açık artırma yoluyla satılan reklamlardan elde edilen toplam tahmini kazanç (net gelir). Bu metrik daha önce estimated_partner_ad_sense_revenue olarak adlandırılıyordu.
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 rezervasyon esasına göre satılan reklamlardan elde edilen toplam tahmini kazanç (net gelir). Bu metrik daha önce estimated_partner_double_click_revenue olarak adlandırılıyordu.
estimated_partner_red_revenue (yalnızca YouTube Reporting API'de desteklenir)
YouTube Premium (eski adıyla YouTube Red) aboneliklerinden elde edilen toplam tahmini kazanç (net gelir).
estimated_partner_transaction_revenue (yalnızca YouTube Reporting API'de desteklenir)
Ücretli içerikler ve Takipçi Bağışları gibi işlemlerden elde edilen toplam tahmini gelirden iş ortağı tarafından alınan geri ödemelerin çıkarılmasıyla elde edilen tutar.

Reklam performansı metrikleri

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