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 (ör. 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ğini zamana göre alırken verilerin raporlanacağı dönemi seçersiniz: gün veya ay. Her rapordaki her veri satırında benzersiz bir boyut değeri kombinasyonu bulunur.

Sorgu raporu almak için YouTube Analytics API'nin reports.query yöntemini çağırın. YouTube'un raporlardaki metrik değerlerini hesaplamak için kullanacağı boyutları belirtmek üzere isteğinizde dimensions parametresini kullanın.

Temel boyutlar

YouTube Analytics API, Hizmet Şartları'nda tanımlanan Kullanımdan Kaldırma Politikası'na tabidir. Ancak temel olmayan boyutlar (ve temel olmayan metrikler) bu politikaya tabi değildir. Bu sayfada yer alan tanımlarda, temel boyut olan tüm boyutlar açıkça belirtilir.

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

Daha fazla bilgi için Desteği sonlandırılan API'ler politikasına tabi YouTube API'lerinin listesine göz atı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 kümesiyle eşleşen verileri içerecek şekilde sınırlarlar. Örneğin, tüm ülkelere ait kullanıcı etkinliği metriklerini almak yerine yalnızca belirli bir ülkeye ait verileri almak için filtre kullanabilirsiniz.

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 sahibi raporlarını almak için yapılan API isteklerinde, raporlama öğesi boyutlarından birini veya claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonunu kullanarak veriler 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ığı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 listesine ayarlayın. Parametre değeri en fazla 500 kimlik belirtebilir.

video (temel boyut)
YouTube videosunun kimliği. YouTube Data API'de bu, videokaynağının id özelliğinin değeridir. This is a core dimension and is subject to the Deprecation Policy.
playlist
YouTube oynatma listesinin kimliği. YouTube Data API'de bu, playlist kaynağının id mülkünün 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 mülkünün değeridir. This is a core dimension and is subject to the Deprecation Policy.

channel boyutu, genellikle birden fazla kanala ait verileri topladığından 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ı, ilgili gruptaki tüm videolar, oynatma listeleri veya kanallarla ilgili verileri içerir.

Örnekler

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

  • Kanal örnekleri

    • Temel istatistikler
      • İlk 10: Bir kanalın en çok izlenen videoları
      • İlk 10: Kanalın en çok görüntülenen videolarının ek açıklama tıklama oranları
      • Belirli bir oynatma listesinin istatistikleri
      • İlk 10: Bir kanalın en çok izlenen oynatma listeleri
    • Coğrafi
      • İlk 10: Belirli bir ülkede en çok izlenen videolar
      • İlk 10: Avrupa'da en çok izlenen videolar

  • İçerik sahibi örnekleri

    • Temel istatistikler
      • İlk 10: İçerik sahibinin en çok izlenen videoları
      • İlk 10: İçerik sahibinin 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ının ek açıklama tıklama oranları
      • En popüler 10: İçerik sahibinin en çok izlenen oynatma listeleri
    • Coğrafi
      • İlk 10: İçerik sahibinin Avrupa'da en çok izlenen videoları
      • En iyi 10: ABD'de en çok başlatılan oynatma listeleri

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. ZZ ülke kodu, YouTube'un ilişkili ülkeyi tanımlayamadığı 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şkili ABD eyaleti veya idari bölgesi. Boyut değeri, bir ABD eyaletini veya Washington D.C.'yi tanımlayan bir ISO 3166-2 kodudur (ör. US-MI (Michigan) veya US-TX (Teksas)). US-ZZ il kodu, YouTube'un ilişkili ABD eyaletini tanımlayamadığı metrikleri bildirmek için kullanılır. Bir API isteği, dimensions parametre değerine province içeriyorsa istek, filters parametre değerine country==US ekleyerek verileri Amerika Birleşik Devletleri ile sınırlamalıdır.

Not: Bu boyut, ABD'nin uzak bölgelerini tanımlayan ISO 3166-2 değerlerini desteklemez. Bu bölgelerin kendi ISO 3166-1 ülke kodları da vardır. ABD dışındaki ülkelerin alt bölümleri de desteklenmez.

dma
Veri satırında açıklanan görüntüleme etkinlikleriyle ilişkili Tanımlanmış Pazar Alanını (DMA) tanımlamak için Nielsen'in kullandığı 3 haneli tanımlayıcı.
city
Rapor satırındaki metriklerle ilişkili tahmini şehir. Bu boyuta ait veriler 1 Ocak 2022'den itibaren sağlanmaya başlamıştır.
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 (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 filters parametresinin değerini continent==REGION_CODE olarak ayarlayın ve tablodan bir REGION_CODE değeri belirtin.
subContinent (yalnızca filtre)
Coğrafi bir alt bölgeyi tanımlayan BM istatistik bölgesi kodu. Birleşmiş Milletler İstatistik Bölümü, alt bölgelerin yanı sıra 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
      • Kanalın videolarına ait ülkeye özel izlenme süresi metrikleri
      • Bir kanalın videolarına yönelik ülkeye özel ek açıklama metrikleri
      • ABD eyaletleri ve Washington D.C. için eyalete özel metrikler
      • Kanalın oynatma listeleri için ülkeye özel izlenme süresi metrikleri
      • En iyi 10: ABD'de en çok başlatılan oynatma listeleri
    • Oynatma konumu: Farklı oynatma konumlarından elde edilen günlük görüntüleme sayısı 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 izleyici demografisi (yaş grubu ve cinsiyet)
    • En iyi videolar
      • İlk 10: Belirli bir ülkede en çok izlenen videolar
      • İlk 10: Avrupa'da en çok izlenen videolar

  • İçerik sahibi örnekleri

    • Temel istatistikler: Kendi yüklediğiniz tüm videoların ülkeye özel görüntüleme sayıları ve daha fazlası
    • Coğrafi
      • Kullanıcı tarafından yüklenen içerikler için ülkeye özel izlenme süresi metrikleri
      • Kullanıcı tarafından yüklenen içerikler için ülkeye özel ek 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 iyi 10: ABD'de en çok başlatılan oynatma listeleri
    • Oynatma konumu: Farklı oynatma konumlarından elde edilen günlük görüntüleme sayısı ve izlenme süresi
    • Demografi: Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet)
    • En iyi videolar: Top 10 – İç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 gün, hafta veya ay gibi bir döneme göre topladığını gösterir. startDate ve endDate istek parametreleri, raporun veri içerdiği dönemi belirtir. Raporun aslında, sorgu oluşturulduğunda istekte belirtilen tüm metriklerin kullanılabildiği son güne kadar veri döndürdüğünü unutmayın. Raporlarda tarihler YYYY-MM-DD biçiminde listelenir.

Önemli: Tüm tarihler, Pasifik saati (UTC-7 veya UTC-8) ile belirtilen gün, ay ve yılda saat 00:00'da başlayıp saat 23:59'da sona eren dönemi ifade eder. Sonuç olarak, saatlerin yaz saati için ileri ayarlandığı tarihler 23 saatlik bir dönemi, saatlerin geri ayarlandığı tarihler ise 25 saatlik bir dönemi temsil eder.

Ay boyutu, belirtilen ay ve yılın ilk gününde Pasifik saatiyle 00:00'da (UTC-7 veya UTC-8) başlayan dönemi 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üne ait verileri içerir. Verileri daha da ayrıntılı bir şekilde incelemek için diğer boyutları kullanabilirsiniz. Örneğin, 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)
Rapordaki 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 kullanabilirsiniz. Raporda 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ı
      • Kanalın videolarına ait günlük izlenme süresi metrikleri
      • Bir kanalın videolarıyla ilgili günlük ek açıklama metrikleri
      • Bir kanalın oynatma listelerinin günlük görüntüleme sayısı
    • Oynatma konumu: Farklı oynatma konumlarından elde edilen 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çerik için ek açıklama metrikleri
      • İçerik sahibinin oynatma listesi görüntüleme sayısı (günlük)
    • Oynatma konumu: Farklı oynatma konumlarından elde edilen 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
Rapordaki veriler, video oynatma işlemlerinin gerçekleştiği sayfa veya uygulamanın türüne göre toplanır. Bu boyut için olası değerler:

  • BROWSE: Veriler, YouTube ana sayfasında veya ana ekranda, kullanıcının abonelik akışında ya da başka bir YouTube tarama ö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ştirilmesi 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şimi dışında bir yöntemle 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, YouTube'un mobil web sitesinde veya mobil cihazlar da dahil olmak üzere onaylanmış YouTube API istemcilerinde gerçekleşen görüntülemeleri açıklar.

    10 Eylül 2013'ten itibaren oynatma işlemleri, YouTube Analytics raporlarında MOBILE oynatma olarak sınıflandırılmıyor. Eski veriler bu kategorinin altında yer almaya devam ettiğ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 oynatmaları 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: Bu veriler, videonun YouTube izleme sayfasında veya YouTube Android uygulaması gibi resmi bir YouTube uygulamasında gerçekleşen görüntülemeleri gösterir.

  • YT_OTHER: Veriler, başka şekilde sınıflandırılmayan görünümleri 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üleme sağlayan yerleştirilmiş oynatıcıları tanımladığını unutmayın. Bu nedenle, en çok yerleştirilen oynatıcılarla ilişkili URL'leri veya uygulamaları tanımlayarak oynatma konumu raporundan daha ayrıntılı bir görünüm sunar.

Örnekler

Aşağıdaki örnek isteklerde oynatma konumu boyutları kullanılı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
      • İlk 10: Yerleştirilmiş bir video için en çok görüntüleme sağlayan üçüncü taraf siteler
      • Farklı oynatma konumlarından oynatma listesi görüntüleme sayıları ve izlenme süresi
      • Farklı oynatma konumlarından gelen oynatma listesi günlük 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
      • İlk 10: Yerleştirilmiş bir video için en çok görüntüleme sağlayan üçüncü taraf siteler
      • Farklı oynatma konumlarından oynatma listesi görüntüleme sayıları ve izlenme süresi
      • Farklı oynatma konumlarından gelen oynatma listesi günlük 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 boyuta ait veriler 1 Ocak 2019'dan itibaren geçerli tarihler için kullanılabilir.

Aşağıdaki tabloda boyut değerleri listelenmiştir:
Değerler
LIVE_STREAM İzlenen içerik YouTube canlı yayını idi.
SHORTS İzlenen içerik bir YouTube Shorts videosu olmalıdır.
STORY İzlenen içerik bir YouTube Hikayesi idi.
VIDEO_ON_DEMAND İzlenen içerik, diğer boyut değerlerinden birine girmeyen bir YouTube videosuydu.
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 bir canlı yayının görüntülemeleriyle ilişkili olup olmadığını belirtir. Bu boyutla ilgili veriler 1 Nisan 2014'ten itibaren 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 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ı belirtir. Olası değerler SUBSCRIBED ve UNSUBSCRIBED'dur.

Boyut değerinin, kullanıcı etkinliğinin gerçekleştiği andan itibaren 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 kanala abone olup aynı gün başka bir video izlediğini varsayalım. Kanalın raporunda, bir görüntülemenin subscribedStatus değerinin SUBSCRIBED, diğer görüntülemenin subscribedStatus değerinin UNSUBSCRIBED olduğu görülüyor.
youtubeProduct
Bu boyut, kullanıcı etkinliğinin gerçekleştiği YouTube hizmetini tanımlar. Bu boyuta ait veriler 18 Temmuz 2015'ten itibaren kullanılabilir.

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

Trafik kaynakları

insightTrafficSourceType
Rapordaki veriler, kullanıcıların videoya ulaşma şeklini tanımlayan yönlendiren türüne göre toplanır. Bu boyut için olası değerler:
  • ADVERTISING: İzleyici, videoya bir reklam aracılığıyla 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 bir notu tıklayarak videoya ulaşmıştır.
  • CAMPAIGN_CARD: İçerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulmuş, kullanıcı tarafından yüklenen videolardan gelen görüntüleme sayısıdı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 bir bağlantıdan yönlendirilmiştir. 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 video hashtag sayfalarından veya Shorts hashtag ana sayfalarından gelen görüntüleme sayısı.
  • LIVE_REDIRECT: Video görüntülemeleri canlı yönlendirmelerden yönlendirilmiştir.
  • NO_LINK_EMBEDDED: Video, görüntülendiğinde başka bir web sitesine yerleştirilmişti.
  • NO_LINK_OTHER: YouTube, trafik için yönlendiren tanımlamadı. Bu kategori, bir videoya yönelik doğrudan trafiğin yanı sıra mobil uygulamalardaki trafiği kapsar.
  • NOTIFICATION: Video görüntüleme sayısı, YouTube'dan gelen bir e-posta veya bildirim üzerinden yönlendirildi.
  • PLAYLIST: Video, oynatma listesi kapsamında oynatılırken izlendi. 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 "Ö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 bir video listelemesinden yönlendirilmiştir. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı, ilgili videonun video kimliğini belirtir.
  • SHORTS: İzleyici, Shorts izleme deneyiminde bir önceki videodan dikey olarak kaydırarak yönlendirildi.
  • SOUND_PAGE: Shorts ses pivot sayfalarından gelen görüntülemeler.
  • SUBSCRIBER: Video görüntülemeleri, YouTube ana sayfasındaki feed'lerden veya YouTube abonelik özelliklerinden yönlendirildi. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı, ana sayfa feed öğelerini veya görüntülemelerin yönlendirildiği 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ı, ilgili kanalın kanal kimliğini belirtir.
  • YT_OTHER_PAGE: Video görüntülemelerinin kaynağı, YouTube sayfasında görünen bir arama sonucu veya ilgili video bağlantısı dışındaki bir bağlantıdır. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı sayfayı tanımlar.
  • YT_SEARCH: Video görüntülemelerinin kaynağı YouTube arama sonuçlarıdır. 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 video bağlantısından yönlendirilmiştir. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı, izleyicinin yönlendirildiği videoyu belirtir.
insightTrafficSourceDetail
Rapordaki veriler, belirli bir video ve belirli bir trafik kaynağı türü için en çok görüntüleme sağlayan yönlendiricilere göre toplanır. Aşağıdaki listede, bu raporun kullanılabildiği trafik kaynakları belirtilmiştir. Liste, her trafik kaynağı için insightTrafficSourceDetail boyutunun sağladığı bilgileri tanımlar.
  • ADVERTISING: Görüntülemelerin elde edilmesine neden olan reklam türü. Olası değerler:
    • Tıkla ve oynat etkileşim reklamı
    • Etkileşim reklamı
    • Google Arama Ağı reklamları
    • Ana sayfa video reklamı
    • Atlanabilir yayın içi reklam alanı
    • Arama sonuçlarında ve görüntülü TrueView
    • Akışta TrueView (TrueView In-stream)
    • Kategorize edilmemiş YouTube reklamcılığı
    • Video duvarı
  • CAMPAIGN_CARD: İzleyicileri raporda tanımlanan videoya yönlendiren, hak talebinde bulunulan video.
  • END_SCREEN: İzleyicileri raporda tanımlanan videoya yönlendiren video.
  • EXT_URL: İzleyicileri videoya yönlendiren web sitesi.
  • HASHTAGS: Görüntülemelerin elde edilmesini sağlayan hashtag.
  • NOTIFICATION: Trafik yönlendiren e-posta veya bildirim.
  • RELATED_VIDEO: İzleyicileri raporda yer alan videoya yönlendiren ilgili video.
  • SOUND_PAGE: Görüntülemelerin elde edildiği video.
  • SUBSCRIBER: İzleyicileri raporda yer alan videoya yönlendiren ana sayfa feed öğesi veya YouTube abonelik özelliği. Geçerli değerler:
    • activity: Ana sayfa abonelik akışlarındaki öğelerden gelen görüntülemeler (beğeniler, favoriler, bülten gönderileri ve oynatma listesine eklemeler dahil olmak üzere yükleme ve sosyal medya dışı kanal etkinliklerinden kaynaklanan görüntülemeler).
    • blogged: Ana sayfa abonelik akışlarındaki öğelerin, en popüler bloglardaki bağlantılardan gelen görüntüleme sayısıdır.
    • mychannel: Ana sayfada listelenen diğer feed'lerdeki öğelerden (ör. "Beğenilenler", "İzleme Geçmişi" ve "Daha Sonra İzle") gelen görüntülemelerdir.
    • podcasts: Podcasts hedef sayfasındaki öğelerden gelen görüntülemeler.
    • sdig: Abonelik güncelleme e-postalarından gelen görüntüleme sayısı.
    • uploaded: Ana sayfa abonelik akışlarındaki uploaded öğelerin aldığı görüntüleme sayısıdır.
    • /: YouTube ana sayfasından gelen diğer görüntülemeler.
    • /my_subscriptions: Kullanıcıların YouTube'daki Aboneliklerim sayfalarından gelen görüntüleme sayısı.
  • 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ülemelerin elde edildiği video.

Örnekler

Aşağıdaki örnek isteklerde trafik kaynağı boyutları kullanılı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ıları ve izlenme süresi
      • İlk 10: Bir videoya en çok trafik getiren YouTube arama terimleri
      • İlk 10: Bir video için en fazla trafik oluşturan 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 oynatma listesi günlük görüntüleme sayısı ve izlenme süresi

  • İçerik sahibi örnekleri

    • Trafik kaynağı
      • Farklı trafik kaynaklarından görüntüleme sayısı ve izlenme süresi
      • Farklı trafik kaynaklarından gelen günlük görüntüleme sayıları ve izlenme süresi
      • İlk 10: Bir videoya en çok trafik getiren YouTube arama terimleri
      • İlk 10: Bir video için en fazla trafik oluşturan 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 oynatma listesi günlük 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 listede, API'nin veri döndürdüğü cihaz türleri tanımlanmaktadır. Bir işletim sistemi raporunu yalnızca belirli bir cihaz türüyle ilgili verileri içerecek şekilde kısıtlamak için deviceType boyutunu filtre olarak da 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 listede, API'nin veri döndürdüğü işletim sistemleri tanımlanmaktadır. Bir cihaz türü raporunu yalnızca belirli bir işletim sistemine ait verileri içerecek şekilde kısıtlamak için operatingSystem'ü 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üleme sayısına göre 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üleme sayısına göre günlük işletim sistemi metrikleri

Demografi

Demografi boyutları, kitlenizin yaş aralığını ve cinsiyet dağılımını anlamanıza yardımcı olur. YouTube Analytics raporlarındaki demografik veriler hakkında daha fazla bilgiyi YouTube Yardım Merkezi'nde 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 (temel 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 izleyici demografisi (yaş grubu ve cinsiyet)
      • Kaliforniya'daki oynatma listesi izleyicilerinin demografisi (yaş grubu ve cinsiyet)

  • İçerik sahibi örnekleri

    • Demografi
      • Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet)
      • Kaliforniya'daki oynatma listesi izleyicilerinin demografisi (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ında) 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 Mesajlar 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 Gelen Kutusu INBOX
iOS Sistem Etkinliği İletişim Kutusu IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
Kik KIK
LGE E-postası LGE_EMAIL
Çizgi LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
menéame MENEAME
mixi MIXI
Motorola Mesajlaşma 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 dokümanlarını inceleyin.

Örnekler

Aşağıdaki örnek isteklerde sosyal boyutlar kullanılır:

  • Kanal örnekleri

    • Sosyal: Videoların paylaşıldığı hizmete göre toplanmış paylaşım metrikleri

  • İçerik sahibi örnekleri

    • Sosyal: Videoların paylaşıldığı hizmete göre toplanmış paylaşım metrikleri

Kitleyi elde tutma

elapsedVideoTimeRatio
Bu boyut, videonun izlenen kısmının videonun uzunluğuna oranını belirtir. Elde tutma boyutları ve metrikleri, zaman içindeki kitle 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'ı geçtikten sonra elde edilen saklama verilerini gösterdiğini belirtir.

API, her video için 0.01 ile 1.0 arasında değişen oran değerlerine sahip 100 veri noktası döndürür. Video oynatmaları sırasında verilerin ölçüldüğü zamanlar her video için eşit aralıklarla belirlenir. 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 hariç bitişini gösterir.
audienceType (yalnızca filtre)
Boyut değeri, rapor verileriyle ilişkili trafik türünü tanımlar. Desteklenen değerler ORGANIC, AD_INSTREAM ve AD_INDISPLAY'dir. Bu trafik kaynağı türlerinin açıklamaları için YouTube Yardım Merkezi'ni inceleyin.

audienceType filtresine ait verilerin 25 Eylül 2013'ten itibaren kullanılabileceğini unutmayın. API, daha önceki tarihlere ait verileri almaya çalışmak için filtreyi kullanan sorgular için veri döndürmez. Filtreyi kullanmayan sorgular 1 Temmuz 2008'den sonraki tüm tarihler için çalışır.

Örnekler

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

Canlı yayın

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

Üyelik iptalleri

membershipsCancellationSurveyReason
Raporlama döneminde belirtilen kanalın kanal üyeliğini iptal eden YouTube kullanıcılarının doldurduğu 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ı, üyelik avantajlarının kendisine sunulmadığını belirtti.
CANNOT_ACCESS_PERKS Kullanıcı ayrıcalıklara 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üyordu.
FINANCIAL_REASONS Kullanıcı, finansal nedenlerle iptal etti.
JOIN_LIMITED_TIME Kullanıcı yalnızca sınırlı bir süreliğine katılmak istemişti.
OTHER Kullanıcının iptal için başka bir nedeni vardı.

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'ni ziyaret edin.

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

  • auctionDisplay: Video oynatıcının alt kısmında yer paylaşımı olarak, video izleme sayfasında 300x250 reklam birimi olarak veya her ikisinin bir kombinasyonu olarak görünen bir rich media veya resim reklam. Yer paylaşımı, belirli bir süre gösterildikten sonra otomatik olarak kapanır. Kullanıcı da yer paylaşımını kapatabilir. Bir yer paylaşımı ve banner birlikte gösterilirse her reklam ayrı bir gösterim olarak sayılır.

  • auctionInstream: Ana videodan önce, video sırasında veya videodan sonra yayınlanan atlanamayan video reklamlar.

  • 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ınan ancak diğer reklam türlerinden birine sınıflandırılmamış bir reklam.

  • reservedBumperInstream: Videonun görüntülenebilmesi için 6 saniyeye kadar süren ve rezervasyonla satılan atlanamayan video reklamların izlenmesi gerekir.

  • reservedClickToPlay: Kullanıcının oynatmayı başlatmak için tıklaması gereken bir video reklam. Tıkla oynat reklam biriminin her gösterilişinde, kullanıcının oynatma işlemi başlatıp başlatmadığına bakılmaksızın bir reklam gösterimi kaydedilir. Bu ürünler rezervasyona dayalı olarak satılır.

  • reservedDisplay: Video oynatıcının alt kısmında yer paylaşımı olarak, video izleme sayfasında 300x250 reklam birimi olarak veya her ikisinin bir kombinasyonu olarak görünen bir rich media veya resim reklam. Yer paylaşımı, belirli bir süre gösterildikten sonra otomatik olarak kapanır. Kullanıcı da yer paylaşımını kapatabilir. Bir yer paylaşımı ve banner birlikte gösterilirse her reklam ayrı bir gösterim olarak sayılır.

  • reservedInstream: Ana videodan önce, video sırasında veya videodan sonra yerleştirilen atlanamayan video reklamlar.

  • reservedInstreamSelect

  • reservedMasthead: Ana sayfada gösterilen, video ve grafik öğeleri içerebilen büyük bir reklamdır.

  • reservedUnknown: Rezerve olarak satılan ve diğer reklam türlerinden birine sınıflandırılamayan bir 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çerikler için 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ı için desteklenir.

Önemli: İçerik sahibi 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. filters parametresi sorguyu claimedStatus==claimed ile kısıtlarsa API yalnızca hak talebinde bulunulan içerikle ilgili verileri alır. uploaderType boyutunun tanımındaki tabloda, bu boyutun nasıl kullanılacağı hakkında daha fazla bilgi verilmektedir.
uploaderType (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 içerik ve/veya üçüncü taraflarca yüklenen içerik (ör. kullanıcı tarafından yüklenen videolar) metriklerini içermesi gerekip gerekmediğini belirtmenize olanak tanır. Geçerli değerler self ve thirdParty'dir. Bu temel bir boyuttur ve Desteklenmesi Durdurulan Politika'ya 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ı] self İçerik sahibi tarafından yüklenen hak talebinde bulunulan ve hak talebinde bulunulmayan içeriklerle ilgili YouTube Analytics verilerini alır.
hak iddia edilen [Ayarlanmadı] İçerik sahibi veya üçüncü taraf tarafından yüklenen hak talebinde bulunulan içeriklerle ilgili verileri alır.
hak iddia edilen self İçerik sahibi tarafından yüklenen hak talebinde bulunulan içeriklerle ilgili verileri alır.
hak iddia edilen thirdParty Üçüncü tarafça yüklenen hak talebinde bulunulan içeriklerle ilgili verileri alır.

Örnekler

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