Bu belgede, YouTube Analytics API'nin desteklediği boyutlar tanımlanmaktadır. Bu API, özel YouTube Analytics raporları oluşturmak için gerçek zamanlı, hedeflenen sorguları destekler.
Boyutlar, kullanıcı etkinliğinin gerçekleştiği tarih veya kullanıcıların bulunduğu ülke gibi verileri birleştirmek için yaygın olarak kullanılan ölçütlerdir.
Her sorgu raporu, desteklediği boyutları tanımlar. Örneğin, zamana göre kullanıcı etkinliğini alırken verilerin raporlanacağı dönemi seçersiniz: gün veya ay. Raporlarda, her veri satırında benzersiz bir boyut değerleri kombinasyonu bulunur.
Sorgu raporu almak için YouTube Analytics API'nin reports.query
yöntemini çağırın. İsteğinizde, YouTube'un raporlardaki metrik değerlerini hesaplamak için kullanacağı boyutları belirtmek üzere dimensions
parametresini kullanın.
Temel boyutlar
YouTube Analytics API, Hizmet Şartları'nda tanımlanan Kullanımdan Kaldırma Politikası'na tabi olsa da temel olmayan boyutlar (ve temel olmayan metrikler) bu politikaya tabi değildir. Bu sayfadaki tanımlarda, temel boyut olan her boyut açıkça bu boyut olarak belirtilmiştir.
Aşağıdaki listede API'nin temel boyutları tanımlanmaktadır.
Daha fazla bilgi için Kullanımdan Kaldırma Politikası'na tabi YouTube API'lerinin listesine bakın.
Filtreler
Tüm sorgu raporları filtreleri destekler. Filtreler, alınan veri kümesinde mevcut olması gereken boyut değerlerini tanımlar. Dolayısıyla API yanıtlarını yalnızca belirli bir değer veya değer grubuyla eşleşen verileri içerecek şekilde sınırlarlar. Örneğin, tüm ülkelere ilişkin kullanıcı etkinliği metriklerini almak yerine, yalnızca belirli bir ülkeye ait verileri almak için bir filtre kullanabilirsiniz.
Sorgu raporu alma isteğinde, isteğe bağlı filters
istek parametresi, verilerini filtrelemek istediğiniz boyut değerlerini belirtir. Örneğin, Avrupa ile ilgili kullanıcı etkinliği metriklerini almak için filters
parametre değerini continent==150
olarak ayarlarsınız.
Önemli: İçerik sahibi raporlarını almak için yapılan API isteklerinin, raporlama öğesi boyutlarından birini veya claimedStatus
ile uploaderType
boyutlarının desteklenen bir kombinasyonunu kullanarak verileri filtrelemesi gerekir.
Boyutlar
Aşağıdaki bölümler, YouTube Analytics API'nin sorgu raporlarında kullanılan boyutları tanımlar. Aksi belirtilmedikçe bu boyutlar hem kanal hem de içerik sahibi raporlarında kullanılır. Yalnızca filtre olarak kullanılabilen boyutlar da tanımlanmıştır.
Kaynaklar
Bu boyutlar, kanalların ve içerik sahiplerinin YouTube'da yönettiği kaynaklara karşılık gelir:
Not: API, filtre olarak kullanıldıklarında video
, playlist
ve channel
boyutları için birden fazla değer belirtmenize olanak tanır. Bunu yapmak için filters
parametre değerini API yanıtının filtrelenmesi gereken video, oynatma listesi veya kanal kimliklerinin virgülle ayrılmış listesine ayarlayın. Parametre değeri en fazla 500 kimlik belirtebilir.
- video (temel boyut)
- YouTube videosunun kimliği. YouTube Data API'de bu değer,
video
kaynağınınid
özelliğinin değeridir. This is a core dimension and is subject to the Deprecation Policy. - oynatma listesi
- YouTube oynatma listesinin kimliği. YouTube Data API'de bu değer,
playlist
kaynağınınid
özelliğinin değeridir. - kanal (temel boyut) (yalnızca içerik sahibi raporlarında kullanılır)
- YouTube kanalının kimliğidir. YouTube Data API'de bu değer,
channel
kaynağınınid
özelliğinin değeridir. This is a core dimension and is subject to the Deprecation Policy.channel
boyutu, içerik sahibi raporlarında sık sık kullanılır. Bunun nedeni, bu raporların genellikle birden fazla kanalın verilerini toplamasıdır. - group (yalnızca filtre)
- Bir YouTube Analytics grubunun kimliği. Bu değeri YouTube Analytics API'nin
groups.list
yöntemini kullanarak alabilirsiniz.group
filtresini kullandığınızda API yanıtı, söz konusu gruptaki tüm videolar, oynatma listeleri veya kanallara ait verileri içerir.
Örnekler
Aşağıdaki örnek istekler raporlama öğesi boyutlarını veya filtrelerini kullanır:
Kanal örnekleri
-
Temel istatistikler
- İlk 10 - Kanalda en çok izlenen videolar
- İlk 10 – Kanalın en çok görüntülenen videoları için ek açıklama tıklama oranları
- Belirli bir oynatma listesiyle ilgili istatistikler
- En Çok İzlenen 10 - Bir kanal için en çok izlenen oynatma listeleri
-
Coğrafi
- İlk 10 - Belirli bir ülkede en çok görüntülenen video
- En Popüler 10 - Avrupa'da en çok görüntülenen video
-
Temel istatistikler
İçerik sahibi örnekleri
-
Temel istatistikler
- En Çok İzlenen 10 Video - İçerik sahiplerinin en çok izlenen videoları
- En Popüler 10 - İçerik sahiplerinin en çok izlenen videoları
- İlk 10 - İçerik sahibinin kanalında en çok görüntülenen videolar
- İlk 10 – Kanalın en çok görüntülenen videoları için ek açıklama tıklama oranları
- En Popüler 10 - İçerik sahipleri için en çok izlenen oynatma listeleri
-
Coğrafi
- En Popüler 10 - İçerik sahiplerinin Avrupa'da en çok izlenen videoları
- En Popüler 10 - ABD'de en çok başlatılan oynatma listeleri
-
Temel istatistikler
Coğrafi bölgeler
Bu boyutlar; kullanıcı etkinliği, reklam performansı veya tahmini gelir metrikleriyle ilişkili coğrafi bölgeyi tanımlar.
- ülke (temel boyut)
- Rapor satırındaki metriklerle ilişkili ülkedir. Boyut değeri,
US
,CN
(Çin) veyaFR
(Fransa) gibi iki harfli bir ISO-3166-1 ülke kodudur.ZZ
ülke kodu, YouTube'un ilgili ülkeyi belirleyemediği metrikleri bildirmek için kullanılır. This is a core dimension and is subject to the Deprecation Policy. - province
- Rapor satırındaki metriklerle ilişkilendirilen ABD eyaleti veya bölgesi. Boyut değeri,
US-MI
(Michigan) veyaUS-TX
(Teksas) gibi bir ABD eyaletini veya District of Columbia'yı tanımlayan bir ISO 3166-2 kodudur.US-ZZ
il kodu, YouTube'un ilişkili ABD eyaletini belirleyemediği metrikleri bildirmek için kullanılır. Bir API isteğidimensions
parametre değerindeprovince
içeriyorsa isteğin,filters
parametre değerinecountry==US
eklenerek verileri ABD ile sınırlı olması da gerekir.Not: ABD'den uzak bölgeleri tanımlayan ISO 3166-2 değerlerini desteklemez. Bunun nedeni, bu bölgelerin kendi ISO 3166-1 ülke kodlarına da sahip olmasıdır. Ayrıca ABD dışındaki ülkelerin alt bölümlerini de desteklemez.
- city
- Rapor satırındaki metriklerle ilişkilendirilen tahmini şehir. Bu boyutla ilgili veriler 1 Ocak 2022'den başlayan tarihler için kullanılabilir.
- kıta (yalnızca filtre)
-
Birleşmiş Milletler (BM) istatistiksel bölge kodu. API şu değerleri destekler:
Değerler 002
Afrika 019
Amerika kıtası (Kuzey Amerika, Latin Amerika, Güney Amerika ve Karayipler) 142
Asya 150
Avrupa 009
Okyanusya REGION_CODE
değeri belirterekfilters
parametresinin değerinicontinent==REGION_CODE
olarak ayarlayın. - subContinent (yalnızca filtre)
-
Coğrafi bir alt bölgeyi tanımlayan BM istatistiksel bölge kodu. Birleşmiş Milletler İstatistik Bölümü, alt bölgelerin yanı sıra her bir bölgeyle ilişkilendirdiği ülkeleri listeler.
Bu boyut yalnızca verileri filtrelemek için kullanılabilir. Bu boyutu kullanmak için UN listesinden bir
REGION_CODE
değeri belirterekfilters
parametresinin değerinisubContinent==REGION_CODE
olarak ayarlayın.
Örnekler
Aşağıdaki örnek istekler coğrafi boyutları veya filtreleri kullanır:
Kanal örnekleri
- Temel istatistikler: Bir kanalın ülkeye özgü görüntüleme sayıları (ve daha fazlası)
-
Coğrafi
- Kanal videoları için ülkeye özgü izlenme süresi metrikleri
- Kanal videoları için ülkeye özgü ek açıklama metrikleri
- ABD eyaletleri ve Washington D.C. için eyaletlere özgü metrikler
- Bir kanalın oynatma listeleri için ülkeye özgü izlenme süresi metrikleri
- En Popüler 10 - ABD'de en çok başlatılan oynatma listeleri
- Oynatma konumu: Farklı oynatma konumlarındaki günlük görüntüleme sayıları ve izlenme süresi
- Trafik kaynağı: Bir ülkedeki farklı trafik kaynaklarından gelen görüntüleme sayısı ve izlenme süresi
- Demografi: Kaliforniya'daki izleyicilerin demografik özellikleri (yaş grubu ve cinsiyet)
-
En iyi videolar
- İlk 10 - Belirli bir ülkede en çok görüntülenen video
- En Popüler 10 - Avrupa'da en çok görüntülenen video
İçerik sahibi örnekleri
- Temel istatistikler: Kendi kendine yüklenen tüm videolar için ülkeye özgü görüntüleme sayıları (ve daha fazlası)
-
Coğrafi
- Kendi yüklediği içerikler için ülkeye özgü izlenme süresi metrikleri
- Kendi kendine yüklenen içerikler için ülkeye özgü ek açıklama metrikleri
- ABD eyaletleri ve Washington D.C. için eyaletlere özgü metrikler
- İçerik sahibinin oynatma listeleri için ülkeye özel izlenme süresi metrikleri
- En Popüler 10 - ABD'de en çok başlatılan oynatma listeleri
- Oynatma konumu: Farklı oynatma konumlarındaki günlük görüntüleme sayıları ve izlenme süresi
- Demografi: Kaliforniya'daki izleyicilerin demografik özellikleri (yaş grubu ve cinsiyet)
- En popüler videolar: En popüler 10 - İçerik sahipleri için Avrupa'da en çok izlenen videolar
- Gelir/Reklam performansı: Ülkeye özgü gelir ve reklam performansı metrikleri
Dönemler
Bu boyutlar, bir raporun verileri gün, hafta veya ay gibi bir döneme göre toplaması gerektiğini gösterir. startDate
ve endDate
istek parametreleri, raporun hangi döneme ait olduğunu belirtir. Raporun gerçekte, sorgu yapıldığında istekte belirtilen tüm metriklerin kullanılabilir olduğu son güne kadar olan verileri döndürdüğünü unutmayın. Raporlarda, tarihler YYYY-MM-DD
biçiminde listelenir.
Önemli: Tüm tarihler, Pasifik saatiyle 00:00'da (UTC-7 veya UTC-8) başlayan ve belirtilen gün, ay ve yılda Pasifik saatiyle 23:59'da sona eren dönemi ifade eder. Sonuç olarak, Yaz Saati Uygulaması için saatlerin ileriye doğru ayarlandığı tarihler 23 saatlik, saatlerin geriye doğru ayarlandığı tarihler ise 25 saatlik bir dönemi temsil eder.
ay boyutu, belirtilen ayın ve yılın ilk gününde Pasifik saatiyle 00:00'dan (UTC-7 veya UTC-8) başlayan dönemi ifade eder.
- day (temel boyut)
- Bu boyutu kullandığınızda rapordaki veriler günlük olarak toplanır ve her satırda bir güne ait veriler yer alır. Verilerin daha da dökümünü almak için başka boyutlar kullanabilirsiniz. Örneğin, bir trafik kaynağı raporu, kullanıcıların videolarınıza ulaşma yöntemlerini temel alarak günlük görüntüleme istatistiklerini bir araya getirebilir. This is a core dimension and is subject to the Deprecation Policy.
- ay (temel boyut)
- Rapordaki veriler takvim ayına göre toplanır. Günlük raporlarda olduğu gibi, verileri daha da fazla segmentlere ayırmak için diğer filtreleri kullanabilirsiniz. Raporda tarihler
YYYY-MM
biçiminde listelenir.
Not: API sorgunuzmonth
boyutunu kullanıyorsastart-date
veend-date
parametrelerinin her ikisi de ayın ilk gününe ayarlanmalıdır. This is a core dimension and is subject to the Deprecation Policy.
Örnekler
Aşağıdaki örnek istekler geçici boyutlar veya filtreler kullanıyor:
Kanal örnekleri
-
Zamana dayalı
- Bir kanalın videoları için günlük izlenme süresi metrikleri
- Bir kanalın videoları için günlük ek açıklama metrikleri
- Bir kanalın günlük oynatma listesi görüntüleme sayısı
- Oynatma konumu: Farklı oynatma konumlarındaki günlük görüntüleme sayıları ve izlenme süresi
- Trafik kaynağı: Farklı trafik kaynaklarından gelen günlük görüntüleme sayısı ve izlenme süresi
-
Cihaz/İşletim Sistemi
- Android işletim sistemi için günlük cihaz türü metrikleri
- Mobil cihazlar için günlük işletim sistemi metrikleri
- Günlük işletim sistemi ve cihaz türü metrikleri
-
Zamana dayalı
İçerik sahibi örnekleri
-
Zamana dayalı
- Kendi yüklediğiniz içerikler için günlük izlenme süresi metrikleri
- Hak talebinde bulunulan içerikler için ek açıklama metrikleri
- İçerik sahibinin günlük oynatma listesi görüntüleme sayısı
- Oynatma konumu: Farklı oynatma konumlarındaki günlük görüntüleme sayıları ve izlenme süresi
- Trafik kaynağı: Farklı trafik kaynaklarından gelen günlük görüntüleme sayısı ve izlenme süresi
-
Cihaz/İşletim Sistemi
- Hak talebinde bulunulan videolar için günlük cihaz türü metrikleri
- Mobil cihazlarda görüntülenen hak talebinde bulunulan videolarla ilgili günlük işletim sistemi metrikleri
- Günlük işletim sistemi ve cihaz türü metrikleri
- Gelir/Reklam performansı: Günlük gelir ve reklam performansı metrikleri
-
Zamana dayalı
Oynatma konumları
Bu boyutlar, kullanıcı etkinliğinin gerçekleştiği sayfa veya uygulama hakkında bilgi sağlar.
- insightPlaybackLocationType
-
Rapordaki veriler, video oynatıldığı sayfanın veya uygulamanın türüne göre toplanır. Bu boyut için olası değerler şunlardır:
-
BROWSE
– Veriler, YouTube ana sayfasında veya ana ekranında, kullanıcının abonelik feed'inde ya da başka bir YouTube'a göz atma özelliğinde gerçekleşen görüntülemeleri tanımlar. -
CHANNEL
– Veriler, bir kanal sayfasında gerçekleşen görüntülemeleri tanımlar. -
EMBEDDED
– Veriler, videonun<iframe>
veya<object>
yerleştirmesi kullanılarak yerleştirildiği başka bir web sitesinde ya da uygulamada gerçekleşen görüntülemeleri belirtir. -
EXTERNAL_APP
– Veriler, videonun<iframe>
veya<object>
yerleştirmesi dışında bir yöntem kullanılarak oynatıldığı üçüncü taraf uygulamasında gerçekleşen görüntülemeleri tanımlar. Örneğin, YouTube Android Oynatıcı API'sını kullanan uygulamalardaki oynatmalar bu değer kullanılarak sınıflandırılır. -
MOBILE
– Veriler, mobil cihazlar da dahil olmak üzere YouTube'un mobil web sitesinde veya onaylı YouTube API istemcilerinde gerçekleşen görüntülemeleri tanımlar.Oynatmalar, 10 Eylül 2013 itibarıyla YouTube Analytics raporlarında
MOBILE
oynatma olarak kategorize edilmemektedir. Eski veriler hâlâ bu kategoriye girdiğinden değer raporlarda kalabilir. Ancak bu tarihten sonra mobil oynatmalar, oynatmaların gerçekleştiği uygulamanın türüne bağlı olarakWATCH
,EMBEDDED
veyaEXTERNAL_APP
olarak sınıflandırılır. -
SEARCH
– Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemeleri tanımlar. -
WATCH
– Veriler, videonun YouTube izleme sayfasında veya YouTube Android uygulaması gibi resmi bir YouTube uygulamasında gerçekleşen görüntülemeleri tanımlar. -
YT_OTHER
– Veriler, başka şekilde sınıflandırılmamış görüntülemeleri tanımlar.
-
- insightPlaybackLocationDetail
- Veriler, oynatıcının bulunduğu sayfaya göre toplanır. Bu raporun yalnızca yerleştirilmiş oynatıcılarda gerçekleşen görüntülemeler için desteklendiğini ve belirtilen bir video için en çok görüntülemeyi oluşturan yerleşik oynatıcıları tanımladığını unutmayın. Böylece, en çok gömülü oynatıcılarla ilişkili URL'leri veya uygulamaları tanımlayarak oynatma konumu raporuna göre daha ayrıntılı bir görünüm sağlar.
Örnekler
Aşağıdaki örnek istekler oynatma konumu boyutlarını kullanır:
Kanal örnekleri
-
Oynatma konumu
- Farklı oynatma konumlarından gelen görüntüleme sayısı ve izlenme süresi
- Farklı oynatma konumlarındaki günlük görüntüleme sayıları ve izlenme süresi
- İlk 10 – Yerleştirilmiş videolar için en çok görüntüleme sağlayan üçüncü taraf siteleri
- Oynatma listesi görüntüleme sayısı ve farklı oynatma konumlarından izlenme süresi
- Farklı oynatma konumlarındaki günlük oynatma listesi görüntüleme sayıları ve izlenme süresi
-
Oynatma konumu
İçerik sahibi örnekleri
-
Oynatma konumu
- Farklı oynatma konumlarından gelen görüntüleme sayısı ve izlenme süresi
- Farklı oynatma konumlarındaki günlük görüntüleme sayıları ve izlenme süresi
- İlk 10 – Yerleştirilmiş videolar için en çok görüntüleme sağlayan üçüncü taraf siteleri
- Oynatma listesi görüntüleme sayısı ve farklı oynatma konumlarından izlenme süresi
- Farklı oynatma konumlarındaki günlük oynatma listesi görüntüleme sayıları ve izlenme süresi
-
Oynatma konumu
Oynatma ayrıntıları
- creatorContentType
- Bu boyut, veri satırındaki kullanıcı etkinliği metrikleriyle ilişkili içerik türünü tanımlar. Bu boyutla ilgili veriler 1 Ocak 2019'dan başlayan tarihler için kullanılabilir.
Aşağıdaki tabloda boyut değerleri listelenmiştir:
Değerler LIVE_STREAM
Görüntülenen içerik bir YouTube canlı yayınıdır. SHORTS
Görüntülenen içerik bir YouTube Shorts videosu ise STORY
Görüntülenen içerik bir YouTube Hikayesi'ydi. VIDEO_ON_DEMAND
Görüntülenen içerik, diğer boyut değerlerinden birinin kapsamına girmeyen bir YouTube videosudur. UNSPECIFIED
Görüntülenen içeriğin içerik türü bilinmiyor. - liveOrOnDemand
- Bu boyut, veri satırındaki kullanıcı etkinliği metriklerinin canlı yayın görüntülemeleriyle ilişkili olup olmadığını gösterir. Bu boyutla ilgili veriler 1 Nisan 2014'ten başlayan tarihler için kullanılabilir.
Aşağıdaki tabloda boyut değerleri listelenmiştir:
Değerler LIVE
Satırdaki veriler, canlı yayın sırasında gerçekleşen kullanıcı etkinliğini açıklar. ON_DEMAND
Bu satırdaki veriler, canlı yayın sırasında gerçekleşmemiş kullanıcı etkinliğini açıklar. - subscribedStatus
- Bu boyut, veri satırındaki kullanıcı etkinliği metriklerinin videonun veya oynatma listesinin kanalına abone olan izleyicilerle ilişkilendirilip ilişkilendirilmediğini gösterir.
Olası değerler
SUBSCRIBED
veUNSUBSCRIBED
'dir.
Boyut değerinin, kullanıcı etkinliği gerçekleştiği zaman doğru olduğunu unutmayın. Örneğin, bir kullanıcının bir kanala abone olup olmadığını ve bu kanalın videolarından birini izlediğini, ardından kanala abone olup başka bir videoyu izlediğini, bu işlemlerin hepsini aynı gün içinde yaptığını varsayalım. Kanalın raporu, bir görüntülemeninsubscribedStatus
değerininSUBSCRIBED
ve bir görüntülemeninsubscribedStatus
değerininUNSUBSCRIBED
olduğunu gösteriyor. - youtubeProduct
- Bu boyut, kullanıcı etkinliğinin gerçekleştiği YouTube hizmetini tanımlar. Bu boyutla ilgili veriler 18 Temmuz 2015 tarihinden itibaren kullanılabilir.
Aşağıdaki tabloda boyut değerleri listelenmiştir:
Değerler CORE
Özel YouTube uygulamalarından birinde (YouTube Oyun, YouTube Çocuk veya YouTube Müzik) oluşmamış kullanıcı etkinliği. İstisna: 1 Mart 2021'den önce YouTube Music'te gerçekleşen kullanıcı etkinliği CORE
kapsamına dahildir.GAMING
Kullanıcı etkinliği YouTube Oyun'da gerçekleşti. KIDS
Kullanıcı etkinliği YouTube Kids'de gerçekleşti. MUSIC
YouTube Music'teki kullanıcı etkinliği 1 Mart 2021'de veya sonrasında gerçekleşti. 1 Mart 2021'den önceki veriler CORE
içine dahil edilir. Gerçek zamanlı veriler kaydedilmez.UNKNOWN
Kullanıcı etkinliği 18 Temmuz 2015'ten önce gerçekleşmiş.
Trafik kaynakları
- insightTrafficSourceType
- Rapordaki veriler, kullanıcıların videoya ulaşma şeklini açıklayan yönlendiren türüne göre toplanır. Bu boyut için olası değerler:
ADVERTISING
: İzleyici, videoya bir reklam tarafından yönlendirildi. Bu trafik kaynağına göre filtreleme yaparsanızinsightTrafficSourceDetail
alanı, reklamın türünü tanımlar.ANNOTATION
– İzleyiciler videoya başka bir videodaki ek açıklamayı tıklayarak ulaştı.CAMPAIGN_CARD
– Görüntülemelerin kaynağı, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan, kullanıcı tarafından yüklenen videolardır. Bu trafik kaynağı yalnızca içerik sahibi raporları için desteklenir.END_SCREEN
– Görüntüleme sayısı, başka bir videonun bitiş ekranından yönlendirildi.EXT_URL
– Video görüntüleme sayısı başka bir web sitesindeki bağlantıdan yönlendirildi. Bu trafik kaynağına göre filtreleme yaparsanızinsightTrafficSourceDetail
alanı web sayfasını tanımlar. Bu trafik kaynağı, Google arama sonuçlarından gelen yönlendirmeleri içerir.HASHTAGS
: Seç-izle hashtag sayfaları veya Shorts hashtag özet sayfalarından gelen görüntülemeler.LIVE_REDIRECT
- Video görüntüleme sayısı Live Redirects'ten yönlendirildi.NO_LINK_EMBEDDED
– Video, görüntülendiğinde başka bir web sitesine yerleştirilmiş.NO_LINK_OTHER
– YouTube, trafik için bir yönlendiren belirlemedi. Bu kategori, bir videoya gelen doğrudan trafiğin yanı sıra mobil uygulamalardaki trafiği de kapsar.NOTIFICATION
– Videonun izlenme sayısı, e-postadan veya YouTube'dan gelen bir bildirimden yönlendirilmiştir.PLAYLIST
– Videonun görüntüleme sayısı, video bir oynatma listesinin parçası olarak oynatılırken gerçekleşmiştir. Oynatma listesi sayfasından gelen trafiği içerir.PRODUCT_PAGE
- Video görüntüleme sayısı bir ürün sayfasından yönlendirildi.PROMOTED
– Video görüntüleme sayısı, YouTube "Öne Çıkan Videolar" sayfası gibi ücretsiz bir YouTube tanıtımından yönlendirilmiştir.RELATED_VIDEO
– Video görüntüleme sayısı, başka bir video izleme sayfasındaki ilgili video girişinden yönlendirildi. Bu trafik kaynağına göre filtreleme yaparsanızinsightTrafficSourceDetail
alanı, ilgili videonun video kimliğini belirtir.SHORTS
: İzleyici, Shorts izleme deneyiminde önceki videodan dikey olarak kaydırma yaparak yönlendirildi.SOUND_PAGE
: Shorts'taki ses pivot sayfalarından gelen görüntüleme sayısıdır.SUBSCRIBER
: Video görüntüleme sayısı, YouTube ana sayfasındaki feed'lerden veya YouTube abonelik özelliklerinden kaynaklanmıştır. Bu trafik kaynağına göre filtreleme yaparsanızinsightTrafficSourceDetail
alanında, görüntülemelerin yönlendirildiği ana sayfa feed öğeleri veya başka sayfalar belirtilir.YT_CHANNEL
– Video görüntüleme sayısı, bir kanal sayfasında gerçekleşti. Bu trafik kaynağına göre filtreleme yaparsanızinsightTrafficSourceDetail
alanında o kanalın kanal kimliği belirtilir.YT_OTHER_PAGE
– Video görüntülemeleri, bir YouTube sayfasında gösterilen arama sonucu veya ilgili video bağlantısı dışındaki bir bağlantıdan yönlendirilmiştir. Bu trafik kaynağına göre filtreleme yaparsanızinsightTrafficSourceDetail
alanı sayfayı tanımlar.YT_SEARCH
– Video görüntüleme sayısı YouTube arama sonuçlarından yönlendirilmiştir. Bu trafik kaynağına göre filtreleme yaparsanızinsightTrafficSourceDetail
alanında arama terimi belirtilir.VIDEO_REMIXES
– Video görüntüleme sayısı, Shorts video oynatıcısındaki remikslenmiş videonun bağlantısından yönlendirildi. Bu trafik kaynağına göre filtreleme yaparsanızinsightTrafficSourceDetail
alanında izleyicinin yönlendirildiği video belirtilir.
- insightTrafficSourceDetail
- Rapordaki veriler, belirtilen bir video ve belirtilen trafik kaynağı türü için en çok görüntülemeyi sağlayan yönlendirenlere göre toplanır. Aşağıdaki liste, bu raporun kullanılabildiği trafik kaynaklarını tanımlar. Liste, her bir trafik kaynağı için
insightTrafficSourceDetail
boyutunun sağladığı bilgileri tanımlar.ADVERTISING
: Videonun izlenmesini sağlayan reklamın türüdür. Olası değerler:- Tıkla oynat etkileşim reklamı
- Etkileşim reklamı
- Google Arama Ağı reklamları
- Ana sayfa video reklamı
- Ayrılmış atlanabilir yayın içi
- Arama Sonuçlarında TrueView (TrueView In-search) ve Görüntülü TrueView (TrueView In-display)
- Yayın içi (in-stream) TrueView
- Kategorize edilmemiş YouTube reklamcılığı
- Video duvarı
CAMPAIGN_CARD
: İzleyicileri raporda tanımlanan videoya yönlendiren, hak talebinde bulunulan videodur.END_SCREEN
: İzleyicileri raporda tanımlanan videoya yönlendiren videodur.EXT_URL
: İzleyicileri videoya yönlendiren web sitesidir.HASHTAGS
: Videonun izlenmesini sağlayan hashtag.NOTIFICATION
: Trafik yönlendiren e-posta veya bildirimdir.RELATED_VIDEO
: İzleyicileri raporda yer alan videoya yönlendiren ilgili videodur.SOUND_PAGE
: Videonun izlenmesini sağlayan videodur.SUBSCRIBER
: İzleyicileri raporda yer alan videoya yönlendiren ana sayfa feed öğesi veya YouTube abonelik özelliği. Geçerli değerler şunlardır:activity
: Ana sayfa abonelik feed'lerindeki yüklenmeyen ve sosyal kanalla ilgili olmayan etkinliklerden (beğeniler, favoriler, bülten yayınları ve oynatma listesine eklemeler dahil) kaynaklanan öğelerin aldığı görüntülemelerdir.blogged
: En popüler blogların bağlantılarından gelen, ana sayfa abonelik feed'lerindeki öğelerden gelen görüntülemelerdir.mychannel
: Ana sayfada listelenen "Beğeniler", "İzleme Geçmişi" ve "Daha Sonra İzle" gibi diğer feed'lerdeki öğelerden gelen görüntülemelerdir.podcasts
: Podcast'ler hedef sayfasındaki öğelerden gelen görüntülemeler.sdig
: Abonelik güncelleme e-postalarından gelen görüntülemeler.uploaded
– Ana sayfa abonelik feed'lerindekiuploaded
öğesinden gelen görüntülemeler./
– YouTube ana sayfasından gelen diğer görüntülemeler./my_subscriptions
– YouTube'da kullanıcıların Aboneliklerim sayfalarından kaynaklanan görüntülemeler.
YT_CHANNEL
: İzleyicilerin videoyu izlediği kanal sayfasıdır.YT_OTHER_PAGE
– İzleyicilerin videoya yönlendirildiği YouTube sayfası.YT_SEARCH
: İzleyicileri videoya yönlendiren arama terimidir.VIDEO_REMIXES
: Videonun izlenmesini sağlayan videodur.
Örnekler
Aşağıdaki örnek istekler trafik kaynağı boyutlarını kullanır:
Kanal örnekleri
-
Trafik kaynağı
- Bir ülkedeki farklı trafik kaynaklarından gelen görüntüleme sayısı ve izlenme süresi
- Farklı trafik kaynaklarından gelen günlük görüntüleme sayısı ve izlenme süresi
- İlk 10: Bir video için en fazla trafiği oluşturan YouTube arama terimleri
- İlk 10: Bir video için en fazla trafiği oluşturan Google arama terimleri
- Bir ülkedeki farklı trafik kaynaklarından gelen oynatma listesi görüntüleme sayısı ve izlenme süresi
- Farklı trafik kaynaklarından günlük oynatma listesi görüntüleme sayısı ve izlenme süresi
-
Trafik kaynağı
İçerik sahibi örnekleri
-
Trafik kaynağı
- Farklı trafik kaynaklarından gelen görüntüleme sayısı ve izlenme süresi
- Farklı trafik kaynaklarından gelen günlük görüntüleme sayısı ve izlenme süresi
- İlk 10: Bir video için en fazla trafiği oluşturan YouTube arama terimleri
- İlk 10: Bir video için en fazla trafiği oluşturan Google arama terimleri
- Bir ülkedeki farklı trafik kaynaklarından gelen oynatma listesi görüntüleme sayısı ve izlenme süresi
- Farklı trafik kaynaklarından günlük oynatma listesi görüntüleme sayısı ve izlenme süresi
-
Trafik kaynağı
Cihazlar
- deviceType
- Bu boyut, görüntülemenin gerçekleştiği cihazın fiziksel form faktörünü tanımlar.
Aşağıdaki liste, API'nin veri döndürdüğü cihaz türlerini tanımlar. Bir işletim sistemi raporunu yalnızca belirli bir cihaz türüne ilişkin verileri içerecek şekilde kısıtlamak için
deviceType
boyutunu da filtre olarak kullanabilirsiniz.DESKTOP
GAME_CONSOLE
MOBILE
TABLET
TV
UNKNOWN_PLATFORM
- operatingSystem
- Bu boyut, görüntülemenin gerçekleştiği cihazın yazılım sistemini tanımlar.
Aşağıdaki liste, API'nin veri döndürdüğü işletim sistemlerini tanımlar. Cihaz türü raporunu yalnızca belirli bir işletim sisteminin verilerini içerecek şekilde kısıtlamak için
operatingSystem
filtresini de kullanabilirsiniz.ANDROID
BADA
BLACKBERRY
CHROMECAST
DOCOMO
FIREFOX
HIPTOP
IOS
KAIOS
LINUX
MACINTOSH
MEEGO
NINTENDO_3DS
OTHER
PLAYSTATION
PLAYSTATION_VITA
REALMEDIA
SMART_TV
SYMBIAN
TIZEN
VIDAA
WEBOS
WII
WINDOWS
WINDOWS_MOBILE
XBOX
Örnekler
Aşağıdaki örnek istekler cihaz boyutlarını kullanır:
Kanal örnekleri
-
Cihaz/İşletim Sistemi
- Android işletim sistemi için günlük cihaz türü metrikleri
- Mobil cihazlar için günlük işletim sistemi metrikleri
- Günlük işletim sistemi ve cihaz türü metrikleri
- Android işletim sisteminde oynatma listesi görüntülemeleri için günlük cihaz türü metrikleri
- Mobil cihazlarda oynatma listesi görüntülemelerine ilişkin günlük işletim sistemi metrikleri
-
Cihaz/İşletim Sistemi
İçerik sahibi örnekleri
-
Cihaz/İşletim Sistemi
- Hak talebinde bulunulan videolar için günlük cihaz türü metrikleri
- Mobil cihazlarda görüntülenen hak talebinde bulunulan videolarla ilgili günlük işletim sistemi metrikleri
- Günlük işletim sistemi ve cihaz türü metrikleri
- Android işletim sisteminde oynatma listesi görüntülemeleri için günlük cihaz türü metrikleri
- Mobil cihazlarda oynatma listesi görüntülemelerine ilişkin günlük işletim sistemi metrikleri
-
Cihaz/İşletim Sistemi
Demografi
Demografik boyutlar, kitlenizin yaş aralığını ve cinsiyet dağılımını anlamanıza yardımcı olur. YouTube Yardım Merkezi'nde YouTube Analytics raporlarındaki demografik veriler hakkında daha fazla bilgi bulabilirsiniz.
- ageGroup (temel boyut)
- Bu boyut, rapor verileriyle ilişkilendirilmiş olan, giriş yapmış kullanıcıların yaş grubunu tanımlar. API aşağıdaki yaş gruplarını kullanır:
- age13-17
- age18-24
- age25-34
- age35-44
- age45-54
- age55-64
- age65-
- gender (temel boyut)
- Bu boyut, rapor verileriyle ilişkilendirilmiş olan giriş yapmış kullanıcıların cinsiyetini tanımlar.
Geçerli değerler
female
,male
veuser_specified
'dir. This is a core dimension and is subject to the Deprecation Policy.
Örnekler
Aşağıdaki örnek istekler demografik boyutları kullanır:
Kanal örnekleri
-
Demografi
- Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet)
- Kaliforniya'da oynatma listesi görüntüleyenlerinin demografisi (yaş grubu ve cinsiyet)
-
Demografi
İçerik sahibi örnekleri
-
Demografi
- Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet)
- Kaliforniya'da oynatma listesi görüntüleyenlerinin demografisi (yaş grubu ve cinsiyet)
-
Demografi
Etkileşim ve içerik paylaşımı
- sharingService (temel boyut)
- Bu boyut, video paylaşmak için kullanılan hizmeti tanımlar. Videolar, "Paylaş" düğmesi kullanılarak YouTube'da (veya YouTube oynatıcısı aracılığıyla) paylaşılabilir. This is a core dimension and is subject to the Deprecation Policy.
Geçerli boyut değerleri aşağıdaki tabloda listelenmiştir:
Paylaşım hizmeti API değeri Ameba Dili AMEBA
Android E-posta ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android mesajlaşma ANDROID_MMS
Blackberry Messenger BBM
Blogger BLOGGER
Panoya Kopyala COPY_PASTE
Cyworld CYWORLD
Kazıklı DIGG
Dropbox DROPBOX
Yerleştirme EMBED
E-posta MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook Sayfaları FACEBOOK_PAGES
Fotka Dili FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
SMS'e git GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC kısa mesajı HTC_MMS
Google Gelen Kutusu INBOX
iOS Sistem Etkinliği İletişim Kutusu IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Hikayesi KAKAO_STORY
Kakao (Kakao Konuşması) KAKAO
Kik KIK
LGE E-posta Adresi LGE_EMAIL
Çizgi LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Yakındakilerle Paylaş NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (DCM) ODNOKLASSNIKI
Diğer OTHER
Pinterest PINTEREST
Rakuten (楽天cılar場) RAKUTEN
reddit REDDIT
Skype SKYPE
Kayaç SKYBLOG
Sony Görüşmeleri SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
Kısa mesaj TEXT_MESSAGE
Tuenti dili TUENTI
tumblr. TUMBLR
Twitter TWITTER
Bilinmiyor UNKNOWN
Verizon mesajları VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop dili WYKOP
Yahoo! Japonya YAHOO
YouTube Gaming YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV
Daha fazla bilgi için yardım dokümanlarını inceleyin.
Örnekler
Aşağıdaki örnek istekler sosyal boyutları kullanır:
Kanal örnekleri
- Sosyal: Videoların paylaşıldığı hizmete göre toplanan paylaşım metrikleri
İçerik sahibi örnekleri
- Sosyal: Videoların paylaşıldığı hizmete göre toplanan paylaşım metrikleri
Kitleyi elde tutma
- elapsedVideoTimeRatio
- Bu boyut, videonun geçen kısmının videonun uzunluğuna oranını belirtir. Elde tutma boyutları ve metrikleri, zaman içinde kitleyi elde tutma oranını ölçmek için kullanılır.
elapsedVideoTimeRatio
boyutu ise zaman ölçümüdür. Örneğin,0.4
değeri ilgili rapor verilerinin, videonun yüzde 40'ı dolduktan sonra elde tutma verilerini gösterdiğini ifade eder.
API, her video için0.01
ile1.0
arasında oran değerleriyle 100 veri noktası döndürür. Video oynatmaları sırasında verilerin ölçüldüğü zamanlar, her video için eşit aralıklardır. Bu, iki dakikalık bir videoda, veri noktaları arasındaki aralığın 1,2 saniye olduğu anlamına gelir. Ancak, iki saatlik bir videoda, veri noktaları arasındaki aralık 72 saniyedir. Boyutun değeri, aralığın özel sonunu gösterir. - audienceType (yalnızca filtre)
- Boyut değeri, rapor verileriyle ilişkili trafik türünü tanımlar.
ORGANIC
,AD_INSTREAM
veAD_INDISPLAY
değerleri desteklenir. Bu trafik kaynağı türlerinin açıklamaları için YouTube Yardım Merkezi'ne bakın.audienceType
filtresine ilişkin verilerin 25 Eylül 2013 tarihinden itibaren kullanılabileceğini unutmayın. API, önceki tarihlerden veri almaya çalışmak için filtreyi kullanan sorgulara ait verileri döndürmez. Filtreyi kullanmayan sorgular 1 Temmuz 2008'den sonraki herhangi bir tarih için çalışır.
Örnekler
Aşağıdaki örnek istekler kitleyi elde tutma boyutlarını kullanır:
Kanal örnekleri
- Kitleyi elde tutma: Videonun kitleyi elde tutma metrikleri
İçerik sahibi örnekleri
- Kitleyi elde tutma: Videonun kitleyi elde tutma metrikleri
Reklam performansı
- adType
adType
boyutu, reklam performansı raporlarında kullanılır ve istenen metrikleri video oynatmaları sırasında yayınlanan reklam türlerine göre toplar. Aşağıdaki listede olası boyut değerleri açıklanmaktadır. YouTube reklam biçimleri hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne bakın.
-
auctionBumperInstream
– Açık artırma yoluyla yerleştirilen ve 6 saniyeye kadar süren atlanamayan video reklamlardır. Videonun görüntülenebilmesi için izlenmesi gereken süredir. -
auctionDisplay
– Video oynatıcının altında yer paylaşımlı olarak, video izleme sayfasında 300x250 boyutlu bir reklam birimi olarak ya da her ikisinin kombinasyonu olarak görünen bir rich media veya resim reklam. Yer paylaşımı çalıştığında, belirli bir süre gösterildikten sonra otomatik olarak kapanır ve kullanıcı da yer paylaşımını kapatabilir. Bir yer paylaşımı ve bir banner birlikte gösterilirse her reklam ayrı bir gösterim olarak sayılır. -
auctionInstream
: Ana video öncesinde, sırasında veya sonrasında yayınlanan, atlanamayan video reklamlardır. -
auctionTrueviewInslate
– İzleyici, videodan önce gösterilen seçenekler arasından birkaç video reklamdan birini seçer. See the TrueView documentation for more information. -
auctionTrueviewInstream
: Ana videodan önce veya video sırasında yayınlanan atlanabilir video reklamlar. Daha fazla bilgi için TrueView belgelerini inceleyin. -
auctionUnknown
– AdWords açık artırması aracılığıyla satın alınmış, ancak diğer reklam türlerinden birinde sınıflandırılmamış reklam. -
reservedBumperInstream
– Rezervasyon esasıyla satılan, videonun görüntülenebilmesi için en fazla 6 saniye süren atlanamayan video reklamlardır. -
reservedClickToPlay
– Kullanıcının oynatmayı başlatmak için tıklaması gereken video reklam. Tıkla oynat reklam birimi her görüntülendiğinde, kullanıcının oynatmayı başlatıp başlatmadığına bakılmaksızın bir reklam gösterimi kaydedilir. Bu fiyatlar rezervasyon esasıyla satılır. -
reservedDisplay
– Video oynatıcının altında yer paylaşımlı olarak, video izleme sayfasında 300x250 boyutlu bir reklam birimi olarak ya da her ikisinin kombinasyonu olarak görünen bir rich media veya resim reklam. Yer paylaşımı çalıştığında, belirli bir süre gösterildikten sonra otomatik olarak kapanır ve kullanıcı da yer paylaşımını kapatabilir. Bir yer paylaşımı ve bir banner birlikte gösterilirse her reklam ayrı bir gösterim olarak sayılır. -
reservedInstream
: Ana videonun öncesinde, sırasında veya sonrasında eklenen, atlanamayan video reklamlardır. -
reservedInstreamSelect
-
reservedMasthead
– Video ve grafik öğeleri içerebilen ve ana sayfada gösterilen büyük bir reklamdır. -
reservedUnknown
: Ayrılmış temelde satılan ve diğer reklam türlerinden birinde sınıflandırılamayan bir reklamdır. -
unknown
- Bu reklam türünü sınıflandıramadık.
-
Örnekler
Aşağıdaki örnek raporlar reklam performansı veya gelir metriklerini alır:
Kanal örnekleri
-
Gelir/Reklamlar
- Kanal geliri ve reklam performansı metrikleri
- Günlük gelir ve reklam performansı metrikleri
- Ülkelere özgü gelir ve reklam performansı metrikleri
- İlk 10 - En yüksek gelir sağlayan videolar
- Farklı reklam türleri için reklam performansı metrikleri
-
Gelir/Reklamlar
İçerik sahibi örnekleri
-
Gelir/Reklamlar
- Hak talebinde bulunulan içerikler için gelir ve reklam performansı metrikleri
- Günlük gelir ve reklam performansı metrikleri
- Ülkelere özgü gelir ve reklam performansı metrikleri
- İlk 10 - En yüksek gelir sağlayan videolar
- Farklı reklam türleri için reklam performansı metrikleri
-
Gelir/Reklamlar
Oynatma listeleri
- isCurated (yalnızca filtre)
- Bu filtre, isteğin bir oynatma listesi bağlamında gerçekleşen video görüntülemeleriyle ilgili verileri aldığını gösterir.
Örnekler
Oynatma listesi raporlarını alan örnek isteklerin tümü isCurated
filtresini kullanır.
İçerik sahibi boyutları
Aşağıdaki boyutlar yalnızca içerik sahibi raporlarında desteklenir.
- claimStatus (yalnızca içerik sahibi raporlarında kullanılır)
- Bu boyut, API yanıtlarının yalnızca hak talebinde bulunulan içerikle ilgili metrikleri içermesi gerektiğini belirtmenizi sağlar. Bu boyut için geçerli tek değer şudur:
claimed
.filters
parametresi, sorguyuclaimedStatus==claimed
ile kısıtlarsa API yalnızca hak talebinde bulunulan içeriğin verilerini alır.uploaderType
boyutunun tanımındaki tabloda, bu boyutun nasıl kullanılacağı hakkında daha ayrıntılı bilgi verilmektedir.
- yükleyiciType (temel boyut) (yalnızca içerik sahibi raporlarında kullanılır)
- Bu boyut, bir API yanıtının belirtilen içerik sahibi tarafından yüklenen ve/veya üçüncü taraflarca yüklenen içeriklerle (ör. kullanıcı tarafından yüklenen videolar) ilgili metrikleri içermesi gerekip gerekmediğini belirtmenizi sağlar. Geçerli değerler
self
vethirdParty
'dir. Bu temel bir boyuttur ve Kullanımdan Kaldırma Politikası'na tabidir.
Aşağıdaki tabloda, her ikisi defilters
parametresinde kullanılanclaimedStatus
veuploaderType
boyutları için desteklenen kombinasyonlar gösterilmektedir:
claimedStatus
değeruploaderType
değerAçıklama [Ayarlanmadı] kendisi İçerik sahibi tarafından yüklenen, hak talebinde bulunulmuş ve bulunulmamış içeriklerle ilgili YouTube Analytics verilerini alır. hak iddia edilen [Ayarlanmadı] İçerik sahibi veya üçüncü bir tarafça yüklenen, hak talebinde bulunulmuş içeriklerin verilerini alır. hak iddia edilen kendisi İçerik sahibi tarafından yüklenen ve hak talebinde bulunulan içeriklerin verilerini alır. hak iddia edilen thirdParty Üçüncü taraflarca yüklenen, hak talebinde bulunulmuş içeriklerin verilerini alır.
Örnekler
İçerik sahibi raporlarına yönelik örnek API isteklerinin çoğunda, verileri filtrelemek için desteklenen bir claimedStatus
ve uploaderType
boyutu kombinasyonu kullanılır.