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 birleştirmek 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. Herhangi bir raporda, her veri satırı benzersiz bir boyut değerleri kombinasyonuna sahiptir.

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 bu şekilde tanımlanır.

Aşağıdaki listede API'nin temel boyutları belirtilmiştir.

Daha fazla bilgi için Kullanımdan Kaldırma Politikası'na tabi YouTube API'lerinin listesine bakın.

Filtreler

Tüm sorgu raporları filtreleri destekler. Filtreler, alınan veri kümesinde bulunması gereken boyut değerlerini tanımlar. Bu nedenle, API yanıtını yalnızca belirli bir değer veya değer grubuyla eşleşen verileri içerecek şekilde sınırlandırırlar. Örneğin, tüm ülkeler için kullanıcı etkinliği metriklerini almak yerine, yalnızca belirli bir ülkeye ait 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 için kullanıcı etkinliği metriklerini almak istiyorsanız filters parametre değerini continent==150 olarak ayarlarsınız.

Önemli: İçerik sahibi raporlarını almak için yapılan API istekleri, raporlama tüzel kişisi boyutlarından birini veya claimedStatus ve uploaderType boyutlarının desteklenen bir kombinasyonunu kullanarak verileri filtrelemelidir.

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. Bunun için filters parametre değerini, API yanıtının filtrelenmesi gereken video, oynatma listesi veya kanal kimliklerinin virgülle ayrılmış listesi olarak ayarlayın. Parametre değeri en fazla 500 kimlik belirtebilir.

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

channel boyutu, içerik sahibi raporlarında sıklıkla kullanılır. Bunun nedeni, bu raporların genellikle birden fazla kanala ait verileri birleştirmesidir.
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 tüzel kişisi boyutları veya filtreleri kullanılır:

  • Kanal örnekleri

    • Temel istatistikler
      • İlk 10: Bir kanalın en çok izlenen videoları
      • İlk 10: Bir kanalın en çok görüntülenen videolarının ek açıklama tıklama oranları
      • Belirli bir oynatma listesiyle ilgili istatistikler
      • İ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 görüntülenen videoları
      • İlk 10 - İçerik sahibinin en çok izlenen videoları
      • İlk 10: İç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ı
      • İlk 10: İçerik sahibinin en çok izlenen oynatma listeleri
    • Coğrafi
      • İlk 10: Bir içerik sahibinin Avrupa'da en çok izlenen videoları
      • İ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 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ığı raporlama metriklerini raporlamak 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, ABD eyaletlerini veya Columbia Bölgesi'ni tanımlayan bir ISO 3166-2 kodudur (ör. US-MI (Michigan) veya US-TX (Teksas)). US-ZZ eyalet kodu, YouTube'un ilişkili ABD eyaletini tanımlayamadığı raporlama metrikleri için kullanılır. Bir API isteği, dimensions parametre değerinde province içerdiğinde isteğin, filters parametre değerinde country==US içererek verileri ABD ile kısıtlaması da gerekir.

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

dma
Nielsen'in, veri satırında açıklanan görüntüleme etkinlikleriyle ilişkili Tanımlanmış Pazar Alanı'nı (DMA) 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ğer Açıklama
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 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ülenme 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 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ından 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 izleyicilerin demografik özellikleri (yaş grubu ve cinsiyet)
    • En popüler 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 için ülkeye özel görüntüleme sayıları (ve daha fazlası)
    • Coğrafi
      • Kendi yüklediğiniz içerikler için ülkeye özgü izlenme süresi metrikleri
      • Kullanıcı tarafından yüklenen içerikler için ülkeye özgü 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
      • İlk 10: ABD'de en çok başlatılan oynatma listeleri
    • Oynatma konumu: Farklı oynatma konumlarından günlük görüntüleme sayısı ve izlenme süresi
    • Demografi: Kaliforniya'daki izleyicilerin demografik özellikleri (yaş grubu ve cinsiyet)
    • En popüler 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 dilimine (ör. gün, hafta veya ay) göre birleştirmesi gerektiğini gösterir. startDate ve endDate istek parametreleri, raporun hangi döneme ait verileri içereceğini belirtir. Raporun, sorgunun yapıldığı sırada istekte belirtilen tüm metriklerin kullanılabildiği 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 Saati ile 00:00'da (UTC-7 veya UTC-8) başlayıp Pasifik Saati ile 23:59'da sona eren dönemi ifade eder. Bu nedenle, saatlerin yaz saati uygulaması için ileri alındığı tarihler 23 saatlik bir dönemi, saatlerin geri alındığı tarihler ise 25 saatlik bir dönemi temsil eder.

Ay boyutu, belirtilen ay ve yılın ilk günü Pasifik Saati (UTC-7 veya UTC-8) ile 00:00'da başlayan dönemi ifade eder.

day (temel boyut)
Bu boyutu kullandığınızda rapordaki veriler günlük olarak toplanır ve her satır bir günlük veri içerir. Verileri daha da ayrıntılı bir şekilde incelemek için başka 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)
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 sorgunuz month boyutunu kullanıyorsa start-date ve end-date parametrelerinin her ikisi de ayın ilk gününe ayarlanmalıdır. This is a core dimension and is subject to the Deprecation Policy.

Örnekler

Aşağıdaki örnek isteklerde zamana bağlı boyutlar veya filtreler kullanılır:

  • Kanal örnekleri

    • Zamana dayalı
      • Bir kanalın videoları için günlük izlenme süresi metrikleri
      • Bir kanalın videoları için günlük ek açıklama metrikleri
      • Bir kanalın günlük oynatma listesi görüntüleme sayısı
    • Oynatma konumu: Farklı oynatma konumlarından günlük görüntüleme 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/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çerikler için günlük izlenme süresi metrikleri
      • Hak talebinde bulunulan içerik için ek açıklama metrikleri
      • İçerik sahibinin günlük oynatma listesi görüntüleme sayısı
    • Oynatma konumu: Farklı oynatma konumlarından günlük görüntüleme 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/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 oynatmaları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 abonelik akışında 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 ya da uygulamada gerçekleşen görüntülemeleri açıklar.

  • EXTERNAL_APP: Veriler, videonun <iframe> veya <object> yerleştirmesi dışında bir yöntem kullanılarak oynatıldığı üçüncü taraf uygulamaları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.

  • IMMERSIVE_LIVE_FEED: Veriler, dikey canlı feed'de gerçekleşen görüntülemeleri açıklar.

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

    10 Eylül 2013'ten itibaren oynatmalar, YouTube Analytics raporlarında MOBILE oynatmaları olarak kategorize edilmeyecektir. Eski veriler hâlâ bu kategoriye girdiğinden değer raporlarda kalabilir. Ancak bu tarihten sonra mobil oynatmalar, oynatmanı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.

  • SHORTS_FEED: Veriler, YouTube Shorts Akışı'nda gerçekleşen görüntülemeleri açıklar.

  • WATCH: Veriler, videonun YouTube izleme sayfasında veya resmi bir YouTube uygulamasında (ör. YouTube Android uygulaması) 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ştirilmiş oynatıcılarda gerçekleşen görüntülemeler için desteklendiğini ve belirli bir video için en fazla görüntüleme sayısını oluşturan yerleştirilmiş oynatıcıları tanımladığını unutmayın. Bu nedenle, en popüler 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 isteklerde oynatma konumu boyutları kullanılır:

  • Kanal örnekleri

    • Oynatma konumu
      • Farklı oynatma konumlarından gelen görüntüleme sayısı ve izlenme süresi
      • Farklı oynatma konumlarından günlük görüntüleme sayısı ve izlenme süresi
      • İlk 10: Yerleştirilmiş bir video için en çok görüntüleme oluşturan üçüncü taraf siteler
      • Farklı oynatma konumlarından oynatma listesi görüntüleme sayısı ve izlenme süresi
      • Farklı oynatma konumlarından günlük oynatma listesi görüntüleme sayısı ve izlenme süresi

  • İçerik sahibi örnekleri

    • Oynatma konumu
      • Farklı oynatma konumlarından gelen görüntüleme sayısı ve izlenme süresi
      • Farklı oynatma konumlarından günlük görüntüleme sayısı ve izlenme süresi
      • İlk 10: Yerleştirilmiş bir video için en çok görüntüleme oluşturan üçüncü taraf siteler
      • Farklı oynatma konumlarından oynatma listesi görüntüleme sayısı ve izlenme süresi
      • Farklı oynatma konumlarından günlük oynatma listesi görüntüleme sayısı 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ğer Açıklama
LIVE_STREAM Görüntülenen içerik bir YouTube canlı yayını ise
SHORTS Görüntülenen içerik bir YouTube Shorts videosu ise
STORY Görüntülenen içerik bir YouTube Hikayesi ise.
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 sonraki tarihler için kullanılabilir.

Aşağıdaki tabloda boyut değerleri listelenmiştir:
Değer Açıklama
LIVE Satırdaki veriler, canlı yayın sırasında gerçekleşen kullanıcı etkinliğini açıklar.
ON_DEMAND Satırdaki veriler, 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 zaman itibarıyla doğru olduğunu unutmayın. Örneğin, bir kullanıcının bir kanala abone olmadığını ve aynı gün içinde kanalın videolarından birini izlediğini, ardından kanala abone olup başka bir video izlediğini varsayalım. Kanalın raporu, bir görünümün subscribedStatus değerinin SUBSCRIBED, diğer görünümün 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ğer Açıklama
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ı etkinliği CORE kapsamına dahildir.
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, 1 Mart 2021'de veya sonrasında YouTube Music'te gerçekleşti. 1 Mart 2021'den önceki veriler CORE kategorisine 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 nasıl ulaştığını 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, başka bir videodaki ek açıklamayı 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 bulunulan ve kullanıcı tarafından yüklenen videolardan gelen görüntülemelerdir. 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ö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 pivot sayfalarından gelen görüntülemelerdir.
  • LIVE_REDIRECT: Video görüntülemeleri Live Redirects'ten yönlendirildi.
  • NO_LINK_EMBEDDED: Video, başka bir web sitesine yerleştirilmişken görüntülenmiştir.
  • NO_LINK_OTHER: YouTube, trafik için bir yönlendiren tanımlamadı. Bu kategori, bir videoya gelen doğrudan 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, bir oynatma listesinin parçası olarak oynatılırken gerçekleşen video görüntüleme sayısıdır. Oynatma listesi sayfasından gelen trafik de buna dahildir.
  • PRODUCT_PAGE: Video görüntülemeleri bir ürün sayfasından yönlendirildi.
  • 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 video listesinden 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 önceki videodan dikey olarak kaydırarak yönlendirildi.
  • SOUND_PAGE: Shorts ses pivot sayfalarından gelen görüntülemelerdir.
  • 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ı, 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ş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ülemeleri, 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önlendirildi. 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 yapılmış video bağlantısından yönlendirildi. Bu trafik kaynağına göre filtreleme yaparsanız insightTrafficSourceDetail alanı, izleyicinin yönlendirildiği videoyu belirtir.
  • WATCH_WITH: Video görüntülemeleri, içerik üretici yorumu / "Birlikte İzle" yayınından yönlendirildi. 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ılabildiği trafik kaynakları belirtilmiştir. 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 oynat etkileşim reklamı
    • Etkileşim reklamı
    • Google Arama Ağı reklamları
    • Ana sayfa video reklamı
    • Ayrılmış atlanabilir yayın içi
    • Arama sonuçlarında TrueView ve görüntülü TrueView
    • Yayın içi (in-stream) TrueView
    • Kategorize edilmemiş YouTube reklamcılığı
    • Video duvarı
  • CAMPAIGN_CARD: İzleyicileri raporda tanımlanan videoya yönlendiren, hak talebinde bulunulan 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üleme sayısını artıran 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: Ana sayfa abonelik akışlarındaki yüklenmeyen ve sosyal kanal üzerinden olmayan etkinliklerden (ör. beğeniler, favoriler, bülten yayınları ve oynatma listesine eklemeler) kaynaklanan öğelerin aldığı görüntülemeler.
    • blogged: Ana sayfa abonelik akışlarındaki, popüler bloglardan gelen bağlantılarla elde edilen öğelerden gelen görüntülemeler.
    • mychannel: Ana sayfada listelenen diğer feed'lerdeki ("Beğenilenler", "İzleme Geçmişi" ve "Daha Sonra İzle" gibi) öğelerden gelen görüntülemelerdir.
    • podcasts: Podcast hedef sayfasındaki öğelerden gelen görüntülemelerdir.
    • sdig: Abonelik güncelleme e-postalarından gelen görüntülemeler.
    • uploaded: Ana sayfa abonelik akışlarındaki uploaded öğelerin aldığı görüntülemelerdir.
    • /: YouTube ana sayfasından gelen diğer görüntülemelerdir.
    • /my_subscriptions: Kullanıcıların YouTube'daki Aboneliklerim sayfalarından gelen görüntülemelerdir.
  • 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 terimi.
  • VIDEO_REMIXES: Görüntüleme sayısını artıran video.
  • WATCH_WITH: Görüntüleme sayısını artıran 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ısı ve izlenme süresi
      • İlk 10: Bir video için en fazla trafiği oluşturan YouTube arama terimleri
      • İlk 10: Bir video için en fazla trafiği oluşturan Google Arama terimleri
      • Bir ülkedeki farklı trafik kaynaklarından gelen oynatma listesi görüntüleme sayısı ve izlenme süresi
      • Farklı trafik kaynaklarından 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ısı ve izlenme süresi
      • Farklı trafik kaynaklarından gelen günlük görüntüleme sayısı ve izlenme süresi
      • İlk 10: Bir video için en fazla trafiği oluşturan YouTube arama terimleri
      • İlk 10: Bir video için en fazla trafiği oluşturan Google Arama terimleri
      • Bir ülkedeki farklı trafik kaynaklarından gelen oynatma listesi görüntüleme sayısı ve izlenme süresi
      • Farklı trafik kaynaklarından 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 biçim faktörünü tanımlar. Aşağıdaki listede, API'nin veri döndürdüğü cihaz türleri belirtilmektedir. Bir işletim sistemi raporunu yalnızca belirli bir cihaz türüne ait verileri içerecek şekilde kısıtlamak 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. Cihaz türü raporunu yalnızca belirli bir işletim sistemine ait verileri içerecek şekilde kısıtlamak için operatingSystem özelliğini 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ılmaktadı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ülemeleri için 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ülemeleri için günlük işletim sistemi metrikleri

Demografi

Demografik boyutlar, kitlenizin yaş grubu 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, raporlama verileriyle ilişkili olan ve giriş yapmış kullanıcıların yaş grubunu tanımlar. YouTube'un 18 yaşından küçük olduğunu tahmin ettiği kullanıcılar da bu boyuta dahildir. 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, raporlama verileriyle ilişkili olan ve giriş yapmış kullanıcıların cinsiyetini tanımlar. Geçerli değerler: female, male ve user_specified. This is a core dimension and is subject to the Deprecation Policy.

Örnekler

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

  • Kanal örnekleri

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

  • İçerik sahibi örnekleri

    • Demografik
      • 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, YouTube'da (veya YouTube oynatıcı aracılığıyla) "Paylaş" düğmesi kullanılarak paylaşılabilir. This is a core dimension and is subject to the Deprecation Policy.

Aşağıdaki tabloda geçerli boyut değerleri listelenmiştir:
Paylaşım hizmeti API değeri
Allo ALLO
Ameba AMEBA
Android E-posta ANDROID_EMAIL
Android Messenger ANDROID_MESSENGER
Android mesajlaşma ANDROID_MMS
Android sistemi paylaşım iletişim kutusu ANDROID_SYSTEM_SHARE_DIALOG
Blackberry Messenger BBM
Reaksiyon alın BLIND_REACT
Blogger BLOGGER
Panoya Kopyala COPY_PASTE
Cyworld CYWORLD
Digg DIGG
Doğrudan sistem etkinliği iletişim kutusu DIRECT_SYSTEM_ACTIVITY_DIALOG
Discord DISCORD
Gösterilen QR kodu DISPLAYED_QR_CODE
Dropbox DROPBOX
Yerleştir EMBED
E-posta MAIL
Facebook FACEBOOK
Facebook Lite FACEBOOK_LITE
Facebook Messenger FACEBOOK_MESSENGER
Facebook sayfaları FACEBOOK_PAGES
Facebook'ta grupta paylaşma FACEBOOK_SHARE_TO_GROUP
Facebook Hikayeleri FACEBOOK_STORIES
Fotka FOTKA
Gmail GMAIL
goo GOO
Google uygulaması GOOGLE_APP
Google Chat GOOGLE_CHAT
Google Chrome GOOGLE_CHROME
Google Inbox INBOX
Google Keep GOOGLE_KEEP
Google+ GOOGLEPLUS
Go SMS GO_SMS
GroupMe GROUPME
Hangouts HANGOUTS
hi5 HI5
HTC kısa mesajı HTC_MMS
IMO IMO
Instagram INSTAGRAM
Instagram Hikayeleri INSTAGRAM_STORIES
Davet bağlantısı (Android) INVITE_LINK_ANDROID
Davet bağlantısı (iOS) INVITE_LINK_IOS
Oynatma listesine ortak çalışan davet etme INVITE_PLAYLIST_COLLABORATORS
iOS Sistem Etkinliği İletişim Kutusu IOS_SYSTEM_ACTIVITY_DIALOG
KAKAO Story KAKAO_STORY
Kakao (Kakao Talk) KAKAO
KaiOS mesajları KAIOS_MESSAGES
Kik KIK
LGE E-posta LGE_EMAIL
Çizgi LINE
LinkedIn LINKEDIN
LiveJournal LIVEJOURNAL
Haritalar'da kopyalama/yapıştırma MAPS_COPY_PASTE
Meet'te canlı paylaşım MEET_LIVE_SHARING
menéame MENEAME
mixi MIXI
Motorola Messaging MOTOROLA_MESSAGING
Myspace MYSPACE
Naver NAVER
Yakındakilerle Paylaş NEARBY_SHARE
NUjij NUJIJ
Odnoklassniki (Одноклассники) ODNOKLASSNIKI
Diğer OTHER
Pinterest PINTEREST
Quick Share QUICK_SHARE
Quick Share (Samsung) QUICK_SHARE_SAMSUNG
Rakuten (楽天市場) RAKUTEN
reddit REDDIT
Remiks REMIX
Samsung Mesajlar SAMSUNG_MESSAGES
Samsung Notes SAMSUNG_NOTES
Cihazdaki fotoğraflara kaydet SAVE_TO_DEVICE_PHOTOS
Reklamsız paylaşın SHARE_AD_FREE
Snapchat kamerasıyla paylaşın SHARE_TO_SNAPCHAT_CAMERA
Çocuklarla paylaşma SHARE_WITH_KIDS
Skype SKYPE
Skyrock SKYBLOG
Snapchat SNAPCHAT
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
Web sistemi etkinliği iletişim kutusu WEB_SYSTEM_ACTIVITY_DIALOG
WeChat WECHAT
Weibo WEIBO
WhatsApp WHATS_APP
WhatsApp Business WHATS_APP_BUSINESS
Wykop WYKOP
Yahoo! Japonya YAHOO
YouTube topluluk gönderisi YOUTUBE_COMMUNITY_POST
YouTube topluluk gönderisini yeniden yayınlama YOUTUBE_COMMUNITY_REPOST
YouTube Oyun YOUTUBE_GAMING
YouTube Kids YOUTUBE_KIDS
YouTube Mango YOUTUBE_MANGO
YouTube Music YOUTUBE_MUSIC
YouTube Music'ten Snapchat'te paylaşım önizlemesi YTM_SHARE_TO_SNAPCHAT_PREVIEW
YouTube Shorts Yeşil Ekran YOUTUBE_SHORTS_GREEN_SCREEN
YouTube TV YOUTUBE_TV
Arkadaşlarla YouTube İzleme YOUTUBE_WATCH_WITH_FRIENDS

Daha fazla bilgi için yardım belgelerine göz atı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 videonun 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 ise zaman ölçümüdür. Örneğin, 0.4 değeri, ilgili raporlama verilerinin videonun yüzde 40'ı geçtikten sonraki 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 oynatma sırasında verilerin ölçüldüğü zamanlar, her video için eşit aralıklıdır. Bu, iki dakikalık bir video için 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 bitiş zamanını (hariç) belirtir.
audienceType (yalnızca filtre)
Boyut değeri, raporlama 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'ne bakın.

audienceType filtresiyle ilgili verilerin 25 Eylül 2013 tarihinden itibaren kullanılabildiğini unutmayın. API, daha önceki tarihlere ait verileri almak için filtreyi kullanan sorgularla ilgili 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 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ı kaç kullanıcının izlediğini gösterir.

Üyelik iptalleri

membershipsCancellationSurveyReason
Raporlama döneminde belirtilen kanal için kanal üyeliğini iptal eden YouTube kullanıcılarının tamamladığı anket sayısı. Aşağıdaki tabloda geçerli boyut değerleri listelenmiştir:
API değeri Açıklama
UNKNOWN Kullanıcı anketi tamamlamadı.
DISLIKE_PERKS Kullanıcı, üyelik ayrıcalıklarını beğenmedi.
PERKS_NOT_DELIVERED Kullanıcı, vadedilen üyelik ayrıcalıklarının sunulmadığını belirtti.
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ı, kanal üyesi olarak yeterince değer görmediğini hissetti.
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ş.
OTHER Kullanıcının iptal etmek için başka bir nedeni vardı.

Reklam performansı

adType
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. 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, videonun görüntülenebilmesi için izlenmesi gereken, 6 saniyeye kadar süren ve 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 birleşimi olarak görünen bir rich media ya da resim reklamdır. 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 bir 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 ana video sırasında yayınlanan atlanabilir video reklamlardır. 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 birinde sınıflandırılmamış reklam.

  • reservedBumperInstream: Rezervasyonla satılan, videonun görüntülenebilmesi için izlenmesi gereken, 6 saniyeye kadar süren ve atlanamayan video reklamlardır.

  • reservedClickToPlay: Oynatmayı başlatmak için kullanıcının tıklaması gereken video reklam. Kullanıcının oynatmayı 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. Bunlar rezervasyon temelinde 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 birleşimi olarak görünen bir rich media ya da resim reklamdır. 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 bir banner birlikte gösterilirse her reklam ayrı bir gösterim olarak sayılır.

  • reservedInstream: Ana videonun öncesinde, oynatılması sırasında ve sonrasında eklenen, atlanamayan video reklamlar.

  • reservedInstreamSelect

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

  • reservedUnknown: Rezervasyon 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 geliri sağlayan videolar
      • Farklı reklam türleri için reklam performansı metrikleri

  • İçerik sahibi örnekleri

    • Gelir/Reklamlar
      • Hak talebinde bulunulan içerik 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ında desteklenir.

Önemli: İçerik sahibi raporlarını almak için yapılan API istekleri, aşağıdaki boyutlardan birini kullanarak verileri filtrelemelidir:
  • 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çerikle ilgili 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çeriklerin verilerini alır. uploaderType boyutunun tanımındaki tabloda, bu boyutun nasıl kullanılacağı hakkında daha fazla bilgi verilmiştir.
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) için metrikler içerip içermeyeceğini belirtmenize olanak tanır. Geçerli değerler self ve thirdParty'dir. Bu, temel bir boyuttur ve kullanımdan kaldırma politikası'na tabidir.

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

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

Örnekler

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