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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
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: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
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: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
İ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: |
|
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: |
|
Ş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.
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: |
|
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: |
|
İ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: |
|
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: |
|
İ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: |
|
Metrikler: |
|
Filtreler: |
|
İ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: |
|
Metrikler: |
|
Filtreler: |
|
Ü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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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.
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: |
|
Metrikler: |
|
Filtreler: |
|
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.
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: |
|
Metrikler: |
|
Filtreler: |
|
İş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: |
|
Metrikler: |
|
Filtreler: |
|
İş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: |
|
Metrikler: |
|
Filtreler: |
|
İzleyici demografisi
Bu rapor, izleyicilerin yaş grubuna ve cinsiyetine göre görüntüleme istatistiklerini toplar.
İçindekiler |
Boyutlar: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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.
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: |
|
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: |
|
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: |
|
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: |
|
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.
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.
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
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: |
|
Metrikler: |
1 veya daha fazla kullanın |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
Filtreler: |
|
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: |
|
Metrikler: |
1 veya daha fazla kullanın |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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.
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: |
|
Metrikler: |
1 veya daha fazla kullanın |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
Filtreler: |
|
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: |
|
Metrikler: |
1 veya daha fazla kullanın |
engagedViews, views, estimatedMinutesWatched, averageViewDuration, averageTimeInPlaylist, playlistAverageViewDuration, playlistEstimatedMinutesWatched, playlistSaves, playlistStarts, playlistViews, viewsPerPlaylistStart |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
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: |
|
Metrikler: |
|
Filtreler: |
|
İzleyici demografisi
Bu rapor, izleyicilerin yaş grubuna ve cinsiyetine göre görüntüleme istatistiklerini toplar.
İçindekiler |
Boyutlar: |
|
Metrikler: |
|
Filtreler: |
|
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.
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.
İçindekiler |
Boyutlar: |
|
Metrikler: |
|
Filtreler: |
|