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 gelirin ayrı ayrı ölçümleridir. Kullanıcı etkinliği metrikleri arasında video görüntüleme sayısı ve puanlar (beğenme ve beğenmeme) gibi öğeler yer alır.

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 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 desteği sonlandırma politikasına tabi YouTube API'lerinin listesini inceleyin.

Metrikleri göster

engaged_views (çekirdek metrik)
Kanal videolarının ilk birkaç saniyesinden sonraki görüntülenme 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 kaç kez görüntülendiğini gösterir. Görüntülemelerin nasıl bildirildiği hakkında 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 (önceki adı 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 (çekirdek metrik)
Kullanıcıların, belirtilen kanal, içerik sahibi, video veya oynatma listesindeki videoları izlediği süre (dakika cinsinden). This is a core metric and is subject to the Deprecation Policy.
red_watch_time_minutes
YouTube Premium (önceki adı YouTube Red) üyelerinin bir videoyu izlediği dakika sayısı.
average_view_duration_seconds (temel metrik)
Video oynatmalarının ortalama süresi (saniye cinsinden). 13 Aralık 2021 itibarıyla bu metrik, döngüye alınmış kliplerden gelen trafiği hariç tutar. Oynatma listesi raporunda bu metrik, oynatma listesi bağlamında gerçekleşen video oynatmalarının ortalama süresini saniye cinsinden gösterir. This is a core metric and is subject to the Deprecation Policy.
average_view_duration_percentage
Video oynatma sırasında videonun ortalama izlenme yüzdesi. 13 Aralık 2021 itibarıyla bu metrik, döngüye alınmış kliplerden gelen trafiği hariç tutar.

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ğenmeler (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 sayısı (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'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ıdır. This is a core metric and is subject to the Deprecation Policy.

Kanallar, abone kazanabilir veya kaybedebilir. Bu durum, video izleme sayfası, kanal sayfası ve YouTube ana sayfasında görünen rehber gibi çeşitli yerlerde gerçekleşebilir. Bir 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 de bir değer belirtilir ancak diğer metrikler için değer belirtilmez.
subscribers_lost (çekirdek metrik)
Kullanıcıların bir kanalın e-posta listesinden çıkma 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 ayrılan ancak video izleme sayfasında abonelikten ayrılmayan kullanıcıların 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 subscribers_gained metriği için de bir değer belirtilir ancak diğer metrikler için değer belirtilmez.
videos_added_to_playlists
Videoların herhangi bir YouTube oynatma listesine 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 eklenme sayısını içerir. Ancak bu metrik, videoların otomatik olarak eklendiği oynatma listelerini (ör. kanalın yüklemeler oynatma listesi veya kullanıcının izleme geçmişi) hesaba katmaz.

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 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 izle" 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 metrikle ilgili veriler, 1 Ekim 2014'ten önceki tarihler için kullanılamaz.

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 ve oynatma listesinin sahibi olan kanala ait tüm videolar için toplu olarak sunulan kullanıcı etkinliği ve gösterim metriklerini sağlar. Diğer kanallara ait videoların metrikleri toplama işleminde hesaplanmaz. Bu nedenle, bir kanal yalnızca diğer kanallara ait videoların bulunduğu bir oynatma listesi oluşturursa bu oynatma listeleriyle ilgili raporlarda bu metriklerin değerleri yer almaz.

    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 listesindeki metrikler, oynatma listesi sayfası bağlamındaki 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ıları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) ise oynatma listesindeki videolarla değil, oynatma listesiyle kullanıcı etkileşimleriyle ilgilidir. Bu nedenle, söz konusu metrikler toplu video metrikleri veya oynatma listesindeki metrikler olarak sınıflandırılmaz.

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ı oynatma listesini kaydeder, kayıtlı oynatma listeleri listesinden kaldırır ve tekrar kaydederse metrik değeri, iki oynatma listesi kaydının eklendiğini yansıtır.
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ı oynatma listesini kaydeder, 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ı yansıtır.

Ek açıklama metrikleri

annotation_impressions
Toplam not gösterimi sayısı.
annotation_clickable_impressions
Görünen ve tıklanabilen ek açıklama sayısı.
annotation_clicks
Tıklanan ek açıklama 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ıdır. 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örünen ve kapatılabilen ek açıklama sayısı.
annotation_closes
Kapatılan ek açıklama sayısı.
annotation_close_rate (çekirdek 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 Kart Raporu hakkında daha ayrıntılı talimatlar yer alır.

card_impressions
Kartların gösterilme sayısı. Kart paneli açıldığında video üzerindeki 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ıyla hesaplanır.
card_teaser_impressions
Kart bilgilerinin gösterilme sayısı. Bir video görüntüleme, birden fazla bilgi gösterimi oluşturabilir.
card_teaser_clicks
Kart bilgilerinin tıklanma sayısıdır. Kart simgesini tıklama sayısı, kullanıcıya gösterilen son bilgiyle ilişkilendirilir.
card_teaser_click_rate
Kart bilgilerinin tıklama oranıdır. Kart bilgisi tıklama sayısının toplam kart bilgisi gösterim 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 videonun 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 hakkında daha ayrıntılı talimatlar yer alır.

end_screen_element_impressions
Görüntülenen bitiş ekranı öğelerinin sayısı. Görüntülenen 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ı. Bu oran, bitiş ekranı öğesi tıklamalarının bitiş ekranı öğesi gösterimlerine oranı olarak hesaplanır.

Üyelik iptali metrikleri

membershipsCancellationSurveyResponses
Raporlama döneminde belirtilen kanalın üyeliklerini iptal eden YouTube kullanıcılarının tamamladığı anketlerin sayısı.

Tahmini gelir metrikleri

Not: Tahmini gelir metrikleri ay sonu düzenlemelerine tabidir ve iş ortağı tarafından satılan veya iş ortağı tarafından 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.

YouTube Reporting API, tüm tahmini gelir ve kazanç rakamlarını ABD doları cinsinden bildirir.
estimated_partner_revenue (tahmini_iş_ortağı_geliri) (çekirdek 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 reklamcılık kaynaklarından elde edilen toplam tahmini net gelir.

Tahmini gelir metrikleri ay sonu düzenlemesine tabidir ve iş ortakları tarafından satılıp yayınlanan reklamcılığı 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 reklamcılıktan elde edilen toplam tahmini kazanç (net gelir). Bu metriğin önceki adı estimated_partner_ad_sense_revenue idi.
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 temelinde satılan reklamlardan elde edilen toplam tahmini kazanç (net gelir). Bu metriğin önceki adı estimated_partner_double_click_revenue idi.
estimated_partner_red_revenue (yalnızca YouTube Reporting API'de desteklenir)
YouTube Premium (önceki adı YouTube Red) aboneliklerinden elde edilen toplam tahmini kazanç (net gelir).
estimated_partner_transaction_revenue (yalnızca YouTube Reporting API'de desteklenir)
İş ortağı tarafından alınan geri ödemeler çıkarıldıktan sonra ücretli içerikler ve Takipçi Bağışları gibi işlemlerden elde edilen toplam tahmini gelir.

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 ABD doları cinsinden tahmini brüt gelir. 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ın ve gelir paylaşımı sözleşmelerinizin dahil edildiği tahmini gelir veya net gelir ile 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österimiyle karşılaştığı durumların sayısı. İzleyiciye videodan önce gösterilen reklam gösterilirse ancak videonuz hiç başlamadan önce reklamı izlemeyi bırakırsa para kazanılan oynatma sayılır. Bu rakam için beklenen tahmini hata oranı ±%2,0'dır.
estimated_playback_based_cpm
Bin oynatma başına tahmini brüt gelir.