Dimensions

Bu belge, YouTube Analytics API'nin desteklediği boyutları tanımlar. Bu API, özel YouTube Analytics raporları oluşturmak için gerçek zamanlı, hedeflenmiş sorguları destekler.

Boyutlar, verileri birleştirmek için kullanılan yaygın ö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, zamana göre kullanıcı etkinliği alırken verilerin raporlanacağı dönemi seçersiniz: gün veya ay. Tüm raporlarda, her veri satırı benzersiz bir boyut değerleri kombinasyonuna sahiptir.

Bir 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, temel olmayan boyutlar (ve temel olmayan metrikler) politikaya tabidir. Bu sayfadaki tanımlarda temel boyut olan her boyut bu şekilde açıkça tanımlanmıştır.

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'leri listesini inceleyin.

Filtreler

Tüm sorgu raporları filtreleri destekler. Filtreler, alınan veri kümesinde bulunması gereken boyut değerlerini tanımlar. Bu nedenle, API yanıtları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 ülkelere ait kullanıcı etkinliği metriklerini almak yerine, yalnızca belirli bir ülkeye ilişkin verileri almak için filtre kullanabilirsiniz.

Sorgu raporu alma isteğinde, isteğe bağlı filters istek parametresi, verileri 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 gönderilen API istekleri, verileri raporlama öğesi boyutlarından birini veya claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonunu kullanarak filtrelemelidir.

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ğidir. YouTube Data API'de bu, video değeridir kaynağının id özelliği. This is a core dimension and is subject to the Deprecation Policy.
oynatma listesi
YouTube oynatma listesinin kimliği. YouTube Data API'de bu, bir 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ği. YouTube Data API'de bu, bir channel kaynağının id özelliğinin değeridir. This is a core dimension and is subject to the Deprecation Policy..

channel boyutu, bu raporlar genellikle birden fazla kanala ait verileri birleştirdiği için içerik sahibi raporlarında sıklıkla kullanılır.
grup (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, oynatma listeleri veya kanallara ilişkin verileri içerir.

Örnekler

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

  • Kanal örnekleri

    • Temel istatistikler
      • İlk 10 - Kanalda en çok izlenen video
      • İlk 10 – Bir kanalın en çok görüntülenen videoları için ek açıklama tıklama oranları
      • Belirli bir oynatma listesiyle ilgili istatistikler
      • İlk 10: Kanalın en çok izlenen oynatma listesi
    • Coğrafi
      • İlk 10 - Belirli bir ülkede en çok görüntülenen video
      • Avrupa'da en çok görüntülenen ilk 10 video

  • İçerik sahibi örnekleri

    • Temel istatistikler
      • İlk 10: İçerik sahibi için en çok görüntülenen video
      • İlk 10: İçerik sahipleri için en çok izlenen video
      • İlk 10 - İçerik sahibinin kanalı için en çok görüntülenen video
      • İlk 10 – Bir kanalın en çok görüntülenen videoları için ek açıklama tıklama oranları
      • İlk 10: İçerik sahipleri için en çok izlenen oynatma listeleri
    • Coğrafi
      • İlk 10 - İçerik sahipleri için Avrupa'da en çok izlenen video
      • İlk 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 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şkilendirilen ülkeyi tanımlayamadığı metrikleri raporlamak 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 bölgesi. Boyut değeri, bir ABD eyaletini veya District of Columbia'yı (US-MI (Michigan) veya US-TX (Teksas) gibi) tanımlayan bir ISO 3166-2 kodudur. 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ğerinde province içerdiğinde, isteğin filters parametre değerine country==US eklenerek verileri de ABD ile sınırlaması gerekir.

Not: Bu boyut, ABD'ye bağlı dış bölgeleri tanımlayan ISO 3166-2 değerlerini desteklemez. Çünkü bu bölgelerin kendi ISO 3166-1 ülke kodları vardır. Ayrıca, ABD dışındaki ülkelerin alt bölümlerini de desteklemez.

dma
Nielsen'in Tanımlanmış Pazar Alanı'nı (TPA) tanımlamak için kullandığı 3 haneli tanımlayıcı. , veri satırında açıklanan görüntüleme etkinlikleriyle ilişkilidir.
city
Rapor satırındaki metriklerle ilişkili tahmini şehir. Bu boyutla ilgili veriler, 1 Ocak 2022'den sonraki tarihler için kullanılabilir.
kıta (yalnızca filtre)
. Birleşmiş Milletler (BM) istatistiksel bölge kodudur. 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 parametresini continent==REGION_CODE, tablodan bir REGION_CODE değeri belirtir.
subContinent (yalnızca filtre)
. Bir coğrafi alt bölgeyi tanımlayan 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 UN 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 özgü izlenme sayısı (ve daha fazlası)
    • Coğrafi
      • Kanalın videoları için ülkeye özgü izlenme süresi metrikleri
      • Bir kanalın videoları için ülkeye özgü ek açıklama metrikleri
      • ABD eyaletleri ve Washington D.C. için eyalete özgü metrikler
      • Kanalın oynatma listeleri için ülkeye özel izlenme süresi metrikleri
      • İlk 10: ABD'de en çok başlatılan oynatma listeleri
    • Oynatma konumu: Farklı oynatma konumlarındaki günlük izlenme sayısı ve izlenme süresi
    • Trafik kaynağı: Bir ülkedeki farklı trafik kaynaklarından gelen görüntüleme sayıları ve izlenme süresi
    • Demografi: Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet)
    • En popüler videolar
      • İlk 10 - Belirli bir ülkede en çok görüntülenen video
      • Avrupa'da en çok görüntülenen ilk 10 video

  • İçerik sahibi örnekleri

    • Temel istatistikler: Kendi yüklediğiniz tüm videoların ülkeye özel izlenme sayısı (ve daha fazlası)
    • Coğrafi
      • Kendi yüklediğiniz içerikler için ülkeye özel izlenme süresi metrikleri
      • Kendi yüklediğiniz içerikler için ülkeye özgü ek açıklama metrikleri
      • ABD eyaletleri ve Washington D.C. için eyalete özgü metrikler
      • İçerik sahibinin oynatma listeleri için ülkeye özgü izlenme süresi metrikleri
      • İlk 10: ABD'de en çok başlatılan oynatma listeleri
    • Oynatma konumu: Farklı oynatma konumlarındaki günlük izlenme sayısı ve izlenme süresi
    • Demografi: Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet)
    • En popüler videolar: İlk 10: İçerik sahibi 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, bir hafta veya ay gibi bir zaman aralığına dayalı olarak toplaması gerektiğini gösterir. startDate ve endDate istek parametreleri, raporun veri içerdiği dönemi belirtir. Raporun gerçekte, sorgunun yapıldığı sırada 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, belirtilen gün, ay ve yılda Pasifik saatine göre 00:00'da (UTC-7 veya UTC-8) başlayıp 23:59'da sona eren dönemi ifade eder. Dolayısıyla, 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.

month boyutu, belirtilen ayın ve yılın ilk gününde Pasifik saatine göre 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ırda bir güne ait veriler yer alır. Verilerin daha da ayrıntılı bir dökümünü almak isterseniz diğer boyutları kullanabilirsiniz. Örneğin bir trafik kaynağı raporu, kullanıcıların videolarınıza erişme şekline dayalı olarak 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 fazla segmentlere ayırmak için diğer filtreleri kullanabilirsiniz. Raporda tarihler YYYY-MM biçiminde listelenir.

Not: API sorgunuzda month boyutu kullanılıyorsa start-date ve end-date parametreleri 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, zamansal boyutlar veya filtreler kullanır:

  • Kanal örnekleri

    • Zamana dayalı
      • Kanalın videoları için günlük izlenme süresi metrikleri
      • Bir kanalın videolarına ait 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 izlenme sayısı 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çeriklerin 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 izlenme sayısı 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 videolara ait 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 uygulamayla ilgili analizler sağlar.

insightPlaybackLocationType
. Rapordaki veriler, video oynatmalarının gerçekleştiği 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 göz atma özelliğinde gerçekleşen görüntülemeleri açıklar.

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

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

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

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

    10 Eylül 2013 itibarıyla oynatmalar, YouTube Analytics raporlarında artık MOBILE oynatma olarak kategorize edilmemektedir. Eski veriler hâlâ bu kategorinin kapsamında olduğundan söz konusu değer raporlarda kalabilir. Ancak bu tarihten itibaren 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üntülemeleri açıklar.

insightPlaybackLocationDetail
Veriler, oynatıcının bulunduğu sayfaya göre toplanır. Bu raporun yalnızca yerleşik oynatıcılarda gerçekleşen görüntülemeler için desteklendiğini ve belirtilen bir video için en fazla görüntülemeyi oluşturan yerleşik oynatıcıları tanımladığını unutmayın. Bu nedenle, en çok yerleştirilmiş oynatıcılarla ilişkili URL'leri veya uygulamaları tanımlayarak oynatma konumu raporundan 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ındaki görüntüleme sayıları ve izlenme süresi
      • Farklı oynatma konumlarında günlük izlenme sayısı ve izlenme süresi
      • İlk 10: Yerleştirilmiş bir video için en fazla görüntülemeyi sağlayan üçüncü taraf siteler
      • Oynatma listesi görüntüleme sayıları ve farklı oynatma konumlarındaki izlenme süreleri
      • Oynatma listesinin günlük izlenme sayısı ve farklı oynatma konumlarındaki izlenme süresi

  • İçerik sahibi örnekleri

    • Oynatma konumu
      • Farklı oynatma konumlarındaki görüntüleme sayıları ve izlenme süresi
      • Farklı oynatma konumlarında günlük izlenme sayısı ve izlenme süresi
      • İlk 10: Yerleştirilmiş bir video için en fazla görüntülemeyi sağlayan üçüncü taraf siteler
      • Oynatma listesi görüntüleme sayıları ve farklı oynatma konumlarındaki izlenme süreleri
      • Oynatma listesinin günlük izlenme sayısı ve farklı oynatma konumlarındaki izlenme süresi

Oynatma ayrıntıları

creatorContentType
Bu boyut, veri satırındaki kullanıcı etkinliği metrikleriyle ilişkilendirilmiş içerik türünü tanımlar. Bu boyutla ilgili veriler 1 Ocak 2019'dan itibaren geçerli olan tarihler için kullanılabilir.

Aşağıdaki tabloda boyut değerleri listelenmektedir:
Değerler
LIVE_STREAM Görüntülenen içerik bir YouTube canlı yayınıysa.
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 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ın görüntülemeleriyle ilişkilendirilip ilişkilendirilmediğini gösterir. Bu boyutla ilgili veriler 1 Nisan 2014'ten sonraki tarihler için kullanılabilir.

Aşağıdaki tabloda boyut değerleri listelenmektedir:
Değerler
LIVE Satırın verileri, 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ş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.

Boyut değerinin, kullanıcı etkinliğinin gerçekleştiği anda doğru olduğunu unutmayın. Örneğin, bir kullanıcının kanala abone olmadığını ve kanaldaki videolardan birini izlediğini, ardından yine 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ünümün ise 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 itibarıyla 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şmemiş kullanıcı etkinliği. İstisna: YouTube Music'te 1 Mart 2021'den önce gerçekleşen kullanıcı etkinlikleri CORE metriğine dahil edilir.
GAMING YouTube Gaming'de kullanıcı etkinliği 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şmiştir. 1 Mart 2021'den önceki veriler CORE bölümüne dahil edilir. Gerçek zamanlı veriler kaydedilmez.
UNKNOWN Kullanıcı etkinliği 18 Temmuz 2015'ten önce gerçekleşmiştir.

Trafik kaynakları

insightTrafficSourceType
Rapordaki veriler, kullanıcıların videoya erişme şeklini açıklayan yönlendiren türüne göre toplanır. Bu boyut için olası değerler şunlardır:
  • ADVERTISING: İzleyici, videoya bir reklam aracılığıyla yönlendirilmiştir. 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 erişti.
  • CAMPAIGN_CARD – İçerik sahibinin görüntülenen içeriği tanıtmak için kullandığı, hak talebinde bulunulan, kullanıcı tarafından yüklenen videolardan kaynaklanan görüntülemelerdir. Bu trafik kaynağı yalnızca içerik sahibi raporları için desteklenir.
  • END_SCREEN: İzlenme sayısı, 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 hashtag sayfalarından veya Shorts hashtag pivot sayfalarından gelen görüntülemelerdir.
  • LIVE_REDIRECT - Video görüntülemeleri Live Redirects'ten yönlendirildi.
  • NO_LINK_EMBEDDED – Video, görüntülendiğinde başka bir web sitesine yerleştirilmiştir.
  • NO_LINK_OTHER – YouTube, trafik için bir yönlendiren tanımlamadı. Bu kategori, bir videoya gelen doğrudan trafiği ve mobil uygulamalardaki trafiği kapsar.
  • NOTIFICATION – Video görüntülemeleri, YouTube'dan gelen bir e-posta veya bildirimden yönlendirilmiştir.
  • PLAYLIST – Video görüntülemeleri, video bir oynatma listesinin parçası olarak oynatıldığı sırada gerçekleşti. 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" gibi ücretsiz bir YouTube tanıtımından yönlendirilmiştir. sayfasını ziyaret edin.
  • RELATED_VIDEO – Video görüntülemeleri, başka bir video izleme sayfasındaki ilgili bir video girişinden yönlendirilmiştir. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanında ilgili videonun video kimliği belirtilir.
  • SHORTS: İzleyici, Shorts görüntüleme deneyiminde önceki videodan dikey olarak kaydırılarak yönlendirildi.
  • SOUND_PAGE – Shorts'taki ses pivot sayfalarından elde edilen görüntülemelerdir.
  • SUBSCRIBER – Video görüntülemeleri, YouTube ana sayfasındaki feed'lerden 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 öğelerini veya diğer sayfayı belirtir.
  • YT_CHANNEL – Video görüntülemeleri bir kanal sayfasında gerçekleşmiştir. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanında söz konusu kanalın kanal kimliği belirtilir.
  • YT_OTHER_PAGE – Video görüntülemeleri, arama sonucu veya bir YouTube sayfasında görünen 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ında arama terimi belirtilir.
  • VIDEO_REMIXES – Video görüntülemeleri, Shorts video oynatıcısındaki remikslenmiş video bağlantısından alındı. 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 fazla görüntülemeyi oluşturan yönlendirenlere göre toplanır. Aşağıdaki listede, bu raporun kullanılabileceği trafik kaynakları tanımlanmaktadır. Liste, her trafik kaynağı için insightTrafficSourceDetail boyutunun sağladığı bilgileri tanımlar.
  • ADVERTISING: Görüntülemelere yol açan reklamın tü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 reklam
    • Arama Sonuçlarında TrueView (TrueView In-search) ve Görüntülü TrueView (TrueView In-display)
    • Akışta TrueView (TrueView In-stream)
    • Kategorize edilmemiş YouTube reklamcılığı
    • Video duvarı
  • CAMPAIGN_CARD: İzleyicileri raporda belirtilen videoya yönlendiren, hak talebinde bulunulan videodur.
  • END_SCREEN: İzleyicileri raporda belirtilen videoya yönlendiren video.
  • EXT_URL: İzleyicileri videoya yönlendiren web sitesidir.
  • HASHTAGS: Görüntülenmeyi sağlayan hashtag.
  • NOTIFICATION: Trafik yönlendiren e-posta veya bildirim.
  • RELATED_VIDEO: İzleyicileri raporda bahsedilen videoya yönlendiren ilgili video.
  • SOUND_PAGE: Videonun izlenmesini sağlayan videodur.
  • SUBSCRIBER: İzleyicileri raporda bahsedilen videoya yönlendiren ana sayfa feed öğesi veya YouTube abonelik özelliği. Geçerli değerler şunlardır:
    • activity – Ana sayfa abonelik feed'lerindeki öğelerin, yüklenmeyen ve sosyal kanal dışı etkinliklerden (beğeniler, favoriler, bülten yayınları ve oynatma listesine eklemeler dahil) neden olduğu görüntülemeler.
    • blogged – Ana sayfa abonelik feed'lerindeki öğelerin, en popüler bloglardaki bağlantılardan kaynaklanan görüntülemeler.
    • mychannel – Ana sayfada listelenen diğer feed'lerdeki "Beğenilenler", "İzleme Geçmişi," ve "Daha Sonra İzle"yi seçin.
    • podcasts – Podcasts hedef sayfasındaki öğelerden gelen görüntülemeler.
    • sdig – Abonelik güncelleme e-postalarından kaynaklanan görüntülemeler.
    • uploaded – Ana sayfa abonelik feed'lerindeki uploaded öğeden gelen görüntülemelerdir.
    • / – YouTube ana sayfasından gelen diğer görüntülemeler.
    • /my_subscriptions – Kullanıcıların kaynağı olan görüntülemeler YouTube'daki Aboneliklerim sayfaları.
  • YT_CHANNEL: İzleyicilerin videoyu izlediği kanal sayfasıdır.
  • YT_OTHER_PAGE: İzleyicilerin videoya yönlendirildiği YouTube sayfasıdır.
  • 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ıları 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 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 gelen 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ıları 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 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 gelen 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. İşletim sistemi raporunu yalnızca belirli bir cihaz türüne ait 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 sistemine ait verileri 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 sistemindeki oynatma listesi görüntülemeleriyle ilgili 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 videolara ait 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ülemeleriyle ilgili 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, YouTube Analytics raporlarındaki demografik veriler hakkında ek bilgiler içerir.

ageGroup (temel boyut)
Bu boyut, rapor verileriyle ilişkilendirilmiş 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ş oturum açmış kullanıcıların cinsiyetini tanımlar. Geçerli değerler female, male ve user_specified değerleridir. 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'daki oynatma listesi izleyici demografisi (yaş grubu ve cinsiyet)

  • İçerik sahibi örnekleri

    • Demografi
      • Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet)
      • Kaliforniya'daki oynatma listesi izleyici 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ş" seçeneği kullanılarak YouTube'da (veya YouTube oynatıcısı aracılığıyla) paylaşılabilir düğmesini tıklayın.
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 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ştir 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 Mesajlaşma MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Yakındakilerle Paylaş NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (ılarak içeriklerinin ana güncellemelerinin paylaşıldığı) ODNOKLASSNIKI
Diğer OTHER
Pinterest PINTEREST
Rakuten (楽天webstore場) RAKUTEN
reddit REDDIT
Skype SKYPE
Skyrock SKYBLOG
Sony Görüşmeleri 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
Vo 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ına göz atın.

Ö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 ölçümü 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 tutma 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çülme zamanı, her video için eşit aralıkla gösterilir. 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 trafiğin 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 filtresi verilerinin 25 Eylül 2013'ten itibaren kullanılabileceğini unutmayın. API, önceki tarihlere ait verileri almaya çalışmak için filtreyi kullanan sorgulara ait verileri döndürmez. Bu 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:

Canlı yayın

livestreamPosition
Bu boyut, canlı video yayını sırasındaki belirli bir dakikayı belirtir. Rapor metrikleri O anda canlı yayını kaç kullanıcının izlediğini gösterir.

Üyelik iptalleri

membershipsCancellationSurveyReason
Şu kanal için kanal üyeliklerini iptal eden YouTube kullanıcılarının tamamladığı anketlerin sayısı: raporlama döneminde belirtilen kanala bağlı olarak 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ı, taahhüt ettiği üyelik ayrıcalıklarının sunulmadığını söyledi.
CANNOT_ACCESS_PERKS Kullanıcı, ayrıcalıklara erişemedi.
NO_LONGER_INTERESTED Kullanıcı artık kanal üyeliğiyle ilgilenmiyordur.
FEEL_UNAPPRECIATED Kullanıcı, bir kanal üyesi olarak kendisine değer verilmediğini hissetmiştir.
FINANCIAL_REASONS Kullanıcı, finansal nedenlerle iptal etti.
JOIN_LIMITED_TIME Kullanıcı yalnızca sınırlı bir süre için katılmak istemiştir.
OTHER Kullanıcının iptal etmek için başka bir nedeni daha var.

Reklam performansı

adType
adType boyutu, reklam performans raporlarında kullanılır ve video oynatma sırasında yayınlanan reklam türlerine dayalı olarak istenen metrikleri 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 göz atın.

  • auctionBumperInstream – Açık artırmayla yerleştirilen, en fazla 6 saniye süren, videonun görüntülenebilmesi için izlenmesi gereken atlanamayan video reklamlardır.

  • auctionDisplay – Video oynatıcının altında bir yer paylaşımı, video izleme sayfasında 300x250 boyutlu bir reklam birimi veya her ikisinin kombinasyonu olarak görünen bir rich media veya resim reklam. Yer paylaşımı çalıştığında, belirli bir süre görüntülendikten sonra otomatik olarak kapanır ve kullanıcı yer paylaşımını da kapatabilir. Bir yer paylaşımı ve bir banner birlikte gösterilirse her bir reklam ayrı bir gösterim olarak sayılır.

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

  • auctionTrueviewInslate – İzleyici, videodan önce gösterilen çeşitli 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: Ayrılmış esaslı olarak satılan atlanamayan video reklamlar. Videonun görüntülenebilmesi için en fazla 6 saniye süren bu reklamların izlenmesi gerekir.

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

  • reservedDisplay – Video oynatıcının altında bir yer paylaşımı, video izleme sayfasında 300x250 boyutlu bir reklam birimi veya her ikisinin kombinasyonu olarak görünen bir rich media veya resim reklam. Yer paylaşımı çalıştığında, belirli bir süre görüntülendikten sonra otomatik olarak kapanır ve kullanıcı yer paylaşımını da kapatabilir. Bir yer paylaşımı ve bir banner birlikte gösterilirse her bir reklam ayrı bir gösterim olarak sayılır.

  • reservedInstream – Ana videonun öncesinde, oynatılması sırasında ve sonrasında eklenen, atlanamayan video reklamlardır.

  • reservedInstreamSelect

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

  • reservedUnknown – Ayrılmış esaslı olarak satılan ve diğer reklam türlerinden birinde 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 gelire sahip 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 gelire sahip videolar
      • Farklı reklam türleri için reklam performansı metrikleri

Oynatma listeleri

isCurated (yalnızca filtre)
Bu filtre, isteğin oynatma listesi bağlamını düşünün.

Ö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 kullanılan API istekleri, verileri aşağıdaki boyutlardan biri kullanarak filtrelemelidir:
  • video
  • channel
  • Aşağıda tanımlandığı gibi, claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonu.
hak talebinde bulunulan durum (yalnızca içerik sahibi raporlarında kullanılır)
Bu boyut, API yanıtı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 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 tablo, bu boyutun nasıl kullanılacağı hakkında daha fazla ayrıntı sağlar.
yükleyiciType (temel boyut) (yalnızca içerik sahibi raporlarında kullanılır)
Bu boyut, API yanıtlarının belirtilen içerik sahibi tarafından yüklenen içeriklerle veya/veya üçüncü taraflarca yüklenen içeriklerle (ör. kullanıcı tarafından yüklenen videolar) ilgili metrikleri içerip içermeyeceğini belirtmenizi sağlar. Geçerli değerler self ve thirdParty değerleridir. Bu, temel bir boyuttur ve Kullanımdan Kaldı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ı] kendisi İçerik sahibi tarafından yüklenen, hak talebinde bulunulmuş ve bulunulmamış içeriğe ilişkin YouTube Analytics verilerini alır.
hak iddia edilen [Ayarlanmadı] İçerik sahibi veya üçüncü bir tarafın yüklediği, hak talebinde bulunulan içerikle ilgili verileri alır.
hak iddia edilen kendisi İçerik sahibi tarafından yüklenen, hak talebinde bulunulan içerikle ilgili verileri alır.
hak iddia edilen thirdParty Üçüncü tarafın yüklediği, hak talebinde bulunulan içerikle 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.