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.
annotation_click_through_rate
annotation_close_rate
average_view_duration_seconds
comments
dislikes
estimated_partner_revenue
likes
shares
subscribers_gained
subscribers_lost
views_percentage
views
watch_time_minutes
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.
- 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 verilersubscribers_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 bilgilerinin gösterilme sayısı. Video görüntüleme, birden fazla teaser gösterimi oluşturabilir.
- Kart bilgilerinin tıklanma sayısı. Kart simgesi tıklamaları, kullanıcıya gösterilen son bilgiyle ilişkilendirilir.
- 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çin0.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ğer1.2
olur.
- 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
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.
- 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.