Bu dokümanda, 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 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 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 tüm metrikler açıkça belirtilmiştir.
Aşağıdaki listede API'nin temel metrikleri belirtilmiştir. YouTube Analytics API'de de kullanılan bu metriklerin tümü, söz konusu API'deki temel metriklerdir.
annotation_click_through_rateannotation_close_rateaverage_view_duration_secondscommentsdislikesengaged_viewsestimated_partner_revenuelikessharessubscribers_gainedsubscribers_lostviews_percentageviewswatch_time_minutes
Daha fazla bilgi için Kullanımdan Kaldırma Politikası'na tabi YouTube API'lerinin listesini inceleyin.
Metrikleri göster
- engaged_views (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)
- Bir videonun görüntülenme sayısı. Oynatma listesi raporunda bu metrik, bir videonun oynatma listesi bağlamında görüntülenme sayısını gösterir. Bu metrik, birden fazla kişinin televizyon ekranında birlikte izlediği ortak görüntülemeleri içerir.
YouTube Yardım Merkezi'nde, görüntüleme sayılarının nasıl raporlandığı hakkında daha fazla bilgi 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 giriş yapmış olan izleyicilerin yüzdesi. This is a core metric and is subject to the Deprecation Policy.
Erişim metrikleri
- video_thumbnail_impressions
- Video küçük resimlerinin izleyicilere gösterilme sayısıdır. Gösterimler, küçük resim 1 saniyeden daha uzun süre gösterildiğinde ve küçük resmin en az %50'si ekranda görüldüğünde sayılır. Daha fazla bilgi için YouTube Yardım Merkezi'ne göz atabilirsiniz.
- video_thumbnail_impressions_ctr
- Videoyu izlemek için tıklamayla sonuçlanan gösterimlerin yüzdesi. Bu değer, tıklama sayısının gösterim sayısına bölünmesiyle hesaplanır.
İzlenme süresi metrikleri
- watch_time_minutes (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ş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.
- 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 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.
- average_view_duration_percentage
- 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ç tutmaktadır.
Etkileşim metrikleri
- comments (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. - 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 dahil olmak üzere çeşitli yerlerde abone kazanabilir veya kaybedebilir. Temel kullanıcı etkinliği raporunda, video izleme sayfası üzerinden abone olmayan yeni kanal abonelerinin sayısını belirlemek için video_id boyut değerini belirtmeyen bir satır bulunur. Bu satırdasubscribersLostmetriği için de bir değer belirtilir ancak diğer metrikler için değer belirtilmez. - subscribers_lost (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,subscribers_gainedmetriğine benzer şekilde raporlanır. Temel kullanıcı etkinliği raporunda, abonelikten çıkan ancak video izleme sayfasında abonelikten çıkmayan kullanıcıların sayısını belirlemek için video_id boyut değerini belirtmeyen bir satır bulunur. Bu satırdasubscribers_gainedmetriği için de bir değer belirtilir ancak diğer metrikler için değer belirtilmez. - videos_added_to_playlists
- 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. - videos_removed_from_playlists
- 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.
- 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'ni ziyaret edin. Bu metrik mutlak bir sayı 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, 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 listelerinden kaldırma sayısı. Bu metrik mutlak bir sayı döndürür. Yani bir kullanıcı bir oynatma listesini kaydeder, kaydedilen 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.
Not metrikleri
- annotation_impressions
- Notların toplam gösterim sayısı.
- annotation_clickable_impressions
- Gösterilen 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 oluşturma ve bağlantı notlarını kullanma hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde bulabilirsiniz.
- annotation_closable_impressions
- Gösterilen ve kapatılabilen ek açıklamaların sayısı.
- annotation_closes
- Kapatılan ek açıklamaların 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
YouTube Yardım Merkezi'nde, videolarınıza kart ekleme ve YouTube Analytics Kartlar Raporu hakkında daha ayrıntılı talimatlar bulabilirsiniz.
- card_impressions
- Kartların gösterilme sayısıdır. 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ı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.
Bitiş ekranı metrikleri
Bitiş ekranları, videonun son 5 ila 20 saniyesinde gösterilen ve içeriğinizi, kanalınızı ve web sitelerinizi tanıtan öğelerdir. YouTube Yardım Merkezi'nde, videolarınıza bitiş ekranı ekleme ve YouTube Analytics Bitiş Ekranları Raporu hakkında daha ayrıntılı talimatlar bulabilirsiniz.
- 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ıdır.
- end_screen_element_click_rate
- Bitiş ekranı öğelerinin tıklama oranı, bitiş ekranı öğesi tıklama sayısının bitiş ekranı öğesi gösterim sayısına oranı olarak hesaplanır.
Ü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.
- 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 gelirdir.
- 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 gelirdir.
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ırmayla satılan reklamlardan elde edilen tahmini toplam kazançtır (net gelir). Bu metrik daha önce
estimated_partner_ad_sense_revenueolarak 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 sunulan-satılan reklamlardan elde edilen tahmini toplam kazanç (net gelir). Bu metrik daha önce
estimated_partner_double_click_revenueolarak 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 tahmini toplam kazanç (net gelir).
- estimated_partner_transaction_revenue (yalnızca YouTube Reporting API'de desteklenir)
- Ücretli içerikler ve takipçi desteği gibi işlemlerden elde edilen toplam tahmini gelirdir. İş ortağı tarafından alınan geri ödemeler bu tutardan düşülür.
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 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.
- estimated_cpm
- Bin reklam gösterimi başına tahmini brüt gelir.
- ad_impressions
- Yayınlanan doğrulanmış reklam gösterimlerinin sayısı.
- estimated_monetized_playbacks
- İ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.
- estimated_playback_based_cpm
- Bin oynatma başına tahmini brüt gelir.