Dimensions

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ın id ö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ın id ö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ın id ö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

  • İç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

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) veya FR (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) veya US-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ği dimensions parametre değerinde province içeriyorsa isteğin, filters parametre değerine country==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
Bu boyut yalnızca verileri filtrelemek için kullanılabilir. Bu boyutu kullanmak için yukarıdaki listeden bir REGION_CODE değeri belirterek filters parametresinin değerini continent==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 belirterek filters parametresinin değerini subContinent==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 sorgunuz month boyutunu kullanıyorsa start-date ve end-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

  • İç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

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ı olarak WATCH, EMBEDDED veya EXTERNAL_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

  • İç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 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 ve UNSUBSCRIBED'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ülemenin subscribedStatus değerinin SUBSCRIBED ve bir görüntülemenin subscribedStatus değerinin UNSUBSCRIBED 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ız insightTrafficSourceDetail 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ız insightTrafficSourceDetail 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ız insightTrafficSourceDetail 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ız insightTrafficSourceDetail 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ız insightTrafficSourceDetail 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ız insightTrafficSourceDetail 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ız insightTrafficSourceDetail 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ız insightTrafficSourceDetail 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'lerindeki uploaded öğ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

  • İç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

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

  • İç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

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-
This is a core dimension and is subject to the Deprecation Policy.
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 ve user_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)

  • İç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)

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çin 0.01 ile 1.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 ve AD_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:

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

  • İç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

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.

Önemli: İçerik sahibi raporlarını almak için yapılan API istekleri, verileri aşağıdaki boyutlardan birini kullanarak filtrelemelidir:
  • video
  • channel
  • Aşağıda tanımlandığı şekilde, claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonu.
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, sorguyu claimedStatus==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 ve thirdParty'dir. Bu temel bir boyuttur ve Kullanımdan Kaldırma Politikası'na tabidir.

Aşağıdaki tabloda, her ikisi de filters parametresinde kullanılan claimedStatus ve uploaderType boyutları için desteklenen kombinasyonlar gösterilmektedir:

claimedStatus değer uploaderType değer Açı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.