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ı ve hedefli sorguları destekler.

Boyutlar, verileri toplamak için kullanılan ortak ölçütlerdir. Örneğin, kullanıcı etkinliğinin gerçekleştiği tarih veya kullanıcıların bulunduğu ülke.

Her sorgu raporu, desteklediği boyutları tanımlar. Örneğin, kullanıcı etkinliği zamana göre alındığında verilerin raporlanacağı zaman aralığını (gün veya ay) seçersiniz. Herhangi bir raporda, her veri satırının benzersiz bir boyut değeri kombinasyonu vardır.

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 tüm boyutlar açıkça belirtilir.

Aşağıdaki listede API'nin temel boyutları tanımlanmıştır.

Daha fazla bilgi için Desteği Sonlandırma Politikası'na tabi YouTube API'lerinin listesine bakın.

Filtreler

Tüm sorgu raporları filtreleri destekler. Filtreler, alınan veri kümesinde bulunması gereken boyut değerlerini tanımlar. Bu nedenle, API yanıtını yalnızca belirli bir değerle veya değer grubuyla eşleşen verileri içerecek şekilde sınırlandırırlar. Örneğin, tüm ülkelerdeki kullanıcı etkinliği metriklerini almak yerine yalnızca belirli bir ülkedeki verileri almak için filtre kullanabilirsiniz.

Bir sorgu raporunu alma isteğinde, isteğe bağlı filters istek parametresi, verileri filtrelemek istediğiniz boyut değerlerini belirtir. Örneğin, Avrupa'daki kullanıcı etkinliği metriklerini almak için filters parametre değerini continent==150 olarak ayarlarsınız.

Önemli: İçerik sahibinin raporlarını almak için yapılan API isteklerinde, veriler raporlama öğesi boyutlarından biri veya claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonu kullanılarak filtrelenmelidir.

Boyutlar

Aşağıdaki bölümlerde, YouTube Analytics API'nin sorgu raporlarında kullanılan boyutlar tanımlanmaktadır. 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ımlanı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ış bir listesi olarak ayarlayın. Parametre değeri en fazla 500 kimlik belirtebilir.

video (temel boyut)
YouTube videosunun kimliği. YouTube Data API'de bu, 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, playlist kaynağının id özelliğinin değeridir.
channel (temel boyut) (yalnızca içerik sahibi raporlarında kullanılır)
YouTube kanalının kimliği. YouTube Data API'de bu, channel kaynağının id özelliğinin değeridir. This is a core dimension and is subject to the Deprecation Policy.

Bu raporlar genellikle birden fazla kanalın verilerini topladığından channel boyutu, içerik sahibi raporlarında sıklıkla kullanılır.
group (yalnızca filtre)
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ın, oynatma listelerinin veya kanalların verilerini içerir.

Örnekler

Aşağıdaki örnek isteklerde raporlama öğesi boyutları veya filtreleri kullanılmaktadır:

  • Kanal örnekleri

    • Temel istatistikler
      • En çok izlenen 10 video (kanal için)
      • İlk 10: Bir kanalın en çok görüntülenen videolarının ek açıklama tıklama oranları
      • Belirli bir oynatma listesinin istatistikleri
      • En çok izlenen 10 oynatma listesi
    • Coğrafi
      • En çok izlenen 10 video (belirli bir ülkede)
      • En çok izlenen 10 video - Avrupa

  • İçerik sahibi örnekleri

    • Temel istatistikler
      • En popüler 10: İçerik sahibinin en çok görüntülenen videoları
      • En popüler 10: İçerik sahibinin en çok izlenen videoları
      • En popüler 10: Bir içerik sahibinin kanalında en çok görüntülenen videolar
      • İlk 10: Bir kanalın en çok görüntülenen videolarının ek açıklama tıklama oranları
      • En iyi 10: İçerik sahibinin en çok izlenen oynatma listeleri
    • Coğrafi
      • En çok izlenen 10 video: Avrupa'da bir içerik sahibinin en çok izlenen videoları
      • En çok başlatılan oynatma listeleri - ABD'deki ilk 10

Coğrafi alanlar

Bu boyutlar, kullanıcı etkinliği, reklam performansı veya tahmini gelir metrikleriyle ilişkili bir coğrafi bölgeyi tanımlar.

country (temel boyut)
Rapor satırındaki metriklerle ilişkili ülke. Boyut değeri, US, CN (Çin) veya FR (Fransa) gibi iki harfli bir ISO-3166-1 ülke kodudur. YouTube'un ilişkili ülkeyi tanımlayamadığı metrikleri bildirmek için ZZ ülke kodu kullanılır. This is a core dimension and is subject to the Deprecation Policy.
province
Rapor satırındaki metriklerle ilişkili ABD eyaleti veya idari bölgesi. Boyut değeri, US-MI (Michigan) veya US-TX (Teksas) gibi bir ABD eyaletini ya da Columbia Bölgesi'ni tanımlayan bir ISO 3166-2 kodudur. YouTube'un ilişkili ABD eyaletini belirleyemediği metrikleri bildirmek için US-ZZ eyalet kodu kullanılır. Bir API isteği, dimensions parametre değerinde province içeriyorsa istek, filters parametre değerine country==US eklenerek verileri Amerika Birleşik Devletleri ile de kısıtlamalıdır.

Not: Bu boyut, ABD'nin denizaşırı bölgelerini tanımlayan ISO 3166-2 değerlerini desteklemez. Bunun nedeni, bu bölgelerin kendi ISO 3166-1 ülke kodlarının da olmasıdır. Ayrıca, ABD dışındaki ülkelerin alt bölümlerini de desteklemez.

dma
Nielsen'in, veri satırında açıklanan görüntüleme etkinlikleriyle ilişkili Tanımlanmış Pazar Alanı'nı (TPA) tanımlamak için kullandığı 3 haneli tanımlayıcı.
city
Rapor satırındaki metriklerle ilişkili tahmini şehir. Bu boyutla ilgili veriler 1 Ocak 2022'den itibaren kullanılabilir.
continent (yalnızca filtre)
Birleşmiş Milletler (BM) istatistiksel bölge kodu. API aşağıdaki 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 tablodan 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 bir BM istatistiksel bölge kodu. Birleşmiş Milletler İstatistik Bölümü, alt bölgeleri ve her bölgeyle ilişkilendirdiği ülkeleri listeler.

Bu boyut yalnızca verileri filtrelemek için kullanılabilir. Bu boyutu kullanmak için filters parametresinin değerini subContinent==REGION_CODE olarak ayarlayın ve BM listesinden bir REGION_CODE değeri belirtin.

Örnekler

Aşağıdaki örnek isteklerde coğrafi boyutlar veya filtreler kullanılmaktadır:

  • Kanal örnekleri

    • Temel istatistikler: Bir kanalın ülkeye özel görüntüleme sayıları (ve daha fazlası)
    • Coğrafi
      • Bir kanalın videoları için ülkeye özel izlenme süresi metrikleri
      • Bir kanalın videoları için ülkeye özel ek açıklama metrikleri
      • ABD eyaletleri ve Washington D.C. için eyalete özel metrikler
      • Bir kanalın oynatma listeleriyle ilgili ülkeye özel izlenme süresi metrikleri
      • En çok başlatılan oynatma listeleri - ABD'deki ilk 10
    • Oynatma konumu: Farklı oynatma konumlarındaki günlük görüntüleme sayısı ve izlenme süresi
    • Trafik kaynağı: Bir ülkedeki farklı trafik kaynaklarından elde edilen izlenme sayıları ve izlenme süresi
    • Demografi: Kaliforniya'daki izleyicilerin demografik bilgileri (yaş grubu ve cinsiyet)
    • En iyi videolar
      • En çok izlenen 10 video (belirli bir ülkede)
      • En çok izlenen 10 video - Avrupa

  • İçerik sahibi örnekleri

    • Temel istatistikler: Kendiniz yüklediğiniz tüm videolar için ülkeye özel görüntüleme sayıları (ve daha fazlası)
    • Coğrafi
      • Kendi yüklediğiniz içeriklerle ilgili ülkeye özel izleme süresi metrikleri
      • Kendi yüklediğiniz içerikler için ülkeye özel açıklama metrikleri
      • ABD eyaletleri ve Washington D.C. için eyalete özel metrikler
      • İçerik sahibinin oynatma listeleri için ülkeye özel izlenme süresi metrikleri
      • En çok başlatılan oynatma listeleri - ABD'deki ilk 10
    • Oynatma konumu: Farklı oynatma konumlarındaki günlük görüntüleme sayısı ve izlenme süresi
    • Demografi: Kaliforniya'daki izleyicilerin demografik bilgileri (yaş grubu ve cinsiyet)
    • En iyi videolar: İlk 10: Bir içerik sahibinin Avrupa'da en çok izlenen videoları
    • Gelir/Reklam performansı: Ülkeye özgü gelir ve reklam performansı metrikleri

Dönemler

Bu boyutlar, bir raporun verileri bir zaman aralığına (ör. gün, hafta veya ay) göre toplaması gerektiğini gösterir. startDate ve endDate istek parametreleri, raporun veri içerdiği dönemi belirtir. Raporun, sorgu yapıldığı sırada istekte belirtilen tüm metriklerin mevcut 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 (UTC-7 veya UTC-8) 12:00'da başlayıp belirtilen gün, ay ve yılda Pasifik saatiyle 23:59'da sona eren zaman aralığını ifade eder. Sonuç olarak, saatlerin yaz saati uygulaması için ileri alındığı tarihler 23 saatlik bir dönemi, geri alındığı tarihler ise 25 saatlik bir dönemi temsil eder.

Ay boyutu, belirtilen ay ve yılın ilk günü Pasifik Saatiyle 12:00'da (UTC-7 veya UTC-8) başlayan zaman aralığını ifade eder.

gün (temel boyut)
Bu boyutu kullandığınızda rapordaki veriler günlük olarak toplanır ve her satır bir günlük veriyi içerir. Verileri daha da ayrıntılı olarak incelemek için diğer boyutları kullanabilirsiniz. Örneğin, bir trafik kaynağı raporu, kullanıcıların videolarınıza ulaşma şekline göre günlük görüntüleme istatistiklerini toplayabilir. This is a core dimension and is subject to the Deprecation Policy.
month (temel boyut)
Raptaki veriler takvim ayına göre toplanır. Günlük raporlarda olduğu gibi, verileri daha da segmentlere ayırmak için başka filtreler de kullanabilirsiniz. Raporlarda tarihler YYYY-MM biçiminde listelenir.

Not: API sorgunuzda month boyutu kullanılı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 isteklerde zamansal boyutlar veya filtreler kullanılır:

  • Kanal örnekleri

    • Zamana dayalı
      • Bir kanalın videolarının günlük izlenme süresi metrikleri
      • Bir kanalın videolarıyla ilgili 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ısı ve izlenme süresi
    • Trafik kaynağı: Farklı trafik kaynaklarından elde edilen günlük görüntüleme sayısı ve izlenme süresi
    • Cihaz/OS
      • 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çeriklerin günlük izlenme süresi metrikleri
      • Hak talebinde bulunulan içeriklerle ilgili 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ısı ve izlenme süresi
    • Trafik kaynağı: Farklı trafik kaynaklarından elde edilen günlük görüntüleme sayısı ve izlenme süresi
    • Cihaz/OS
      • Hak talebinde bulunulan videolar için günlük cihaz türü metrikleri
      • Mobil cihazlarda görüntülenen hak talebinde bulunulan videolar için 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
Raporlardaki veriler, video oynatmalarının gerçekleştiği sayfa veya uygulama türüne göre toplanır. Bu boyut için olası değerler:

  • BROWSE – Veriler, YouTube ana sayfasında veya ana ekranında, kullanıcının abonelikler akışında ya da başka bir YouTube gezinme özelliğinde gerçekleşen görüntülemeleri açıklar.

  • CHANNEL: Veriler, kanal sayfasında gerçekleşen görüntülemeleri açıklar.

  • EMBEDDED: Veriler, videonun <iframe> veya <object> yerleştirme kullanılarak yerleştirildiği başka bir web sitesinde ya da uygulamada gerçekleşen görüntülemeleri açıklar.

  • EXTERNAL_APP – Veriler, videonun <iframe> veya <object> yerleştirme dışında bir yöntem kullanılarak oynatıldığı üçüncü taraf uygulamasında gerçekleşen görüntülemeleri açıklar. Örneğin, YouTube Android Player API'yi kullanan uygulamalardaki oynatmalar bu değer kullanılarak kategorize edilir.

  • MOBILE – Veriler, mobil cihazlar da dahil olmak üzere YouTube'un mobil web sitesinde veya onaylanmış YouTube API istemcilerinde gerçekleşen görüntülemeleri açıklar.

    10 Eylül 2013'ten itibaren oynatmalar, YouTube Analytics raporlarında artık MOBILE oynatma olarak sınıflandırılmıyor. Eski veriler hâlâ bu kategoriye dahil olduğundan değer raporlarda kalabilir. Ancak bu tarihten sonra, mobil oynatmalar, oynatmaların gerçekleştiği uygulama türüne bağlı olarak WATCH, EMBEDDED veya EXTERNAL_APP oynatma olarak sınıflandırılır.

  • SEARCH: Veriler, doğrudan YouTube arama sonuçları sayfasında gerçekleşen görüntülemeleri açıklar.

  • WATCH: Veriler, videonun YouTube izleme sayfasında veya YouTube Android uygulaması gibi resmi bir YouTube uygulamasında gerçekleşen görüntülemeleri açıklar.

  • YT_OTHER – Veriler, başka şekilde sınıflandırılmamış görünümleri açıklar.

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 belirli bir video için en çok görüntüleme oluşturan yerleştirilmiş oynatıcıları tanımladığını unutmayın. Bu nedenle, en çok kullanılan yerleştirilmiş oynatıcılarla ilişkili URL'leri veya uygulamaları belirleyerek oynatma konumu raporuna kıyasla daha ayrıntılı bir görünüm sunar.

Örnekler

Aşağıdaki örnek isteklerde oynatma konumu boyutları kullanılmaktadır:

  • Kanal örnekleri

    • Oynatma konumu
      • Farklı oynatma konumlarından gelen görüntüleme sayıları ve izlenme süresi
      • Farklı oynatma konumlarından elde edilen günlük görüntüleme sayıları ve izlenme süresi
      • En popüler 10: Yerleştirilmiş bir videonun en çok görüntülenmesini sağlayan üçüncü taraf siteler
      • Farklı oynatma konumlarından gelen oynatma listesi görüntüleme sayıları ve izlenme süresi
      • Farklı oynatma konumlarından gelen 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ıları ve izlenme süresi
      • Farklı oynatma konumlarından elde edilen günlük görüntüleme sayıları ve izlenme süresi
      • En popüler 10: Yerleştirilmiş bir videonun en çok görüntülenmesini sağlayan üçüncü taraf siteler
      • Farklı oynatma konumlarından gelen oynatma listesi görüntüleme sayıları ve izlenme süresi
      • Farklı oynatma konumlarından gelen 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 itibaren kullanılabilir.

Aşağıdaki tabloda boyut değerleri listelenmiştir:
Değerler
LIVE_STREAM İzlenen içerik YouTube canlı yayını olmalıdır.
SHORTS Görüntülenen içerik bir YouTube Shorts videosu olmalıdır.
STORY Görüntülenen içerik bir YouTube Hikayesi olmalıdır.
VIDEO_ON_DEMAND Görüntülenen içerik, diğer boyut değerlerinden birine girmeyen bir YouTube videosuydu.
UNSPECIFIED Görüntülenen içeriğin 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 itibaren kullanılabilir.

Boyut değerleri aşağıdaki tabloda 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 Satırın verileri, canlı yayın sırasında gerçekleşmeyen 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şkili olup olmadığını gösterir. Olası değerler SUBSCRIBED ve UNSUBSCRIBED'dir.

Boyut değerinin, kullanıcı etkinliğinin gerçekleştiği an itibarıyla doğru olduğunu unutmayın. Örneğin, bir kullanıcının bir kanala abone olmadığını ve bu kanalın videolarından birini izlediğini, ardından aynı gün içinde kanala abone olup başka bir video izlediğini varsayalım. Kanalın raporu, bir görüntülemenin subscribedStatus değerinin SUBSCRIBED, bir görüntülemenin subscribedStatus değerinin ise 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'ten itibaren kullanılabilir.

Aşağıdaki tabloda boyut değerleri listelenmektedir:
Değerler
CORE Kullanıcı etkinliği, YouTube'un özel uygulamalarından birinde (YouTube Gaming, YouTube Kids veya YouTube Music) gerçekleşmemişse. İstisna: 1 Mart 2021'den önce YouTube Music'te gerçekleşen kullanıcı etkinliği CORE'ye dahil edilir.
GAMING Kullanıcı etkinliği YouTube Gaming'de gerçekleşti.
KIDS Kullanıcı etkinliği YouTube Kids'de gerçekleştiyse
MUSIC Kullanıcı etkinliği, 1 Mart 2021'de veya sonrasında YouTube Music'te gerçekleştiyse 1 Mart 2021'den önceki veriler CORE'da yer alır. Gerçek zamanlı veriler kaydedilmez.
UNKNOWN Kullanıcı etkinliği 18 Temmuz 2015'ten önce gerçekleştiyse.

Trafik kaynakları

insightTrafficSourceType
Raptaki 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 şunlardır:
  • ADVERTISING – İzleyici, bir reklam aracılığıyla videoya yönlendirilmiştir. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı, reklam türünü tanımlar.
  • ANNOTATION – İzleyiciler, başka bir videodaki ek açıklamayı tıklayarak videoya ulaştı.
  • CAMPAIGN_CARD – Görüntüleme sayısı, içerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, kullanıcı tarafından yüklenen ve hak talebinde bulunulan videolardan kaynaklanır. Bu trafik kaynağı yalnızca içerik sahibi raporları için desteklenir.
  • END_SCREEN: Görüntülemeler, başka bir videonun bitiş ekranından yönlendirilmiştir.
  • EXT_URL: Video görüntülemeleri, 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 videoları hashtag sayfalarından veya Shorts hashtag pivot sayfalarından gelen görüntülemeler.
  • LIVE_REDIRECT - Video görüntülemeleri Live Redirects'ten yönlendirildi.
  • NO_LINK_EMBEDDED: Video, izlenirken başka bir web sitesine yerleştirilmişti.
  • NO_LINK_OTHER – YouTube, trafik için bir yönlendiren tanımlamadı. Bu kategori, bir videoya doğrudan gelen trafiğin yanı sıra mobil uygulamalardaki trafiği de kapsar.
  • NOTIFICATION: Video görüntülemeleri, YouTube'dan gelen bir e-posta veya bildirimden yönlendirilmiştir.
  • PLAYLIST: Video izlemeleri, 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ülemeleri bir ürün sayfasından yönlendirilmiştir.
  • PROMOTED: Video görüntülemeleri, YouTube'un "Öne Çıkan Videolar" sayfası gibi ücretsiz bir YouTube tanıtımından yönlendirilmiştir.
  • RELATED_VIDEO – Video görüntülemeleri, başka bir video izleme sayfasındaki ilgili video listelemesinden yönlendirilmiştir. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanında söz konusu videonun video kimliği belirtilir.
  • SHORTS: İzleyici, Shorts izleme deneyiminde önceki videodan dikey olarak kaydırılarak yönlendirildi.
  • SOUND_PAGE: Shorts ses pivot sayfalarından gelen görüntülemeler.
  • SUBSCRIBER: Video görüntülemeleri, YouTube ana sayfasındaki özet akışlarından veya YouTube abonelik özelliklerinden yönlendirilmiştir. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı, görüntülemelerin yönlendirildiği ana sayfa feed'i öğelerini veya diğer sayfayı belirtir.
  • YT_CHANNEL: Video görüntülemeleri bir kanal sayfasında gerçekleşti. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı, söz konusu kanalın kanal kimliğini belirtir.
  • YT_OTHER_PAGE: Video izlenmeleri, YouTube sayfasında görünen bir 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ülemeleri, YouTube arama sonuçlarından yönlendirilmiştir. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı, arama terimini belirtir.
  • VIDEO_REMIXES – Video görüntülemeleri, Shorts video oynatıcısındaki remiks olarak derlenen video bağlantısından yönlendirilmiştir. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanında, izleyicinin yönlendirildiği video belirtilir.
insightTrafficSourceDetail
Raptaki veriler, belirli bir video ve belirli bir trafik kaynağı türü için en çok görüntülemeyi oluşturan yönlendirenlere göre toplanır. Aşağıdaki listede, bu raporun kullanılabildiği trafik kaynakları belirtilmektedir. Liste, her trafik kaynağı için insightTrafficSourceDetail boyutunun sağladığı bilgileri tanımlar.
  • ADVERTISING: Görüntülemelere yol açan reklam türü. Olası değerler:
    • Tıkla ve 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 ve görüntülü TrueView
    • Yayın içi (in-stream) TrueView
    • Kategorize edilmemiş YouTube reklamcılığı
    • Video duvarı
  • CAMPAIGN_CARD – İzleyicileri raporda belirtilen videoya yönlendiren, hak talebinde bulunulan video.
  • END_SCREEN: İzleyicileri raporda belirtilen videoya yönlendiren video.
  • EXT_URL: İzleyicileri videoya yönlendiren web sitesi.
  • HASHTAGS: Görüntülemelere yol açan hashtag.
  • NOTIFICATION: Trafiği yönlendiren e-posta veya bildirim.
  • RELATED_VIDEO: İzleyicileri raporda ele alınan videoya yönlendiren ilgili video.
  • SOUND_PAGE: Görüntülemelere yol açan video.
  • SUBSCRIBER – İzleyicileri raporda ele alınan videoya yönlendiren ana sayfa özet akışı öğesi veya YouTube abonelik özelliği. Geçerli değerler:
    • activity – Beğeniler, favoriler, duyuru gönderileri ve oynatma listesine eklemeler gibi yükleme ve sosyal kanal etkinliği dışındaki işlemlerden kaynaklanan, ana sayfa abonelik akışlarındaki öğelerin aldığı görüntülemeler.
    • blogged: Ana sayfa abonelik özet akışlarındaki öğelerin, en popüler bloglardaki bağlantılar aracılığıyla aldığı görüntülemeler.
    • mychannel – Ana sayfada listelenen diğer feed'lerdeki öğelerden (ör. "Beğenilenler", "İzleme Geçmişi" ve "Daha Sonra İzle") gelen görüntülemeler.
    • podcasts: Podcast hedef sayfasındaki öğelerden kaynaklanan görüntülemeler.
    • sdig: Abonelik güncelleme e-postalarından gelen izlenme sayısı.
    • uploaded: Ana sayfa abonelik özet akışlarındaki uploaded öğelerinin aldığı görüntülemelerdir.
    • / – YouTube ana sayfasından kaynaklanan diğer görüntülemeler.
    • /my_subscriptions – Kullanıcıların YouTube'daki Aboneliklerim sayfalarından gelen izlenmeler.
  • YT_CHANNEL: İzleyicilerin videoyu izlediği kanal sayfası.
  • YT_OTHER_PAGE: İzleyicilerin videoya yönlendirildiği YouTube sayfası.
  • YT_SEARCH – İzleyicileri videoya yönlendiren arama terimi.
  • VIDEO_REMIXES: Görüntülemelere yol açan video.

Örnekler

Aşağıdaki örnek isteklerde trafik kaynağı boyutları kullanılmaktadır:

  • Kanal örnekleri

    • Trafik kaynağı
      • Bir ülkedeki farklı trafik kaynaklarından gelen görüntüleme sayıları ve izlenme süresi
      • Farklı trafik kaynaklarından gelen günlük izlenme sayıları ve izlenme süresi
      • İlk 10: Bir videoya en çok trafik getiren YouTube arama terimleri
      • En çok aranan 10 arama terimi: Bir videoya en çok trafiği sağlayan Google arama terimleri
      • Bir ülkedeki farklı trafik kaynaklarından gelen oynatma listesi görüntüleme sayıları ve izlenme süresi
      • Farklı trafik kaynaklarından gelen günlük oynatma listesi görüntüleme sayıları ve izlenme süresi

  • İçerik sahibi örnekleri

    • Trafik kaynağı
      • Farklı trafik kaynaklarından gelen görüntüleme sayıları ve izlenme süresi
      • Farklı trafik kaynaklarından gelen günlük izlenme sayıları ve izlenme süresi
      • İlk 10: Bir videoya en çok trafik getiren YouTube arama terimleri
      • En çok aranan 10 arama terimi: Bir videoya en çok trafiği sağlayan Google arama terimleri
      • Bir ülkedeki farklı trafik kaynaklarından gelen oynatma listesi görüntüleme sayıları ve izlenme süresi
      • Farklı trafik kaynaklarından gelen günlük oynatma listesi görüntüleme sayıları 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 listede, API'nin veri döndürdüğü cihaz türleri belirtilmektedir. Ayrıca, bir işletim sistemi raporunun yalnızca belirli bir cihaz türüne ait verileri içermesini sağlamak için deviceType boyutunu filtre olarak da kullanabilirsiniz.
  • DESKTOP
  • GAME_CONSOLE
  • MOBILE
  • TABLET
  • TV
  • AUTOMOTIVE
  • WEARABLE
  • UNKNOWN_PLATFORM
operatingSystem
Bu boyut, görüntülemenin gerçekleştiği cihazın yazılım sistemini tanımlar. Aşağıdaki listede, API'nin veri döndürdüğü işletim sistemleri belirtilmiştir. Ayrıca, bir cihaz türü raporunun yalnızca belirli bir işletim sistemine ait verileri içerecek şekilde sınırlandırılması için operatingSystem simgesini filtre olarak da 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 isteklerde cihaz boyutları kullanılır:

  • Kanal örnekleri

    • Cihaz/OS
      • 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 sistemindeki oynatma listesi görüntülemeleri için günlük cihaz türü metrikleri
      • Mobil cihazlarda oynatma listesi görüntülemeleriyle ilgili günlük işletim sistemi metrikleri

  • İçerik sahibi örnekleri

    • Cihaz/OS
      • Hak talebinde bulunulan videolar için günlük cihaz türü metrikleri
      • Mobil cihazlarda görüntülenen hak talebinde bulunulan videolar için günlük işletim sistemi metrikleri
      • Günlük işletim sistemi ve cihaz türü metrikleri
      • Android işletim sistemindeki oynatma listesi görüntülemeleri için günlük cihaz türü metrikleri
      • Mobil cihazlarda oynatma listesi görüntülemeleriyle ilgili 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şkili, oturum açmış 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 (çekirdek boyut)
Bu boyut, rapor verileriyle ilişkili 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 isteklerde demografik boyutlar kullanılır:

  • Kanal örnekleri

    • Demografi
      • Kaliforniya'daki izleyicilerin demografik özellikleri (yaş grubu ve cinsiyet)
      • California'daki oynatma listesi izleyicilerinin demografik özellikleri (yaş grubu ve cinsiyet)

  • İçerik sahibi örnekleri

    • Demografi
      • Kaliforniya'daki izleyicilerin demografik özellikleri (yaş grubu ve cinsiyet)
      • California'daki oynatma listesi izleyicilerinin demografik özellikleri (yaş grubu ve cinsiyet)

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

sharingService (temel boyut)
Bu boyut, videoları paylaşmak için kullanılan hizmeti tanımlar. Videolar, "Paylaş" düğmesi kullanılarak YouTube'da (veya YouTube oynatıcısı üzerinden) paylaşılabilir. This is a core dimension and is subject to the Deprecation Policy.

Aşağıdaki tabloda geçerli boyut değerleri listelenmektedir:
Paylaşım hizmeti API değeri
Ameba 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
Digg DIGG
Dropbox DROPBOX
Yerleştir EMBED
E-posta MAIL
Facebook FACEBOOK
Facebook Messenger FACEBOOK_MESSENGER
Facebook sayfaları FACEBOOK_PAGES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC kısa mesajı HTC_MMS
Google Inbox INBOX
iOS Sistem Etkinliği İletişim Kutusu IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
LGE Email LGE_EMAIL
Çizgi LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola Mesajlar MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Yakındakilerle Paylaş NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
Diğer OTHER
Pinterest PINTEREST
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Conversations SONY_CONVERSATIONS
StumbleUpon STUMBLEUPON
Telegram TELEGRAM
Kısa mesaj TEXT_MESSAGE
Tuenti TUENTI
tumblr. TUMBLR
Twitter TWITTER
Bilinmiyor UNKNOWN
Verizon mesajları VERIZON_MMS
Viber VIBER
VKontakte (ВКонтакте) VKONTAKTE
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
Wykop WYKOP
Yahoo! Japonya YAHOO
YouTube Oyun YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Music YOUTUBE_MUSIC
YouTube TV YOUTUBE_TV

Daha fazla bilgi için yardım belgelerine bakın.

Örnekler

Aşağıdaki örnek isteklerde sosyal boyutlar kullanılmaktadı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 video uzunluğuna oranını belirtir. Elde tutma boyutları ve metrikleri, kitleyi elde tutma oranını zaman içinde ölçmek için kullanılır. elapsedVideoTimeRatio boyutu, zaman ölçümüdür. Örneğin, 0.4 değeri, ilgili rapor verilerinin videonun %40'ı tamamlandıktan sonraki elde tutma verilerini gösterdiğini belirtir.

API, her video için 100 veri noktası döndürür. Oran değerleri 0.01 ile 1.0 arasında değişir. Video oynatılırken verilerin ölçüldüğü zamanlar, her video için eşit aralıklarla belirlenir. Bu durumda, iki dakikalık bir videoda veri noktaları arasındaki aralık 1,2 saniyedir. Ancak iki saatlik bir videoda veri noktaları arasındaki aralık 72 saniyedir. Boyutun değeri, aralığın bitiş zamanını (hariç) 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 filtresiyle ilgili verilerin 25 Eylül 2013'ten itibaren kullanılabildiğini unutmayın. API, daha önceki tarihlerden veri almaya çalışmak için filtreyi kullanan sorgularla ilgili verileri döndürmez. Filtreyi kullanmayan sorgular, 1 Temmuz 2008'den sonraki herhangi bir tarih için çalışır.

Örnekler

Aşağıdaki örnek isteklerde kitleyi elde tutma boyutları kullanılır:

Canlı yayın

livestreamPosition
Bu boyut, canlı video yayını sırasında belirli bir dakikayı belirtir. Rapor metrikleri, o sırada canlı yayını izleyen kullanıcı sayısını gösterir.

Üyelik iptalleri

membershipsCancellationSurveyReason
Raporlama döneminde belirtilen kanal için kanal üyeliklerini iptal eden YouTube kullanıcılarının tamamladığı anketlerin sayısı. Aşağıdaki tabloda geçerli boyut değerleri listelenmektedir:
API değeri Açıklama
UNKNOWN Kullanıcı anketi tamamlamadı.
DISLIKE_PERKS Kullanıcı, üyeliğin avantajlarını beğenmedi.
PERKS_NOT_DELIVERED Kullanıcı, vaat edilen üyelik avantajlarının sunulmadığını belirtti.
CANNOT_ACCESS_PERKS Kullanıcı, avantajlara erişemedi.
NO_LONGER_INTERESTED Kullanıcı artık kanal üyeliğiyle ilgilenmiyor.
FEEL_UNAPPRECIATED Kullanıcı, kanal üyesi olarak takdir edilmediğini düşünüyor.
FINANCIAL_REASONS Kullanıcı, finansal nedenlerle iptal etti.
JOIN_LIMITED_TIME Kullanıcı yalnızca sınırlı bir süreliğine katılmak istiyordu.
OTHER Kullanıcının iptal için başka bir nedeni vardı.

Reklam performansı

adType
Boyutu, reklam performansı raporlarında kullanılır ve istenen metrikleri video oynatma sırasında yayınlanan reklam türlerine göre toplar.adType 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'ni ziyaret edin.

  • auctionBumperInstream – Açık artırma yoluyla yerleştirilen ve videonun görüntülenebilmesi için izlenmesi gereken, 6 saniyeye kadar süren atlanamayan video reklamlardır.

  • auctionDisplay – Video oynatıcının alt kısmında yer paylaşımı olarak, video izleme sayfasında 300x250 boyutunda bir reklam birimi olarak veya her ikisinin kombinasyonu olarak görünen bir rich media ya da resim reklam. Yer paylaşımı çalıştırıldığında belirli bir süre gösterildikten sonra otomatik olarak kapanır. 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 videodan önce, video sırasında veya sonrasında yayınlanan atlanamayan video reklamlar.

  • auctionTrueviewInslate – İzleyici, bir videodan önce gösterilen seçenekler arasından bir video reklam seçer. See the TrueView documentation for more information.

  • auctionTrueviewInstream – Ana videodan önce veya ana video sırasında yayınlanan atlanabilir video reklamlar. Daha fazla bilgi için TrueView belgelerini inceleyin.

  • auctionUnknown – AdWords açık artırması üzerinden satın alınan ancak diğer reklam türlerinden birine sınıflandırılmamış bir reklam.

  • reservedBumperInstream – Bir videonun görüntülenebilmesi için izlenmesi gereken, 6 saniyeye kadar süren ve ayrılmış olarak satılan atlanamayan video reklamlar.

  • reservedClickToPlay – Kullanıcının oynatmayı başlatmak için tıklaması gereken bir video reklam. Kullanıcı oynatma işlemini başlatıp başlatmadığına bakılmaksızın, tıkla oynat reklam birimi her görüntülendiğinde bir reklam gösterimi kaydedilir. Bu reklamlar, ayrılmış olarak satılır.

  • reservedDisplay – Video oynatıcının alt kısmında yer paylaşımı olarak, video izleme sayfasında 300x250 boyutunda bir reklam birimi olarak veya her ikisinin kombinasyonu olarak görünen bir rich media ya da resim reklam. Yer paylaşımı çalıştırıldığında belirli bir süre gösterildikten sonra otomatik olarak kapanır. 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 videodan önce, video sırasında veya sonrasında yerleştirilen atlanamayan video reklamlar.

  • reservedInstreamSelect

  • reservedMasthead – Ana sayfada gösterilen, video ve grafik öğeleri içerebilen büyük bir reklam.

  • reservedUnknown – Ayrılmış olarak satılan ve diğer reklam türlerinden birine sınıflandırılamayan reklam.

  • unknown – YouTube bu reklam türünü sınıflandıramadı.

Ö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
      • Ülkeye özgü gelir ve reklam performansı metrikleri
      • İlk 10: En yüksek geliri sağlayan videolar
      • Farklı reklam türleri için reklam performansı metrikleri

  • İçerik sahibi örnekleri

    • Gelir/Reklamlar
      • Hak talebinde bulunulan içeriklerin gelir ve reklam performansı metrikleri
      • Günlük gelir ve reklam performansı metrikleri
      • Ülkeye özgü gelir ve reklam performansı metrikleri
      • İlk 10: En yüksek geliri sağlayan videolar
      • Farklı reklam türleri için reklam performansı metrikleri

İçerik sahibi boyutları

Aşağıdaki boyutlar yalnızca içerik sahibi raporlarında desteklenir.

Önemli: İçerik sahibinin raporlarını almak için yapılan API isteklerinde veriler aşağıdaki boyutlardan biri kullanılarak filtrelenmelidir:
  • video
  • channel
  • Aşağıda tanımlandığı şekilde claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonu.
claimedStatus (yalnızca içerik sahibi raporlarında kullanılır)
Bu boyut, bir API yanıtının yalnızca hak talebinde bulunulan içeriğe ait metrikleri içermesi gerektiğini belirtmenize olanak tanır. Bu boyut için geçerli tek değer claimed değeridir. filters parametresi sorguyu claimedStatus==claimed ile kısıtlıyorsa API yalnızca hak talebinde bulunulan içeriklerle ilgili verileri alır. uploaderType boyutunun tanımındaki tabloda, bu boyutun nasıl kullanılacağı hakkında daha ayrıntılı bilgi verilmektedir.
uploaderType (çekirdek 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 içeriklere ve/veya kullanıcı tarafından yüklenen videolar gibi üçüncü taraflarca yüklenen içeriklere ait metrikleri içerip içermemesi gerektiğini belirtmenize olanak tanır. Geçerli değerler self ve thirdParty'dir. Bu bir temel boyuttur ve Desteği Sonlandırma Politikası'na tabidir.

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

claimedStatus değer uploaderType değer Açıklama
[Ayarlanmadı] self İçerik sahibi tarafından yüklenen, hak talebinde bulunulan ve bulunulmayan içeriklerin YouTube Analytics verilerini alır.
hak iddia edilen [Ayarlanmadı] İçerik sahibi veya üçüncü taraf tarafından yüklenen ve hak talebinde bulunulan içeriklerin verilerini alır.
hak iddia edilen self İçerik sahibi tarafından yüklenen ve hak talebinde bulunulan içeriklerin verilerini alır.
hak iddia edilen thirdParty Üçüncü tarafça yüklenen ve hak talebinde bulunulan içeriklerin verilerini alır.

Örnekler

İçerik sahibi raporlarıyla ilgili örnek API isteklerinin çoğu, verileri filtrelemek için claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonunu kullanır.