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ğinin, reklam performansının veya tahmini gelirin ayrı ayrı ölçümleridir.

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

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

  • Reklam performans raporları, gelir ve reklam performansıyla ilgili metrikleri içerir. Video oynatma sırasında yayınlanan reklam türlerine göre metrikleri 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ğindeki 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 sorun.

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 derecelendirme 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 finansal raporlarını görüntüleyin. Bu kapsam, kullanıcı etkinliği metriklerine, tahmini gelire ve reklam performansı metriklerine erişim sağlar.
https://www.googleapis.com/auth/youtube YouTube hesabınızı yönetin. Kanal sahipleri, YouTube Analytics API'de bu kapsamı kullanarak YouTube Analytics gruplarını ve grup öğelerini yönetir.
https://www.googleapis.com/auth/youtubepartner YouTube'daki YouTube öğelerini ve ilişkili içeriği görüntüleyin ve yönetin. İçerik sahipleri, YouTube Analytics API'de bu kapsamı kullanarak YouTube Analytics gruplarını ve grup öğelerini yönetir.

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

Filtreler

İçerik sahibi raporlarını almak için yapılan tüm API istekleri, verileri video boyutu, channel boyutu veya claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonu kullanılarak 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 video(,country) filtreleme seçeneği olarak listeleniyorsa rapor, yalnızca belirli bir videoya ait verileri içerecek şekilde veya yalnızca belirli bir ülkede 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 bu filtreyi, istek için belirttiğiniz boyutlar listesine de ekleyebilirsiniz. Bu durum, filtre belirli bir rapor için desteklenen boyut olarak listelenmemiş olsa bile geçerlidir.

API sonuçlarını belirli bir değere veya değer grubuna göre nasıl filtreleyeceğinizle ilgili eksiksiz bir 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 boyutu ve averageViewPercentage metriği kullanılarak oynatma ayrıntıları video raporu için desteklenen boyutlar, metrikler ve filtreler listelenmektedir.

İçindekiler
Boyutlar:
0 veya daha fazla kullanın creatorContentType, subscribedStatus, youtubeProduct
0 veya 1 kullanın day, month
Metrikler:
1 veya daha fazla kullanın engagedViews, 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 satır, metrikler için bir satır ve filtreler için üç satır bulunur. Boyutlar ve filtreler için, kombinasyon tablodaki kullanım kurallarına uyduğu sürece her satırdaki değerler bir API isteğinde birleştirilebilir. Bu nedenle, ö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ığı için 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ğerin gerekli olduğunu gösterir:
    • Zorunlu: Değeri eklemeniz gerekir.
    • Tam olarak 1 kullanın: Gruptan bir değer eklemeniz gerekir.
    • 1 veya daha fazla değer kullanın: Gruptaki değerlerin tamamını veya bir kısmını dahil edebilirsiniz ancak en az bir değer dahil etmeniz gerekir.
  • Bu terimler, bir değerin isteğe bağlı olduğunu gösterir:
    • İsteğe bağlı: Değeri ekleyebilirsiniz.
    • 0 veya 1 kullanın: Gruptan bir değer ekleyebilirsiniz.
    • 0 veya daha fazla değer kullanın: Gruptaki değerlerin tamamını ya da bir kısmını dahil edebilirsiniz.
Önemli: İçerik sahibinin video raporlarını almak için yapılan tüm API istekleri, verileri video boyutu, kanal boyutu, grup boyutu veya claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonu kullanılarak 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, bir 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 de dahil olmak üzere yalnızca hak talebinde bulunulan içeriklerin istatistiklerini almak için de kullanılabilir.

İçindekiler
Boyutlar:
[Yok]
Metrikler:
1 veya daha fazla kullanın adImpressions
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent

ABD eyaletleriyle ilgili temel istatistikler

Bu raporda, belirli bir ABD eyaleti veya District of Columbia'ya ait istatistikler yer alır. 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 kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
Zorunlu province

Zamana dayalı

Dönemlere göre etkinlik

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

İçindekiler
Boyutlar:
Tam olarak 1 kullanın day, month
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla kullanın adImpressions
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent

Belirli dönemlerde ABD eyaletlerindeki kullanıcı etkinliği

Bu raporda, belirli bir ABD eyaleti veya District of Columbia'ya ait istatistikler yer alır. 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 kullanın day, month
İsteğe bağlı creatorContentType
Metrikler:
1 veya daha fazla kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
Zorunlu province

Kullanıcının bulunduğu coğrafya

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

Bu rapor, bir içerik sahibinin tüm kanallarındaki kullanıcı etkinliğiyle ilgili ülke bazında 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 kullanın adImpressions
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
0 veya 1 kullanın continent, subContinent

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

Bu rapor, ABD eyaletleri ve Columbia Bölgesi'ndeki 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 kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un 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 rapor için sort istek parametresinin değerini de belirtmeniz gerekir.

Bu rapor, şehre 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 eklerseniz country==US filtresini de kullanmanız gerekir.
0 veya 1 kullanın day, month
Metrikler:
1 veya daha fazla kullanın engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageViewPercentage
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
Sıralama seçenekleri: -engagedViews
-views
-estimatedMinutesWatched

Oynatma ayrıntıları

Oynatma ayrıntıları raporları, aşağıdaki görüntüleme özellikleriyle ilgili istatistikler sağlar:

  • Canlı video yayını mı yoksa seç-izle video mu izleniyordu?
  • İ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ı dahil etmezseniz 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 birinde iki rapor listelenir. Bir rapor liveOrOnDemand boyutunu (ve filtresini), diğeri ise averageViewPercentage metriğini destekler.

Abone olma durumuna göre kullanıcı etkinliği

Bu rapor, abone olan ve olmayan izleyiciler için kullanıcı etkinliği metriklerini sağlar. İstatistikler zaman aralığına (gün veya ay) göre gruplandırılabilir. Rapor, ülke, kıta 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 kullanın engagedViews, 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 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent
İsteğe bağlı subscribedStatus

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

Bu rapor, ABD eyaletlerinde veya District of Columbia'da abone olan ve olmayan 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 kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
Zorunlu province
İsteğe bağlı subscribedStatus

İsteğe bağlı zaman boyutuyla oynatma ayrıntıları

Bu raporlarda, raporun kapsayacağı tarih aralığını belirtmek için startDate ve endDate istek parametrelerini kullanmanız gerektiğinden zaman boyutu (gün veya ay) isteğe bağlıdır. Boyut varsa rapordaki verilerin güne, aya vb. göre toplanmasını istediğinizi gösterir.

İsteğe bağlı zaman boyutu ve liveOrOnDemand istatistikleriyle oynatma ayrıntıları

Bu rapor, belirli zaman aralıkları için oynatma ayrıntılarıyla ilgili istatistikler 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 kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un 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ıyla ilgili istatistikler 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 kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un 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 sağlar. 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 kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un 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, önceki rapora benzer. averageViewPercentage metriği için destek ekler ancak liveOrOnDemand boyut veya filtre olarak desteklenmez.

İçindekiler
Boyutlar:
İsteğe bağlı country
0 veya daha fazla kullanın creatorContentType, subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
0 veya 1 kullanın continent, subContinent
0 veya daha fazla kullanın subscribedStatus, youtubeProduct

Eyalete göre oynatma ayrıntıları

liveOrOnDemand istatistikleriyle oynatma ayrıntılarını eyalete göre görüntüleme

Bu rapor, ABD eyaletleri ve District of Columbia 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 kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
Zorunlu country==US
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus, youtubeProduct
averageViewPercentage metriğiyle eyalete göre oynatma ayrıntıları

Aşağıdaki rapor, önceki rapora benzer. averageViewPercentage metriği için destek ekler ancak liveOrOnDemand boyut veya filtre olarak desteklenmez.

İçindekiler
Boyutlar:
İsteğe bağlı province
0 veya daha fazla kullanın creatorContentType, subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
Zorunlu country==US
0 veya daha fazla kullanın subscribedStatus, youtubeProduct

Oynatma konumları

Video oynatma konumu raporu

Bu rapor, video oynatmalarının 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 kullanın engagedViews, views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus

Oynatma konumu ayrıntıları (<= 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 rapor için sort istek parametresinin değerini de belirtmeniz gerekir.

Bu rapor, bir içerik sahibinin içeriği için en çok görüntüleme veya görüntüleme süresi sağlayan yerleştirilmiş video oynatıcıları belirler. 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 kullanın engagedViews, views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un 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: -engagedViews
-views
-estimatedMinutesWatched

Trafik kaynakları

Trafik kaynağı

Bu rapor, izleyicilerin video içeriğinize ulaşma şekline göre görüntüleme istatistiklerini toplar. Örneğin, Google Arama'dan veya ilgili bir videonun bağlantısından kaynaklanan görüntüleme sayısını belirler.

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ğine ait verileri alan bir sorgu, en fazla 100 günlük verileri 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 kullanın engagedViews, views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
0 veya 1 kullanın country, province, continent, subContinent
0 veya daha fazla kullanın liveOrOnDemand, subscribedStatus

Trafik kaynağı ayrıntıları (<= 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 rapor için sort istek parametresinin değerini de belirtmeniz gerekir.

Bu rapor, içerik sahibinin içeriği için en çok görüntüleme oluşturan yönlendirenlere göre görüntüleme istatistiklerini toplar. Yönlendirenler trafik kaynağı türüne göre kategorilere ayrılır 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 kullanın engagedViews, views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un 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: -engagedViews
-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çeriğinizi izlerken kullandığı cihaz türüne göre görüntüleme istatistiklerini toplar. Örneğin, tabletlerde veya oyun konsollarında gerçekleşen görüntüleme sayısını belirler.

İçindekiler
Boyutlar:
Zorunlu deviceType
0 veya daha fazla kullanın creatorContentType, day, liveOrOnDemand, subscribedStatus, youtubeProduct
Metrikler:
1 veya daha fazla kullanın engagedViews, views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un 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, izleyicilerin işletim sistemlerine göre görüntüleme istatistiklerini 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 kullanın engagedViews, views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un 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, izleyicilerin işletim sistemlerine ve cihaz türlerine göre görüntüleme istatistiklerini 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 kullanın engagedViews, views, estimatedMinutesWatched
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un 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, izleyicilerin yaş grubuna ve cinsiyetine göre görüntüleme istatistiklerini toplar.

İçindekiler
Boyutlar:
1 veya daha fazla kullanın ageGroup, gender
0 veya daha fazla kullanın creatorContentType, liveOrOnDemand, subscribedStatus
Metrikler:
1 veya daha fazla kullanın viewerPercentage
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un 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ısı boyutunun farklı değerleri için normalleştirilmemiştir.

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

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

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

Bu rapor, kanalın videolarının farklı sosyal platformlarda ne sıklıkta paylaşıldığını gösteren istatistikler sunar.

İçindekiler
Boyutlar:
Zorunlu sharingService
İsteğe bağlı creatorContentType, subscribedStatus
Metrikler:
1 veya daha fazla kullanın hisseler
Filtreler:
Tam olarak 1 kullanın video, kanal, grup veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent
İsteğe bağlı subscribedStatus

Kitleyi elde tutma

Bu rapor, bir videonun kitlesini elde tutma performansını ölçer. elapsedVideoTimeRatio boyutu, ilgili metrik değerleri için videonun ne kadarının izlendiğini ölçer. audienceWatchRatio ve relativeRetentionPerformance metrikleri, videonun kitleyi elde tutma performansını gösteren iki ölçüm sunar. İlk metrik 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ülle ayrılmış 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 kullanın 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 ilk 10 video için kullanılabilir. Diğer raporların çoğundan farklı olarak, bu raporlarda sort istek parametresi için de bir değer belirtmeniz gerekir.

Genel olarak, ülkeye, kıtaya veya alt kıtaya göre en iyi 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 kullanın adImpressions
Filtreler:
Tam olarak 1 kullanın channel veya desteklenen bir uploaderType ve claimedStatus kombinasyonu
0 veya 1 kullanın country, continent, subContinent
Sıralama seçenekleri: -engagedViews
-views
-redViews
-estimatedRevenue
-estimatedRedPartnerRevenue
-estimatedMinutesWatched
-estimatedRedMinutesWatched
-subscribersGained
-subscribersLost

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

Bu raporda, içerik sahibinin belirli bir ABD eyaletindeki veya District of Columbia'daki en popüler 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 kullanın engagedViews, views, redViews, estimatedMinutesWatched, estimatedRedMinutesWatched, averageViewDuration, averageViewPercentage, annotationClickThroughRate, annotationCloseRate, annotationImpressions, annotationClickableImpressions, annotationClosableImpressions, annotationClicks, annotationCloses, cardClickRate, cardTeaserClickRate, cardImpressions, cardTeaserImpressions, cardClicks, cardTeaserClicks
Filtreler:
Tam olarak 1 kullanın channel veya desteklenen bir uploaderType ve claimedStatus kombinasyonu
Zorunlu province
Sıralama seçenekleri: -engagedViews
-views
-redViews
-estimatedMinutesWatched
-estimatedRedMinutesWatched

Abone olan veya olmayan izleyiciler için en popüler videolar(<= 200 sonuç)

Bu raporda, abone olan veya olmayan izleyiciler için en popüler videolar listelenir. Rapor, en iyi videoları ülkeye, kıtaya veya subContinent göre listeleyecek şekilde filtrelenebilir. Önceki rapor, ABD'nin belirli bir eyaletindeki en popüler videoları abone olan veya olmayan izleyiciler için 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 kullanın engagedViews, 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 kullanın channel veya desteklenen bir uploaderType ve claimedStatus kombinasyonu
İsteğe bağlı subscribedStatus
0 veya 1 kullanın country, continent, subContinent
Sıralama seçenekleri: -engagedViews
-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ısı ile coğrafi filtreler desteklenir. Bu rapor, önceki rapora benzer ancak daha az metriği destekler ve youtubeProduct filtresi için destek ekler.

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

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

Bu raporda, içerik sahibinin en iyi videoları listelenir. Bu videolar, bir veya daha fazla oynatma ayrıntısı boyutu (liveOrOnDemand, subscribedStatus ve youtubeProduct) kullanılarak filtrelenir. Rapor, bölgeye göre filtrelemeyi de destekler.

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

Oynatma listesi raporları

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

Toplu video metrikleri

Bu metrikler, oynatma listesindeki ve oynatma listesinin sahibi olan kanala ait tüm videolar için toplanan 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ı içeren bir oynatma listesi oluşturursa bu oynatma listeleriyle ilgili raporlarda bu metriklerin değerleri sağlanmaz.

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

Oynatma listesi içi metrikler

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ılarını (hangi kanala ait olduklarına bakılmaksızın) içerir ancak yalnızca oynatma listesi bağlamında gerçekleşen görüntülemeleri sayar.

Desteklenen oynatma listesi metrikleri

İçindekiler
Toplu video metrikleri engagedViews, views, estimatedMinutesWatched, averageViewDuration
Oynatma listesi içi metrikler playlistViews, playlistEstimatedMinutesWatched, playlistAverageViewDuration, playlistSaves, playlistStarts, viewsPerPlaylistStart, averageTimeInPlaylist

Temel istatistikler

Bu rapor, kullanıcıların içerik sahibinin kanallarındaki oynatma listelerinde yer alan videolarla etkileşimlerine ilişkin istatistikler sağlar. Rapor, gerekli boyutları içermiyor.

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

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

Zamana dayalı

Bu rapor, belirli zaman aralıklarında içerik sahibinin kanallarındaki oynatma listelerinde yer alan videolarla kullanıcıların etkileşimlerine ilişkin istatistikler sağlar. Raporu yalnızca belirli bir oynatma listesi veya kanala ait verileri döndürecek şekilde filtreleyebilirsiniz.

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

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

Kullanıcının bulunduğu coğrafya

Bu rapor, belirli bir ülkedeki kullanıcıların kanalın oynatma listelerindeki videolarla etkileşimlerine ilişkin istatistikler sağlar.

Bu rapor, ülkeye göre oynatma listesi istatistiklerini gösterir.

İçindekiler
Boyutlar:
Zorunlu country
Metrikler:
1 veya daha fazla kullanın engagedViews, views, estimatedMinutesWatched, averageViewDuration
Filtreler:
0 veya 1 kullanın* playlist, group

Not: views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri raporda isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
0 veya 1 kullanın continent, subContinent
İsteğe bağlı channel

Eyalete göre oynatma listesi etkinliği

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

İçindekiler
Boyutlar:
Zorunlu province
Metrikler:
1 veya daha fazla kullanın engagedViews, views, estimatedMinutesWatched, averageViewDuration
Filtreler:
Zorunlu country==US
0 veya 1 kullanın* playlist, group

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

Oynatma konumları

Bu rapor, oynatma listesi oynatmalarının gerçekleştiği sayfa veya uygulama türüyle ilgili istatistikler sağlar.

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

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

Oynatma konumu ayrıntıları (<= 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 rapor için sort istek parametresinin değerini de belirtmeniz gerekir.

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

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

Not: views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri raporda 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 görüntüleme istatistiklerini toplar. Örneğin, Google Arama'dan veya bir kanal sayfasından kaynaklanan görüntüleme sayısını belirler.

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

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

Trafik kaynağı ayrıntıları (<= 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 rapor için sort istek parametresinin değerini de belirtmeniz gerekir.

Bu rapor, içerik sahibinin oynatma listeleri için en çok görüntüleme sağlayan yönlendiren kaynaklara göre görüntüleme istatistiklerini toplar. Yönlendirenler trafik kaynağı türüne göre kategorilere ayrılır 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.

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

Not: views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri raporda 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, izleyicilerin oynatma listesi içeriğinizi izlemek için kullandığı cihaz türüne göre görüntüleme istatistiklerini toplar. Örneğin, mobil cihazlarda veya oyun konsollarında gerçekleşen görüntüleme sayısını tanımlar.

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

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

Oynatma listeleri için işletim sistemi

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

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

Not: views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri raporda 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, izleyicilerin işletim sistemlerine ve cihaz türlerine göre görüntüleme istatistiklerini toplar. Örneğin, Android tabletlerde veya Windows masaüstü cihazlarda gerçekleşen oynatma listesi görüntüleme sayısını belirler.

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

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

İzleyici demografisi

Bu rapor, izleyicilerin yaş grubuna ve cinsiyetine göre görüntüleme istatistiklerini toplar.

İçindekiler
Boyutlar:
1 veya daha fazla kullanın ageGroup, gender
Metrikler:
Zorunlu viewerPercentage
Filtreler:
0 veya 1 kullanın* playlist, group

Not: views, estimatedMinutesWatched veya averageViewDuration metriklerinden herhangi biri raporda isteniyorsa bu filtrelerden tam olarak biri belirtilmelidir.
İsteğe bağlı channel
Not: Bu rapordaki viewerPercentage değerleri, oynatma ayrıntıları boyutlarının (subscribedStatus ve youtubeProduct) farklı değerleri veya değer kombinasyonları için normalleştirilmemiştir.

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

Raporun yalnızca oynatma ayrıntısı boyutları için bir değere (veya değer kombinasyonuna) ait viewerPercentage verilerini içermesini sağlamak için filtreleri 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 de bir değer belirtmeniz gerekir.

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

İçindekiler
Boyutlar:
Zorunlu oynatma listesi
Metrikler:
1 veya daha fazla kullanın averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart
Sıralama seçenekleri: -playlistViews
-playlistEstimatedMinutesWatched
-playlistStarts

Reklam performans raporları

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

Reklam performansı raporları, video oynatma 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 kullanın grossRevenue, adImpressions, cpm
Filtreler:
Tam olarak 1 kullanın video, group veya uploaderType ve claimedStatus'un desteklenen bir kombinasyonu
0 veya 1 kullanın country, continent, subContinent