Metrics

Bu belge, YouTube Reporting API'nin aldığı metrikleri tanımlar. Bu API, bir kanal veya içerik sahibi için YouTube Analytics verilerini içeren toplu veri raporlarını alır.

Metrikler kullanıcı etkinliği, reklam performansı veya tahmini gelirin ayrı ayrı ölçümüdür. Kullanıcı etkinliği metrikleri video görüntüleme sayısı ve puanları (beğenme ve beğenmeme sayısı) gibi şeyleri içerir.

Temel metrikler

YouTube Reporting API Hizmet Şartları'nda yer alan Kullanımdan Kaldırma Politikası'na tabi olsa da temel olmayan metrikler (ve temel olmayan boyutlar) politikaya tabi değildir. Bu sayfadaki tanımlarda, temel metrik olan tüm metrikler açıkça bu şekilde tanımlanmıştır.

Aşağıdaki liste, API'nin temel metriklerini tanımlar. YouTube Analytics API'de de kullanılan bu metrikler, ilgili API'nin temel metriklerinden biridir.

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

Metrikleri görüntüleyin

görüntüleme sayısı (temel metrik)
Bir videonun görüntülenme sayısı. Oynatma listesi raporundaki metrik, bir videonun oynatma listesi bağlamında kaç kez görüntülendiğini belirtir. YouTube Yardım Merkezi, görüntülemelerin nasıl raporlandığı hakkında ek bilgiler sağlar. This is a core metric and is subject to the Deprecation Policy.
kırmızı_görüntüleme
Bir videonun, YouTube Premium (önceki 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ü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 listesi için video izlediği dakika sayısı. This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
YouTube Premium (önceki adıyla YouTube Red) üyelerinin video izlediği dakika sayısı.
Ortalama_görüntü_süresi_saniye (temel metrik)
Video oynatma sayısının saniye cinsinden ortalama uzunluğu. 13 Aralık 2021 itibarıyla, bu metrik dönüştürülen kliplerin trafiğini kapsamaz. Bir oynatma listesi raporundaki 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.
ortalaması_olan_görüntüleme_süresi_yüzdesi
Video oynatma sırasında videonun ortalama izlenme yüzdesi. 13 Aralık 2021 itibarıyla, bu metrik dönüştürülen kliplerin trafiğini kapsamaz.

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'ni ziyaret edin. This is a core metric and is subject to the Deprecation Policy.
beğenme (temel metrik)
Kullanıcıların olumlu bir puan vererek bir 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 olumsuz puan vererek bir videoyu beğenmediklerini gösterme sayısı. This is a core metric and is subject to the Deprecation Policy.
paylaşımlar (temel metrik)
Kullanıcıların Share düğmesiyle video 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 rehber gibi pek çok yerde abone kazanabilir veya abonelerini 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 belirtmeyen bir satır bulunur. Bu satır, subscribersLost metriği için bir değer belirtir ancak diğer metrikler için değer belirtmez.
subscribers_lost (temel metrik)
Kullanıcıların kanal aboneliğinden çıkma sayısı. This is a core metric and is subject to the Deprecation Policy.

Bu metriğe ait veriler subscribers_gained metriğine benzer şekilde raporlanır. Abonelikten çıkan ancak bir video izleme sayfasında e-posta listesinden çıkmayan kullanıcıların sayısını tespit etmek için temel kullanıcı etkinliği raporunda video_id boyut değeri belirtmeyen bir satır bulunur. Bu satır, subscribers_gained metriği için bir değer belirtir ancak diğer metrikler için değer belirtmez.
oynatma_listelerine_eklenen_videolar
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" oynatma listesi gibi varsayılan oynatma listelerine kaç kez eklendiğini gösterir. Ancak bir kanalın yüklenen oynatma listesi veya kullanıcının izleme geçmişi gibi videonun otomatik olarak eklendiği oynatma listelerini saymaz.

Bu metrik mutlak bir sayı döndürür. Diğer bir ifadeyle, bir kullanıcı oynatma listesine video eklediğinde, videoyu kaldırıp tekrar eklediğinde bu metrik, videonun oynatma listesine eklenen videoyu iki kez yansıtır. Bu metrikle ilgili veriler, 1 Ekim 2014'ten önceki tarihler için 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 İ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 oynatma listesine video ekler, bu videoyu tekrar kaldırır ve ardından videoyu tekrar kaldırırsa metrik değeri, videonun iki kez kaldırılan videoyu yansıttığını gösterir. Bu metrikle ilgili veriler, 1 Ekim 2014'ten önceki tarihler için kullanılamaz.

Oynatma listesi metrikleri

oynatma_listesi_başlatma
İ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ı. Kaydedilen oynatma listeleri hakkında daha fazla bilgi için YouTube Yardım Merkezi'ni ziyaret edin. Bu metrik mutlak bir sayı döndürür. Kullanıcı bir oynatma listesini kaydederse bu listeyi kayıtlı oynatma listeleri listesinden kaldırır ve yeniden kaydederse metrik değeri, eklenen iki oynatma listesine kaydedilir.
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. Kullanıcı bir oynatma listesini kaydederse bu listeyi kayıtlı oynatma listeleri listesinden kaldırır, yeniden kaydeder ve tekrar kaldırırsa metrik değeri, kaldırılan iki oynatma listesine yapılan değişiklikleri yansıtır.

Ek açıklama metrikleri

ek açıklama_gösterimleri
Ek açıklama gösterimlerinin toplam sayısı.
ek açıklama_tıklanabilir_gösterimler
Gösterilen ve tıklanabilen ek açıklamaların sayısı.
ek açıklama_tıklamaları
Tıklanan ek açıklamaların sayısı.
description_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. YouTube Yardım Merkezi'nde ek açıklama oluşturma ve bağlantı ek açıklamalarını kullanma hakkında daha fazla bilgi bulabilirsiniz.
ek_açıklama_kapanış_gösterimleri
Gösterilen ve kapatılabilen ek açıklamaların sayısı.
ek_açıklama_kapakları
Kapatılan ek açıklama sayısı.
description_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 hakkında daha ayrıntılı talimatlar yer alır.

kart_gösterimleri
Kartların görüntülenme sayısı. Kart paneli açıldığında video kartlarının her biri için bir kart gösterimi kaydedilir.
kart_tıklama
Kartların tıklanma sayısı.
kart_tıklama_oranı
Kartların tıklama oranı. Bu oran, kart tıklama sayısının kart gösterim sayısına oranı olarak hesaplanır.
kart_bilgisi_gösterim_gösterimi
Kart bilgilerinin gösterilme sayısı. Video görüntüleme, birden fazla teaser gösterimi oluşturabilir.
kart_bilgi_tıklama_sayısı
Kart bilgilerinin tıklanma sayısı. Kart simgesi tıklamaları, kullanıcıya gösterilen son bilgiyle ilişkilendirilir.
kart_bilgi_tıklama_oranı
Kart bilgileri için tıklama oranı. Bu değer, kart bilgisi tıklamalarının toplam kart bilgisi gösterim sayısına oranı olarak hesaplanır.

Bitiş ekranı metrikleri

Bitiş ekranları, içeriklerinizi, kanalınızı ve web sitelerinizi tanıtmak için videoların son beş ila 20 saniyesinde gösterilen öğelerdir. YouTube Yardım Merkezi'nde videolarınıza bitiş ekranı ekleme ve YouTube Analytics Bitiş Ekranları Raporu ile ilgili daha ayrıntılı talimatlar bulabilirsiniz.

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

bitiş_ekran_öğesi_gösterimleri
Görüntülenen bitiş ekranı öğelerinin sayısı. Görüntülenen her bitiş ekranı öğesi için bir gösterim kaydedilir.
bitiş_ekran_öğesi_tıklamaları
Bitiş ekranı öğelerinin tıklanma sayısı.
bitiş_ekran_öğesi_tıklama_oranı
Bitiş ekranı öğelerinin tıklama oranı. Bu değer, bitiş ekranı öğesinin tıklanma sayısının bitiş ekranı öğesinin gösterim sayısına oranı olarak hesaplanır.

Kitleyi elde tutma metrikleri

kitle_saklama_yüzdesi
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ülenme sayısıyla karşılaştırılmasıyla hesaplanır. elapsed_video_time_percentage boyutu, videonun metriğin karşılık geldiği kısmını tanımlar.

Videonun bir kısmının, belirli bir video görünümünde birden fazla kez izlenebileceğini (veya hiç izlenmediğini) unutmayın. Örneğin, kullanıcılar bir videonun aynı bölümünü birden fazla kez sarar ve izlerse videonun ilgili bölümünün mutlak oranı 1 değerinden fazla olabilir.

Aşağıdaki örnekler, değerin nasıl hesaplandığını göstermektedir:
  • Bir dakikalık video 100 kez izlenir. İzleyicilerin yarısı 15 saniye sonra videoyu izlemeyi bırakır, geri kalanı ise videonun tamamını izler. İzleyicilerin hiçbiri videonun herhangi bir bölümünü birden fazla kez izlememiştir. Bu durumda bu metriğin değeri, videonun ilk çeyreğindeki zaman grupları için 1 ve videonun geri kalanı için 0.50 olur.
  • Bir dakikalık video 100 kez izlenir. Tüm izleyiciler videonun tamamını izler ancak izleyicinin 20'si videonun 45 saniyelik işaretine kadar videoyu izler, ardından videonun 30 saniye işaretine döner ve videonun geri kalanını izler. Bu durumda metriğin değeri, videonun ilk yarısı veya son çeyreğindeki zaman grupları için 1 olur. Bununla birlikte, izleyicilerin %100'ü videonun bu bölümünü izlediği ancak bu izleyicilerin %20'sinin segmenti iki kez izlediği için videonun üçüncü çeyreğindeki zaman grupları için değer 1.2 olur.

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ıyla ilgili daha fazla bilgi ve not için lütfen YouTube Yardım Merkezi'ne bakın.

YouTube Reporting API, tüm tahmini gelir ve kazanç rakamlarını ABD doları cinsinden bildirir.
estimated_partner_revenue (temel metrik)
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 gelir.
tahmini_iş ortağı_reklam_geliri
Seçilen tarih aralığı ve bölge için Google tarafından satılan tüm reklam kaynaklarından elde edilen tahmini toplam net gelirdir.

Tahmini gelir metriklerinde ay sonu düzenlemesi uygulanır 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ç (net gelir). Bu metrik daha önce estimated_partner_ad_sense_revenue olarak adlandırılıyordu.
estimated_partner_ad_sense_revenue (yalnızca YouTube Reporting API'de desteklenir)
Seçilen tarih aralığı ve bölge için açık artırmayla satılan AdSense reklamlarından elde edilen toplam tahmini kazanç (net gelir).
estimated_partner_ad_reserved_revenue (yalnızca YouTube Reporting API'de desteklenir)
DoubleClick (DCLK) ve YouTube'un sattığı diğer kaynaklar üzerinden ayrılarak satılan reklamlardan elde edilen toplam tahmini kazançlar (net gelir). Bu metrik daha önce estimated_partner_double_click_revenue olarak adlandırılıyordu.
estimated_partner_double_click_revenue (yalnızca YouTube Reporting API'de desteklenir)
DoubleClick (DCLK) ve YouTube'un sattığı diğer kaynaklar aracılığıyla ayrılarak satılan reklamlardan elde edilen toplam tahmini kazanç (net gelir).
estimated_partner_red_revenue (yalnızca YouTube Reporting API'de desteklenir)
YouTube Premium (önceki adıyla YouTube Red) aboneliklerinden elde edilen toplam tahmini kazançlar (net gelir).
estimated_partner_transaction_revenue (yalnızca YouTube Reporting API'de desteklenir)
İş ortağı tarafından alınan geri ödemeler hariç olmak üzere, ücretli içerikler ve Takipçi Bağışları gibi işlemlerden elde edilen toplam tahmini gelirdir.

Reklam performansı metrikleri

tahmini_youtube_reklam_geliri
Seçilen tarih aralığı ve bölge için Google tarafından 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 veya net gelirle karıştırılmamalıdır. Bu gelir, sahiplik payınızı ve gelir paylaşımı sözleşmelerinizi hesaba katar.
tahmini_bgbm
Bin reklam gösterimi başına tahmini brüt gelir.
reklam_gösterimleri
Yayınlanan doğrulanmış reklam gösterimlerinin sayısı.
tahmini_para_kazandıran_oynatmalar
İzleyicinin 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 önce reklamdan ayrılırsa bu, para kazanılan bir oynatma olarak sayılır. Bu rakam için beklenen tahmini hata ~%2,0'dır.
tahmini_oynatma_tabanı_bgbm
Bin oynatma başına tahmini brüt gelir.