YouTube Analytics API: Content Owner Reports

Not: Content owner reports are only accessible to YouTube content partners who participate in the YouTube Partner Program.

Bu sayfada, içerik sahiplerinin YouTube Analytics API ile alabileceği raporlar listelenmektedir. İçerik sahibi raporları, belirtilen bir YouTube içerik sahibine bağlı kanalların metriklerini içerir. Metrikler, kullanıcı etkinliği, reklam performansı veya tahmini gelirle ilgili bağımsız ölçümlerdir.

  • Video raporları, içerik sahibinin kanallarındaki videolarla ilgili kullanıcı etkinliği, reklam performansı ve tahmini gelir metriklerini içerir.

  • Oynatma listesi raporları, özellikle bir oynatma listesi bağlamında gerçekleşen video görüntülemeleriyle ilgili istatistikler sağlar. Oynatma listesi raporları, video raporlarıyla aynı boyut ve filtrelerin çoğunu kullanır.

  • Reklam performansı raporları, gelir ve reklam performansıyla ilgili metrikleri içerir. Metrikleri, video oynatmaları sırasında yayınlanan reklam türlerine göre gruplandırmak için adType boyutunu kullanırlar. Reklam performansı raporları bölümünde, API'nin desteklediği iki tür reklam performansı metriği açıklanmaktadır.

Rapor alma

İçerik sahibi raporu almak için API'nin reports.query yöntemini çağırın ve API isteğinde ids parametre değerini contentOwner==OWNER_NAME olarak ayarlayın. Burada OWNER_NAME, içerik sahibinin kimliğini belirtir. Değerden emin değilseniz iş ortağı yöneticinize danışın.

Yetkilendirme

Tüm YouTube Analytics API istekleri yetkilendirilmelidir. Yetkilendirme kılavuzunda, yetkilendirme jetonlarını almak için OAuth 2.0 protokolünün nasıl kullanılacağı açıklanmaktadır.

YouTube Analytics API istekleri aşağıdaki yetkilendirme kapsamlarını kullanır:

Kapsamlar
https://www.googleapis.com/auth/yt-analytics.readonly YouTube içeriğiniz için YouTube Analytics raporlarını görüntüleyin. Bu kapsam, görüntüleme sayısı ve puan sayısı gibi kullanıcı etkinliği metriklerine erişim sağlar.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly YouTube içeriğiniz için YouTube Analytics'teki parasal raporları görüntüleyin. Bu kapsam, kullanıcı etkinliği metriklerine, tahmini gelir ve reklam performansı metriklerine erişim sağlar.
https://www.googleapis.com/auth/youtube YouTube hesabınızı yönetin. YouTube Analytics API'de kanal sahipleri, YouTube Analytics gruplarını ve grup öğelerini yönetmek için bu kapsamı kullanır.
https://www.googleapis.com/auth/youtubepartner YouTube'daki YouTube öğelerini ve ilişkili içeriği görüntüleyin ve yönetin. YouTube Analytics API'de içerik sahipleri, YouTube Analytics gruplarını ve grup öğelerini yönetmek için bu kapsamı kullanır.

Not: Yıldızla (*) işaretlenen metrikler için https://www.googleapis.com/auth/yt-analytics-monetary.readonly kapsamına erişim izni veren bir yetkilendirme jetonu gerekir.

Filtreler

İçerik sahibi raporlarını almak için yapılan tüm API isteklerinde video boyutu, channel boyutu, isCurated boyutu veya claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonu kullanılarak veriler filtrelenmelidir. (Desteklenen kombinasyonlar uploaderType boyutunun tanımında listelenmiştir.)

Desteklenen raporları açıklayan tablolarda, belirli bir rapor için kullanılabilecek filtreler tanımlanır. Açıklamalarda parantez içinde gösterilen filtreler isteğe bağlıdır. Örneğin, bir raporda filtreleme seçeneği olarak video(,country) listeleniyorsa rapor, yalnızca belirli bir videoya ait verileri veya yalnızca belirli bir ülkedeki belirli bir videoya ait verileri içerecek şekilde filtrelenebilir.

API, video, playlist ve channel filtreleri için birden fazla değer belirtme özelliğini de destekler. Bu filtrelerden biri için birden fazla değer belirtirseniz söz konusu filtreyi istek için belirttiğiniz boyutlar listesine de ekleyebilirsiniz. Bu durum, filtre belirli bir rapor için desteklenen bir boyut olarak listelenmemiş olsa bile geçerlidir.

API sonuçlarının belirli bir değere veya değer grubuna göre nasıl filtreleneceğine dair tam açıklama için filters parametre tanımına bakın.

Rapor tablolarını anlama

Bu bölümde, API'nin desteklediği raporları tanımlayan tablolarda kullanılan biçimlendirme ve terminoloji açıklanmaktadır. Aşağıdaki tabloda, zaman boyutunu ve averageViewPercentage metriğini kullanan oynatma ayrıntıları video raporu için desteklenen boyutlar, metrikler ve filtreler listelenmiştir.

İçindekiler
Boyutlar:
0 veya daha fazla kullanın creatorContentType, subscribedStatus, youtubeProduct
0 veya 1 kullanın day, month
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtreler:
0 veya 1 kullanın country, province, continent, subContinent
0 veya 1 kullanın video, group
0 veya daha fazla kullanın subscribedStatus, youtubeProduct

Tabloda boyutlar için iki, metrikler için bir ve filtreler için üç satır bulunur. Boyutlar ve filtreler için, her satırdaki değerler, kombinasyon tablodaki kullanım kurallarına uyduğu sürece bir API isteğinde birleştirilebilir. Örneğin, bu rapor için geçerli dimensions parametre değerleri şunlardır:

  • dimensions=day
  • dimensions=day,subscribedStatus
  • dimensions=month,subscribedStatus,youtubeProduct
  • dimensions=month,youtubeProduct

Ancak day,month parametre değeri, zamana dayalı iki boyut kullandığından geçersizdir ve istekte 0 veya 1 kullanılmalıdır.

Rapor tablosu terminolojisi

Tablolarda, boyutların gerekli mi yoksa isteğe bağlı mı olduğunu belirtmek için aşağıdaki terminoloji kullanılır:

  • Aşağıdaki terimler, bir değer gerektiğini gösterir:
    • Zorunlu: Değeri eklemeniz gerekir.
    • Tam olarak 1 tane kullanın: Gruptan bir değer eklemeniz gerekir.
    • 1 veya daha fazlasını kullanın: Gruptaki herhangi bir değeri veya tüm değerleri dahil edebilirsiniz ancak en az bir değer eklemeniz gerekir.
  • Aşağıdaki terimler, bir değerin isteğe bağlı olduğunu gösterir:
    • İsteğe bağlı: Değeri ekleme seçeneğiniz vardır.
    • 0 veya 1 kullanın: Gruptan bir değer ekleyebilirsiniz.
    • 0 veya daha fazla değer kullanın: Gruptaki herhangi bir değeri veya tüm değerleri dahil edebilirsiniz.
Önemli: İçerik sahibi video raporlarını almak için yapılan tüm API isteklerinde, video boyutu, kanal boyutu, grup boyutu veya claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonu kullanılarak veriler filtrelenmelidir. (Bazı raporlar bu seçeneklerin tümünü desteklemez.) uploaderType boyutunun tanımında da listelenen desteklenen kombinasyonlar şunlardır:
  • uploaderType==self
  • claimedStatus==claimed
  • claimedStatus==claimed;uploaderType==self
  • claimedStatus==claimed;uploaderType==thirdParty

Video raporları

Temel istatistikler

Temel istatistikler (abone sayıları dahil)

Bu rapor, içerik sahibinin tüm kanallarındaki kullanıcı işlemleriyle ilgili istatistikleri sağlar. Raporu yalnızca belirli bir video veya ülkeye ait verileri döndürecek şekilde filtreleyebilirsiniz. Ayrıca, içerik sahibi, üçüncü taraflar veya her ikisi tarafından yüklenen hak talebinde bulunulan içerikler dahil olmak üzere yalnızca hak talebinde bulunulan içeriklerle ilgili istatistikleri almak için de kullanılabilir.

İçindekiler
Boyutlar:
[Yok]
Metrikler:
1 veya daha fazla views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm*
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent

ABD eyaletleri için temel istatistikler

Bu raporda, belirli bir ABD eyaleti veya District of Columbia ile ilgili istatistikler sunulur. Bu raporun, yukarıda açıklanan ülkeye özgü raporda bulunan metriklerin yalnızca bir alt kümesini desteklediğini unutmayın.

İçindekiler
Boyutlar:
[Yok]
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
Zorunlu province

Zamana dayalı

Dönemler için etkinlik

Bu rapor, belirli zaman aralıklarında içerik sahibinin tüm kanallarındaki kullanıcı işlemleriyle ilgili istatistikleri sağlar. Raporu yalnızca belirli bir video veya ülkeye ait verileri döndürecek şekilde filtreleyebilirsiniz.

İçindekiler
Boyutlar:
Tam olarak 1 tane kullanın day, month
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, uniques, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm*
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent

ABD eyaletlerindeki kullanıcı etkinliği (belirli dönemler için)

Bu raporda, belirli bir ABD eyaleti veya District of Columbia ile ilgili istatistikler sunulur. Bu raporun, yukarıda açıklanan ülkeye özgü raporda bulunan metriklerin yalnızca bir alt kümesini desteklediğini unutmayın.

İçindekiler
Boyutlar:
Tam olarak 1 tane kullanın day, month
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
Zorunlu province

Kullanıcının bulunduğu coğrafi bölge

Ülkeye göre kullanıcı etkinliği

Bu rapor, içerik sahibinin tüm kanalları için ülke bazında kullanıcı etkinliğiyle ilgili istatistikler sağlar. Raporu yalnızca belirli bir video veya kanala ait verileri döndürecek şekilde filtreleyebilirsiniz.

İçindekiler
Boyutlar:
Zorunlu country
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm*
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın continent, subContinent

İle göre kullanıcı etkinliği

Bu rapor, ABD eyaletleri ve Washington D.C. için kullanıcı etkinliği istatistiklerini sağlar. Bu rapor için filters parametre değerini country==US olarak ayarlamanız gerekir.

İçindekiler
Boyutlar:
Zorunlu province
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
Zorunlu country==US

Şehre göre kullanıcı etkinliği (<= 250 sonuç)

Not: Bu rapor için maxResults parametresini 250 veya daha düşük bir tam sayı değerine ayarlamanız gerekir. Diğer raporların çoğundan farklı olarak bu raporda sort istek parametresi için bir değer belirtmeniz de gerekir.

Bu rapor, şehire göre kullanıcı etkinliği istatistiklerini sağlar.

İçindekiler
Boyutlar:
Zorunlu city
0 veya daha fazla kullanın creatorContentType, country, province, subscribedStatus

Not: province boyutunu dahil ederseniz country==US filtresini de kullanmanız gerekir.
0 veya 1 kullanın day, month
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
Sıralama seçenekleri: -views
-estimatedMinutesWatched

Oynatma ayrıntıları

Oynatma ayrıntıları raporları, aşağıdaki izleme özellikleriyle ilgili istatistikler sağlar:

  • İzlediğiniz içerik canlı video yayını mı yoksa isteğe bağlı video mu?
  • İzleyici, videonun sahibi olan kanala abone miydi?
  • Görüntüleme hangi YouTube ürününde gerçekleşti?

Teknik olarak, bu raporların desteklediği oynatma ayrıntısı boyutlarının tümü isteğe bağlıdır. İsteğinize oynatma ayrıntısı boyutlarını eklemezseniz döndürülen rapor aslında temel istatistikler, zamana dayalı veya kullanıcı coğrafyası raporlarından birine benzer.

Not: liveOrOnDemand boyutu ve filtresi, averageViewPercentage metriğiyle birlikte kullanılamaz. Bu nedenle, aşağıdaki alt bölümlerin her biri iki rapor listeler. Bir rapor liveOrOnDemand boyutunu (ve filtresini) desteklerken diğeri averageViewPercentage metriğini destekler.

Abonelik durumuna göre kullanıcı etkinliği

Bu rapor, abone olan ve olmayan izleyiciler için kullanıcı etkinliği metriklerini sağlar. İstatistikler döneme (gün veya ay) göre gruplandırılabilir. Rapor ayrıca ülkeye, kıtaya veya subContinent göre de filtrelenebilir.

İçindekiler
Boyutlar:
0 veya daha fazla kullanın creatorContentType, subscribedStatus
0 veya 1 kullanın day, month
Metrikler:
1 veya daha fazla views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent
İsteğe bağlı subscribedStatus

İllere göre abonelik durumuna göre kullanıcı etkinliği

Bu rapor, ABD eyaletlerindeki veya District of Columbia'daki abone olan ve aboneliği iptal eden izleyiciler için kullanıcı etkinliği metriklerini sağlar. Bu rapor, önceki rapora kıyasla daha az metriği destekler.

İçindekiler
Boyutlar:
0 veya daha fazla kullanın creatorContentType, subscribedStatus
0 veya 1 kullanın day, month
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
Zorunlu province
İsteğe bağlı subscribedStatus

İsteğe bağlı zaman boyutu içeren oynatma ayrıntıları

Raporun kapsayacağı tarih aralığını belirtmek için startDate ve endDate istek parametrelerini kullanmanız gerektiğinden, zaman boyutu (gün veya ay) bu raporlar için isteğe bağlıdır. Mevcut olduğunda boyut, rapordaki verilerin güne, aya vb. göre birleştirilmesini istediğinizi gösterir.

İsteğe bağlı zaman boyutu ve liveOrOnDemand istatistikleri içeren oynatma ayrıntıları

Bu rapor, belirli zaman aralıkları için oynatma ayrıntıları istatistikleri sağlar. liveOrOnDemand boyutunu (ve filtresini) destekler.

İçindekiler
Boyutlar:
0 veya daha fazla kullanın creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
0 veya 1 kullanın day, month
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus, youtubeProduct
İsteğe bağlı zaman boyutu ve averageViewPercentage metriği ile oynatma ayrıntıları

Bu rapor, belirli zaman aralıkları için oynatma ayrıntıları istatistikleri sağlar.

İçindekiler
Boyutlar:
0 veya daha fazla kullanın creatorContentType, subscribedStatus, youtubeProduct
0 veya 1 kullanın day, month
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın subscribedStatus, youtubeProduct

Ülkeye göre oynatma ayrıntıları

liveOrOnDemand istatistikleriyle ülkeye göre oynatma ayrıntıları

Bu rapor, oynatma ayrıntılarıyla ilgili istatistikleri ülke bazında sunar. liveOrOnDemand boyutunu (ve filtresini) destekler.

İçindekiler
Boyutlar:
İsteğe bağlı country
0 veya daha fazla kullanın creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus, youtubeProduct
averageViewPercentage metriğiyle ülkeye göre oynatma ayrıntıları

Aşağıdaki rapor öncekine benzer. averageViewPercentage metriği için destek ekler ancak liveOrOnDemand boyutu veya filtresi desteklenmez.

İçindekiler
Boyutlar:
İsteğe bağlı country
0 veya daha fazla kullanın creatorContentType, subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın continent, subContinent
0 veya daha fazla kullanın subscribedStatus, youtubeProduct

İle göre oynatma ayrıntıları

liveOrOnDemand istatistikleriyle ilde oynatma ayrıntıları

Bu rapor, ABD eyaletleri ve Washington D.C. için oynatma ayrıntıları istatistiklerini sağlar. liveOrOnDemand boyutunu (ve filtresini) destekler.

İçindekiler
Boyutlar:
İsteğe bağlı province
0 veya daha fazla kullanın creatorContentType, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
Zorunlu country==US
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus, youtubeProduct
averageViewPercentage metriğiyle ilde oynatma ayrıntıları

Aşağıdaki rapor öncekine benzer. averageViewPercentage metriği için destek ekler ancak liveOrOnDemand boyutu veya filtresi desteklenmez.

İçindekiler
Boyutlar:
İsteğe bağlı province
0 veya daha fazla kullanın creatorContentType, subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
Zorunlu country==US
0 veya daha fazla kullanın subscribedStatus, youtubeProduct

Oynatma konumları

Video oynatma konumu raporu

Bu rapor, video oynatma işlemlerinin gerçekleştiği sayfa veya uygulama türüyle ilgili istatistikler sağlar.

İçindekiler
Boyutlar:
Zorunlu insightPlaybackLocationType
0 veya daha fazla kullanın creatorContentType, day, liveOrOnDemand, subscribedStatus
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus

Oynatma konumu ayrıntısı (<= 25 sonuç)

Not: Bu rapor için maxResults parametresini 25 veya daha düşük bir tam sayı değerine ayarlamanız gerekir. Diğer raporların çoğundan farklı olarak bu raporda sort istek parametresi için bir değer belirtmeniz de gerekir.

Bu rapor, içerik sahibinin içeriği için en çok görüntüleme veya izlenme süresi sağlayan yerleşik video oynatıcıları tanımlar. Bu raporu alırken insightPlaybackLocationType filtresini EMBEDDED olarak ayarlamanız gerekir.

İçindekiler
Boyutlar:
Zorunlu insightPlaybackLocationDetail
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
Zorunlu insightPlaybackLocationType==EMBEDDED
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus
Sıralama seçenekleri: -views
-estimatedMinutesWatched

Trafik kaynakları

Trafik kaynağı

Bu rapor, izleyicilerin video içeriğinize ulaşma şekline göre izleme istatistiklerini toplar. Örneğin, bir Google aramasından veya ilgili bir videonun bağlantısından gelen görüntüleme sayısını tanımlar.

Not: Sorgulanan video sayısı x tarih aralığındaki gün sayısı çarpımı 50.000'i aşarsa bu rapor hata döndürür. Örneğin, 500 video kimliğiyle ilgili verileri alan bir sorgu en fazla 100 günlük veri isteyebilir. Bir isteğin döndürdüğü satır sayısını azaltmak için sorgunuzu daha az video belirten veya daha kısa tarih aralıkları ayarlayan birden fazla sorguya bölün.

İçindekiler
Boyutlar:
Zorunlu insightTrafficSourceType
0 veya daha fazla kullanın creatorContentType, day, liveOrOnDemand, subscribedStatus
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus

Trafik kaynağı ayrıntısı (<= 25 sonuç)

Not: Bu rapor için maxResults parametresini 25 veya daha düşük bir tam sayı değerine ayarlamanız gerekir. Diğer raporların çoğundan farklı olarak bu raporda sort istek parametresi için bir değer belirtmeniz de gerekir.

Bu rapor, içerik sahibinin içeriği için en çok görüntüleme sağlayan yönlendiricilere göre görüntüleme istatistiklerini toplar. Yönlendirenler, trafik kaynağı türüne göre kategorize edilir ve insightTrafficSourceDetail boyutunun tanımı, raporun kullanılabildiği trafik kaynaklarını tanımlar. Örneğin, insightTrafficSourceType filtresini ADVERTISING olarak ayarlarsanız raporda, içerik sahibinin içeriği için en çok görüntüleme veya izlenme süresi sağlayan reklam türleri listelenir.

İçindekiler
Boyutlar:
Zorunlu insightTrafficSourceDetail
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
Zorunlu insightTrafficSourceType (tablonun altındaki nota bakın)
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus
Sıralama seçenekleri: -views
-estimatedMinutesWatched

Not: Bu rapor yalnızca belirli trafik kaynakları için desteklenir. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES ve NO_LINK_EMBEDDED trafik kaynakları desteklenmeyen kaynaklardan bazılarıdır.

Cihaz türü ve işletim sistemi

Cihaz türü

Bu rapor, izleyicilerin içeriklerinizi izlerken kullandığı cihaz türüne göre izleme istatistiklerini toplar. Örneğin, tabletlerde veya oyun konsollarında gerçekleşen görüntüleme sayısını tanımlar.

İçindekiler
Boyutlar:
Zorunlu deviceType
0 veya daha fazla kullanın creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın operatingSystem, liveOrOnDemand, subscribedStatus, youtubeProduct

İşletim sistemi

Bu rapor, izleme istatistiklerini izleyicilerin işletim sistemlerine göre toplar. Örneğin, Android cihazlarda veya PlayStation'larda gerçekleşen görüntüleme sayısını tanımlar.

İçindekiler
Boyutlar:
Zorunlu operatingSystem
0 veya daha fazla kullanın creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın deviceType, liveOrOnDemand, subscribedStatus, youtubeProduct

İşletim sistemi ve cihaz türü

Bu rapor, görüntüleme istatistiklerini izleyicilerin işletim sistemlerine ve cihaz türlerine göre toplar. Örneğin, Android tabletlerde veya Windows masaüstü cihazlarda gerçekleşen görüntüleme sayısını tanımlar.

İçindekiler
Boyutlar:
Zorunlu operatingSystem,deviceType
0 veya daha fazla kullanın creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus, youtubeProduct

İzleyici demografisi

Bu rapor, izleyicilere göre yaş grubu ve cinsiyete göre izleme istatistiklerini toplar.

İçindekiler
Boyutlar:
1 veya daha fazla ageGroup, gender
0 veya daha fazla kullanın creatorContentType, liveOrOnDemand, subscribedStatus
Metrikler:
1 veya daha fazla viewerPercentage
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus
Not: Bu rapordaki viewerPercentage değerleri, subscribedStatus oynatma ayrıntıları boyutunun farklı değerleri için normalleştirilmez.

Örneğin, bir raporda subscribedStatus boyutu kullanılıyorsa abone olunan görüntülemeler için yüzde 100'e eşit toplama sahip viewerPercentage verileri ve abonelikten çıkan görüntülemeler için yüzde 100'e eşit toplama sahip viewerPercentage verileri döndürülür. (Rapordaki tüm viewerPercentage alanlarının toplam değeri yüzde 200'dür.)

Raporun yalnızca subscribedStatus boyutunun bir değeri için viewerPercentage verileri içermesini sağlamak üzere filtreler kullanabilirsiniz.

Etkileşim ve içerik paylaşımı

Bu rapor, kanalın videolarının farklı sosyal medya platformlarında ne sıklıkta paylaşıldığını gösteren istatistikleri sunar.

İçindekiler
Boyutlar:
Zorunlu sharingService
İsteğe bağlı creatorContentType, subscribedStatus
Metrikler:
1 veya daha fazla paylaşımlar
Filtreler:
Tam olarak 1 tane kullanın video, channel, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent
İsteğe bağlı subscribedStatus

Kitleyi elde tutma

Bu rapor, bir videonun kitleyi elde tutma oranını ölçer. elapsedVideoTimeRatio boyutu, ilgili metrik değerleri için videonun oynatıldığı süreyi ölçer. audienceWatchRatio ve relativeRetentionPerformance metrikleri, videonun kitleyi ne kadar iyi tuttuğunu gösteren iki ölçüm sağlar. Bunlardan ilki mutlak bir değerdir. İkincisi ise videonun benzer uzunluktaki diğer YouTube videolarına kıyasla nasıl performans gösterdiğini gösterir.

Not: Kitleyi elde tutma raporları, video filtresi için virgül ile ayrılmış bir değer listesi belirtme özelliğini desteklemez. Değer, tek bir video kimliği belirtmelidir.

İçindekiler
Boyutlar:
Zorunlu elapsedVideoTimeRatio
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla audienceWatchRatio, relativeRetentionPerformance
Filtreler:
Zorunlu video
0 veya daha fazla kullanın audienceType, subscribedStatus, youtubeProduct

En popüler videolar

Not: Bu raporlar için maxResults parametresini 200 veya daha düşük bir tam sayı değerine ayarlamanız gerekir. 1 Ocak 2013'ten önceki veriler yalnızca en popüler 10 video için kullanılabilir. Diğer raporların çoğundan farklı olarak bu raporlarda sort istek parametresi için bir değer belirtmeniz de gerekir.

Ülkeye, kıtaya veya alt kıtaya göre en popüler videolar (<= 200 sonuç)

Bu raporda, belirtilen filtreleme ve sıralama ölçütlerine göre içerik sahibinin en popüler videoları listelenir.

İçindekiler
Boyutlar:
Zorunlu video
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, redViews, comments, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks, subscribersGained, subscribersLost, estimatedRevenue*, estimatedAdRevenue*, grossRevenue*, estimatedRedPartnerRevenue*, monetizedPlaybacks*, playbackBasedCpm*, adImpressions*, cpm*
Filtreler:
Tam olarak 1 tane kullanın channel veya uploaderType ile claimedStatus özelliklerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent
Sıralama seçenekleri: -views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

ABD eyaletlerine göre en popüler videolar (<= 200 sonuç)

Bu raporda, içerik sahibinin belirli bir ABD eyaletinde veya District of Columbia'da en çok görüntülenen videoları listelenir. Bu raporun, yukarıda açıklanan ülkeye özgü raporda bulunan metriklerin yalnızca bir alt kümesini desteklediğini unutmayın.

İçindekiler
Boyutlar:
Zorunlu video
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 tane kullanın channel veya uploaderType ile claimedStatus özelliklerinin desteklenen bir kombinasyonu
Zorunlu province
Sıralama seçenekleri: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Abone olan veya aboneliği iptal eden izleyiciler için en popüler videolar(<= 200 sonuç)

Bu raporda, abone olan veya aboneliği iptal eden izleyiciler için en popüler videolar listelenir. Rapor, en popüler videoları ülkeye, kıtaya veya subContinent göre listeleyecek şekilde filtrelenebilir. Önceki rapor, abone olan veya aboneliği iptal eden izleyiciler için belirli bir ABD eyaletinde en çok izlenen videoları almanıza olanak tanır ancak bu rapordan daha az metriği destekler.

İçindekiler
Boyutlar:
Zorunlu video
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, redViews, likes, dislikes, videosAddedToPlaylists, videosRemovedFromPlaylists, shares, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 tane kullanın channel veya uploaderType ile claimedStatus özelliklerinin desteklenen bir kombinasyonu
İsteğe bağlı subscribedStatus
0 veya 1 kullanın country, continent, subContinent
Sıralama seçenekleri: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

YouTube Ürününe göre en popüler videolar (<= 200 sonuç)

Bu raporda en popüler videolar listelenir ve oynatma ayrıntıları ile coğrafi filtreler desteklenir. Bu rapor öncekine benzer ancak daha az metriği destekler ve youtubeProduct filtresini destekler.

İçindekiler
Boyutlar:
Zorunlu video
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtreler:
Tam olarak 1 tane kullanın channel veya uploaderType ile claimedStatus özelliklerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın subscribedStatus, youtubeProduct
Sıralama seçenekleri: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Oynatma ayrıntısı filtreleri içeren en popüler videolar (<= 200 sonuç)

Bu raporda, içerik sahibinin en popüler videoları listelenmiştir. Videolar, liveOrOnDemand, subscribedStatus ve youtubeProduct oynatma ayrıntısı boyutlarına göre filtrelenir. Rapor, bölgeye göre filtrelemeyi de destekler.

İçindekiler
Boyutlar:
Zorunlu video
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtreler:
Tam olarak 1 tane kullanın channel veya uploaderType ile claimedStatus özelliklerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus, youtubeProduct
Sıralama seçenekleri: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Oynatma listesi raporları

Oynatma listesi raporları, kanal sahibinin oynatma listelerindeki videolarla ilgili kullanıcı etkinliğiyle ilgili metrikleri içerir. Bu raporların iki sürümü vardır ve her rapor için aşağıdaki bölümlerde her bir sürümün açıklaması yer alır:

  • Her bölümdeki Önerilen sekmesinde, ilgili raporu almak için tercih edilen API istek biçimi açıklanır. Önerilen raporlar hem toplu video metriklerini hem de oynatma listesi metriklerini içeren geniş bir metrik grubunu destekler. Bu istek biçiminde isCurated boyutu kullanılmaz.
  • Her bölümdeki isCurated kullanma sekmesinde, isCurated boyutunun gerekli olduğu eski bir API istek biçimi açıklanmaktadır. Bu raporlar yalnızca oynatma listesi metriklerini destekler. isCurated boyutunun tüm raporlarda desteğinin sonlandırıldığını unutmayın. Aşağıdaki uyarı notunda desteğin sonlandırılma planı açıklanmaktadır.

Aşağıdaki uyarı notunda, iki rapor sürümü arasındaki değişiklikler daha ayrıntılı olarak açıklanmaktadır.

Toplu video metrikleri

Bu metrikler, oynatma listesindeki ve oynatma listesinin sahibi olan kanala ait tüm videolar için toplu kullanıcı etkinliği ve gösterim metrikleri 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.

YouTube'un desteklediği toplu video metriklerinin listesi için desteklenen oynatma listesi metrikleri bölümüne bakın.

Oynatma listesi metrikleri

Bu metrikler, 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.

Desteklenen oynatma listesi metrikleri

Temel istatistikler

Bu rapor, kullanıcıların içerik sahibinin kanallarındaki oynatma listelerindeki videolarla etkileşimleriyle ilgili istatistikleri sağlar. Raporda zorunlu boyut yok.

Önerilen
İçindekiler
Boyutlar:
[Yok]
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtreler:
0 veya 1 kullanın* playlist, group

Not: Raporda views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
İsteğe bağlı channel
isCurated
İçindekiler
Boyutlar:
[Yok]
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtreler:
Zorunlu isCurated==1
0 veya 1 kullanın channel, playlist, group
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın subscribedStatus, youtubeProduct

Zamana dayalı

Bu rapor, kullanıcıların belirli zaman aralıklarında içerik sahibinin kanallarındaki oynatma listelerindeki videolarla etkileşimleriyle ilgili istatistikleri sağlar. Raporu yalnızca belirli bir oynatma listesinin veya kanalın verilerini döndürecek şekilde filtreleyebilirsiniz.

Önerilen
İçindekiler
Boyutlar:
Tam olarak 1 tane kullanın day, month
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtreler:
0 veya 1 kullanın* playlist, group

Not: Raporda views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
İsteğe bağlı channel
isCurated
İçindekiler
Boyutlar:
Tam olarak 1 tane kullanın day, month
0 veya daha fazla kullanın subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtreler:
Zorunlu isCurated==1
0 veya 1 kullanın channel, playlist, group
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın subscribedStatus, youtubeProduct

Kullanıcının bulunduğu coğrafi bölge

Bu rapor, belirli bir ülkedeki kullanıcıların kanalın oynatma listelerindeki videolarla etkileşimleriyle ilgili istatistikleri sağlar.

Bu raporda, oynatma listesi istatistikleri ülkeye göre sunulur.

Oynatma listesi etkinliği (ilere göre)

Bu rapor, ABD eyaletleri ve Washington D.C. için oynatma listesi etkinliği istatistiklerini sağlar. Bu rapor için filters parametre değerine country==US değerini dahil edersiniz.

Oynatma konumları

Bu rapor, oynatma listelerinin oynatıldığı sayfa veya uygulama türüyle ilgili istatistikler sağlar.

Önerilen
İçindekiler
Boyutlar:
Zorunlu insightPlaybackLocationType
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtreler:
0 veya 1 kullanın* playlist, group

Not: Raporda views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
İsteğe bağlı channel

Oynatma konumu ayrıntısı (<= 25 sonuç)

Not: Bu rapor için maxResults parametresini 25 veya daha düşük bir tam sayı değerine ayarlamanız gerekir. Diğer raporların çoğundan farklı olarak bu raporda sort istek parametresi için bir değer belirtmeniz de gerekir.

Bu rapor, içerik sahibinin oynatma listeleri için en çok görüntüleme veya izlenme süresi sağlayan yerleşik video oynatıcıları tanımlar.

Önerilen
İçindekiler
Boyutlar:
Zorunlu insightPlaybackLocationDetail
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtreler:
Zorunlu insightPlaybackLocationType==EMBEDDED
0 veya 1 kullanın* playlist, group

Not: Raporda views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
İsteğe bağlı channel
Sıralama seçenekleri: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Trafik kaynakları

Bu rapor, izleyicilerin oynatma listesi içeriğinize ulaşma şekline göre izleme istatistiklerini toplar. Örneğin, bir Google aramasından veya kanal sayfasından gelen görüntüleme sayısını tanımlar.

Önerilen
İçindekiler
Boyutlar:
Zorunlu insightTrafficSourceType
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtreler:
0 veya 1 kullanın* playlist, group

Not: Raporda views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
İsteğe bağlı channel

Trafik kaynağı ayrıntısı (<= 25 sonuç)

Not: Bu rapor için maxResults parametresini 25 veya daha düşük bir tam sayı değerine ayarlamanız gerekir. Diğer raporların çoğundan farklı olarak bu raporda sort istek parametresi için bir değer belirtmeniz de gerekir.

Bu rapor, içerik sahibinin oynatma listeleri için en çok görüntüleme sağlayan yönlendiricilere göre görüntüleme istatistiklerini toplar. Yönlendirenler, trafik kaynağı türüne göre kategorize edilir ve insightTrafficSourceDetail boyutunun tanımı, raporun kullanılabildiği trafik kaynaklarını tanımlar. Örneğin, insightTrafficSourceType filtresini ADVERTISING olarak ayarlarsanız raporda, içerik sahibinin oynatma listeleri için en çok görüntüleme veya izlenme süresi sağlayan reklam türleri listelenir.

Önerilen
İçindekiler
Boyutlar:
Zorunlu insightTrafficSourceDetail
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtreler:
Zorunlu insightTrafficSourceType
0 veya 1 kullanın* playlist, group

Not: Raporda views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
İsteğe bağlı channel
Sıralama seçenekleri: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Not: Bu rapor yalnızca belirli trafik kaynakları için desteklenir. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES ve NO_LINK_EMBEDDED trafik kaynakları desteklenmeyen kaynaklardan bazılarıdır.

Cihaz türü ve işletim sistemi

Oynatma listeleri için cihaz türü

Bu rapor, izleyiciler oynatma listesi içeriğinizi izlemek için kullandıkları cihaz türüne göre izleme istatistiklerini toplar. Örneğin, mobil cihazlarda veya oyun konsollarında gerçekleşen görüntüleme sayısını tanımlar.

Önerilen
İçindekiler
Boyutlar:
Zorunlu deviceType
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtreler:
0 veya 1 kullanın* playlist, group

Not: Raporda views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
İsteğe bağlı channel

Oynatma listeleri için işletim sistemi

Bu rapor, izleme istatistiklerini izleyicilerin işletim sistemlerine göre toplar. Örneğin, Android cihazlarda veya PlayStation'larda gerçekleşen oynatma listesi görüntüleme sayısını tanımlar.

Önerilen
İçindekiler
Boyutlar:
Zorunlu operatingSystem
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtreler:
0 veya 1 kullanın* playlist, group

Not: Raporda views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
İsteğe bağlı channel

Oynatma listeleri için işletim sistemi ve cihaz türü

Bu rapor, görüntüleme istatistiklerini izleyicilerin işletim sistemlerine ve cihaz türlerine göre toplar. Örneğin, Android tabletlerde veya Windows masaüstü cihazlarda gerçekleşen oynatma listesi görüntüleme sayısını tanımlar.

Önerilen
İçindekiler
Boyutlar:
Zorunlu deviceType, operatingSystem
Metrikler:
1 veya daha fazla views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistStarts, playlistViews, viewsPerPlaylistStart
Filtreler:
0 veya 1 kullanın* playlist, group

Not: Raporda views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
İsteğe bağlı channel

İzleyici demografisi

Bu rapor, izleyicilere göre yaş grubu ve cinsiyete göre izleme istatistiklerini toplar.

Not: Bu rapordaki viewerPercentage değerleri, oynatma ayrıntısı boyutları (subscribedStatus ve youtubeProduct) için farklı değerlere veya değer kombinasyonlarına göre normalleştirilmez.

Örneğin, subscribedStatus boyutunu kullanan bir rapor, abone olunan görüntülemeler için toplam yüzde 100'e ulaşan viewerPercentage verileri ve abone olunmayan görüntülemeler için toplam yüzde 100'e ulaşan viewerPercentage verileri döndürür. (Rapordaki tüm viewerPercentage alanlarının toplam değeri yüzde 200'dür.)

Oynatma ayrıntısı boyutları için raporda yalnızca bir değere (veya değer kombinasyonuna) ait viewerPercentage verilerinin yer aldığından emin olmak üzere filtreler kullanabilirsiniz.

En iyi oynatma listeleri

Not: Bu raporlar için maxResults parametresini 200 veya daha düşük bir tam sayı değerine ayarlamanız gerekir. 1 Ocak 2013'ten önceki veriler yalnızca ilk 10 oynatma listesi için kullanılabilir. Diğer raporların çoğundan farklı olarak bu raporlarda sort istek parametresi için bir değer belirtmeniz de gerekir.

Bu raporda, belirtilen filtreleme ve sıralama ölçütlerine göre içerik sahibinin en popüler oynatma listeleri listelenir.

isCurated
İçindekiler
Boyutlar:
Zorunlu playlist
Metrikler:
1 veya daha fazla views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist
Filtreler:
Zorunlu isCurated==1
0 veya 1 kullanın playlist, channel
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın subscribedStatus, youtubeProduct
Sıralama seçenekleri: -views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-playlistStarts

Reklam performans raporları

Not: Reklam performansı raporları için https://www.googleapis.com/auth/yt-analytics-monetary.readonly kapsamına erişim izni veren bir yetkilendirme jetonu gerekir.

Reklam performansı raporları, video oynatmaları sırasında yayınlanan reklamlar için gösterime dayalı metrikler sağlar. Bu metrikler her reklam gösterimini hesaba katar ve her video oynatma işlemi birden fazla gösterim sağlayabilir.

Gösterime dayalı reklam performansı metrikleri şunlardır:

Ayrıca bazı video raporları, oynatmaya dayalı aşağıdaki reklam performansı metriklerini destekler. Ancak bu metrikler reklam performansı raporlarına dahil edilmez.

Reklam türüne göre reklam performansı

İçindekiler
Boyutlar:
Zorunlu adType
İsteğe bağlı day
Metrikler:
1 veya daha fazla grossRevenue, adImpressions, cpm
Filtreler:
Tam olarak 1 tane kullanın video, group veya uploaderType ile claimedStatus değerlerinin desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent