Örnek API İstekleri

Bu sayfada örnek YouTube Analytics API istekleri gösterilmektedir. Her örnek, alınan rapor kısaca açıklanır ve ardından ilgili dimensions, metrics, filters ve sort parametre değerleri gösterilir. (Kanal raporları ve içerik sahibi raporları belgeleri, API'nin desteklediği raporları tanımlar.)

Her örnek, Google API Gezgini'ne bağlantı verir ve bu aracı gösterilen değerlerle doldurur. Örnekler, 2023-09-01 ve 2024-03-31 varsayılan başlangıç ve bitiş tarihlerini (YYYY-MM-DD) da kullanır.

API Gezgini'ne bağlandıktan sonra raporları aldığınız kanalı veya içerik sahibini yine de belirtmeniz gerekir. API Gezgini, tıkladığınız sorguya bağlı olarak ids parametre değerini channel==MINE veya contentOwner==CONTENT_OWNER_ID ile doldurur. Kanal raporlarında MINE değerini, kimliği doğrulanmış kullanıcının kanal kimliğiyle değiştirebilirsiniz. İçerik sahibi raporları için CONTENT_OWNER_ID değerini içerik sahibi kimliğinizle değiştirmeniz gerekir.

API Gezgini'nin API isteklerinizi OAuth 2.0 kullanarak yetkilendirebilmesi için, belirtilen kanal veya içerik sahibi olarak kimliğinizi doğrulamanız gerekir.

  1. İstekleri birden fazla boyuta/metriğe göre sıralama
  2. Kanal raporları
  3. İçerik sahibi raporları

İstekleri birden fazla boyuta/metriklere göre sıralama

API, yanıt verilerini birden fazla boyut veya metrik kullanarak sıralama özelliğini destekler. Örneğin, aşağıdaki istek, belirli bir kanalın videolarına ait günlük trafik kaynağı verilerini alır. Sonuç kümesindeki her satır, belirli bir günde belirli bir trafik kaynağı türünden (ör. EXT_URL) gelen görüntüleme sayısını ve tahmini izlenme süresini tanımlar.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-views

Yanıtta sonuçlar kronolojik olarak sıralanır. Sonuçlar, her güne ait sonuç grubunda görüntüleme sayısına göre azalan düzende sıralanır. Bu nedenle, sonuç grubundaki ilk satır, istenen tarih aralığının ilk gününde en çok görüntülemeyi oluşturan trafik kaynağına ait verileri içerir. İkinci satırda, ilk günde sonraki en yüksek görüntüleme sayısını oluşturan trafik kaynağına ilişkin veriler yer alır.

Kanal raporları

Temel istatistikler

Video raporları

Kanalın toplam görüntüleme sayısı, tahmini izlenme süresi ve daha fazlası

Bu sorgu, kanal içeriği için toplu metrikleri getirir. Rapor, belirtilen tarih aralığında istenen her metrik için toplamları içeren tek bir veri satırı döndürür.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration

Kanalların ülkelere özgü görüntüleme sayıları (ve daha fazlası)

Bu sorgu, bir kanalın videoları için belirli bir ülkenin metriklerini alır. Rapor, belirtilen tarih aralığında istenen her metrik için toplamları içeren tek bir veri satırı döndürür.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==US

İlk 10 - Kanalda en çok izlenen videolar

Bu sorgu, kanalın en çok izlenen 10 videosunu getirir. Bu videolar, belirtilen tarih aralığında tahmini olarak izlenen dakika cinsinden ölçülür. Sonuçlar, tahmini izlenme süresine göre, azalan düzende sıralanır.

Not: Bu rapor, sort istek parametresi için bir değer belirtmenizi ve maxResults parametresini 10 veya daha az bir tam sayı olarak ayarlamanızı gerektirir.

dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched

İlk 10 – Kanalın en çok görüntülenen videoları için ek açıklama tıklama oranları

Bu istek, kanalın en çok görüntülenen 10 videosu için görüntüleme sayılarını, ek açıklama tıklama oranlarını, ek açıklama kapatma oranlarını ve ek açıklama gösterimlerini alır. Sonuçlar, görüntüleme sayısına göre azalan düzende sıralanır. Bu, en çok görüntülenen videonun listenin başında olacağı anlamına gelir.

Not: Bu rapor, sort istek parametresi için bir değer belirtmenizi ve maxResults parametresini 10 veya daha az bir tam sayı olarak ayarlamanızı gerektirir.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Oynatma listesi raporları

Bir kanaldaki toplam oynatma listesi görüntüleme sayısı

Bu istek kimliği doğrulanmış kullanıcının kanalındaki oynatma listelerinin toplam oynatma listesi başlatma sayısı, tahmini izlenme süresi, görüntüleme sayısı (toplu video metriği), oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik) ve oynatma listesi başlatma başına görüntüleme sayısını alır.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

Belirli bir oynatma listesiyle ilgili istatistikler

Bu istek belirli bir oynatma listesi için toplam oynatma listesi başlatma sayısı, tahmini izlenen dakika, görüntüleme sayısı (toplu video metriği), oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik) ve oynatma listesi başlatma başına görüntüleme sayısını toplar. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki PLAYLIST_ID dizesini, kimliği doğrulanmış kullanıcının kanalındaki bir oynatma listesinin oynatma listesi kimliğiyle değiştirmeniz gerektiğini unutmayın.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

Birden fazla oynatma listesinin toplam istatistiklerini almak için PLAYLIST_ID dizesini, kimliği doğrulanmış kullanıcının kanalındaki oynatma listeleri için en fazla 500 oynatma listesi kimliğinden oluşan virgülle ayrılmış bir listeyle de değiştirebilirsiniz.

En Çok İzlenen 10 - Bir kanal için en çok izlenen oynatma listeleri

Bu sorgu, kanalın en çok izlenen 10 oynatma listesini getirir (belirtilen tarih aralığında oynatma listesi görüntülemeleriyle ölçülür). Ayrıca, görüntüleyenlerin her oynatma listesini kaç kez oynatmaya başladıkları ve bir izleyicinin oynatma listesindeki videoları başlatıldıktan sonra ortalama süresi gibi başka oynatma listesi metriklerini de alır. Sonuçlar, oynatma listesi görüntüleme sayısına göre büyükten küçüğe sıralanır.

Not: Bu raporda playlist boyutu kullanıldığından, sort istek parametresi için bir değer belirtmeniz ve maxResults parametresini 10 veya daha küçük bir tam sayı olarak ayarlamanız gerekir.

dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews
Zamana dayalı

Video raporları

Bir kanalın videoları için günlük izlenme süresi metrikleri

Bu sorgu, bir kanalın videoları için günlük görüntüleme sayılarını, izlenme süresi metriklerini ve yeni abone sayılarını alır. Rapor, istenen tarih aralığındaki her gün için bir veri satırı döndürür. Satırlar kronolojik düzende sıralanır.

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

Bir kanalın videoları için günlük ek açıklama metrikleri

Bu istek, kanal içeriği için günlük görüntüleme sayılarını, ek açıklama tıklama oranlarını, ek açıklama kapatma oranlarını ve ek açıklama gösterimlerini alır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

Oynatma listesi raporları

Bir kanalın günlük oynatma listesi görüntüleme sayısı

Bu istek, kimliği doğrulanmış kullanıcının kanalı için günlük görüntüleme sayılarını (toplu video metriği), oynatma listesi görüntülemelerini (oynatma listesi içi metriği), oynatma listesi başlatma sayısını, tahmini izlenme süresini ve oynatma listesi başlatma başına görüntüleme sayısını alır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day
Coğrafi

Video raporları

Kanal videoları için ülkeye özgü izlenme süresi metrikleri

Bu sorgu, bir kanalın videoları için ülkeye özgü görüntüleme sayılarını, izlenme süresi metriklerini ve abonelik rakamlarını alır. Rapor, kanal videolarının izlendiği her ülke için bir veri satırı döndürür. Satırlar izlenen dakika sayısına göre, azalan düzende sıralanır.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

Kanal videoları için ülkeye özgü ek açıklama metrikleri

Bu istek, kanalın videoları için ülkeye özgü görüntüleme sayılarını, ek açıklama tıklama oranlarını, ek açıklama kapatma oranlarını ve ek açıklama gösterimlerini alır. Sonuçlar ek açıklama tıklama oranına göre azalan düzende sıralanır. Diğer bir deyişle, en yüksek ek açıklama tıklama oranına sahip ülke ilk sırada listelenir.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

ABD eyaletleri ve Washington D.C. için eyaletlere özgü metrikler

Bu istek; görüntüleme sayılarının, tahmini izlenme süresinin ve ortalama görüntüleme süresinin eyalete göre dökümünü alır. Veriler ABD eyaletlerini ve Washington D.C. eyaletlerini kapsar. Sonuçlar, eyaletlerin ISO 3166-2 kodlarına göre alfabetik olarak sıralanır.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

İlk 10 - Belirli bir ülkede en çok görüntülenen video

Bu sorgu, kanalın en çok görüntülenen 10 videosunu getirir ve bu videolar, belirtilen tarih aralığında belirli bir ülkedeki görüntüleme sayısıyla ölçülür. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır.

Not: Bu rapor, sort istek parametresi için bir değer belirtmenizi ve maxResults parametresini 10 veya daha az bir tam sayı olarak ayarlamanızı gerektirir.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views

Toplam görüntüleme sayısına göre ABD'deki ilk 10 şehir

Bu sorgu, belirtilen tarih aralığında kanal içeriğinin en çok görüntülendiği 10 ABD şehrinin listesini getirir. Sorgu, başka bir ülke için veri isteğinde bulunacak şekilde, söz konusu filtre için başka bir geçerli değer seçilerek değiştirilebilir. Benzer şekilde sorgu, subContinent filtresi ve geçerli değerlerinden biri kullanılarak Batı Avrupa veya Güneydoğu Asya gibi bir alt kıtaya ilişkin verileri alacak şekilde değiştirilebilir. Diğer filtreler de desteklenir. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır.

    dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-views

Her içerik türü için toplam görüntüleme sayısına göre ABD'deki ilk 10 şehir

Bu sorgu, desteklenen her creatorContentType için belirtilen tarih aralığında kanal içeriğinin en çok izlendiği 10 ABD şehrinin listesini getirir. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır.

    dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views

Toplam izlenme süresine göre ABD'deki ilk 10 şehir

Bu sorgu, ABD'deki herhangi bir şehrin kanal içeriğinin en yüksek toplam günlük izlenme süresine sahip olduğu tarih aralığında ilk 10 günün listesini getirir. Sorgu sonuçları toplam izlenme süresini, izlenme süresinin gerçekleştiği tarihi ve içeriğin görüntülendiği tahmin edilen şehri tanımlar. Sonuçlar, toplam izlenme süresine göre azalan düzende sıralanır.

    dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTime

En Popüler 10 - Avrupa'da en çok görüntülenen video

Bu sorgu, belirtilen tarih aralığındaki görüntüleme sayısıyla ölçülen, kanalın Avrupa'da en çok görüntülenen 10 videosunu getirir. Sorgu, başka bir kıta için veri isteğinde bulunacak şekilde, söz konusu filtre için başka bir geçerli değer seçilerek değiştirilebilir. Benzer şekilde sorgu, subContinent filtresi ve geçerli değerlerinden biri kullanılarak Batı Avrupa veya Güneydoğu Asya gibi bir alt kıtaya ilişkin verileri alacak şekilde değiştirilebilir. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır.

Not: Bu rapor, sort istek parametresi için bir değer belirtmenizi ve maxResults parametresini 10 veya daha az bir tam sayı olarak ayarlamanızı gerektirir.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Oynatma listesi raporları

Bir kanalın oynatma listeleri için ülkeye özgü izlenme süresi metrikleri

Bu sorgu, kanalın oynatma listeleri için ülkeye özel görüntüleme sayılarını (toplu video metriği), oynatma listesi görüntülemelerini (oynatma listesi içi metrik) ve izlenme süresi metriklerini alır. Rapor, kanalın oynatma listelerinin izlendiği her ülke için bir veri satırı döndürür. Satırlar izlenen dakika sayısına göre, azalan düzende sıralanır.

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatched

En Popüler 10 - ABD'de en çok başlatılan oynatma listeleri

Bu sorgu, ABD'deki izleyicilerin belirtilen tarih aralığında en sık izlemeye başladığı 10 oynatma listesini getirir. Sonuçlar, oynatma listesi başlatma sayısına göre büyükten küçüğe sıralanır.

Not: Bu raporda playlist boyutu kullanıldığından, sort istek parametresi için bir değer belirtmeniz ve maxResults parametresini 10 veya daha küçük bir tam sayı olarak ayarlamanız gerekir.

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts
Oynatma konumu

Video raporları

Farklı oynatma konumlarından gelen görüntüleme sayısı ve izlenme süresi

Bu sorgu, belirli bir kanalın videoları için görüntüleme sayısını ve tahmini izlenme süresini alır. Sonuçlar, video oynatmalarının gerçekleştiği sayfanın veya uygulamanın türüne göre toplanır ve sonuçlar, görüntüleme sayısına göre büyükten küçüğe sıralanır.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-views

Farklı oynatma konumlarındaki günlük görüntüleme sayıları ve izlenme süresi

Bu sorgu, belirli bir kanalın videoları için ABD'deki günlük görüntüleme sayılarını ve tahmini izlenme süresini alır. Sonuçlar, video oynatmaların gerçekleştiği her sayfa türü veya uygulama için güne göre gruplandırılır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US
sort=day

İlk 10 – Yerleştirilmiş videolar için en çok görüntüleme sağlayan üçüncü taraf siteleri

Bu sorgu, belirli bir video veya video grubu için görüntüleme sayılarını ve tahmini izlenme süresini alır. Sonuçlar, videonun yerleştirildiği üçüncü taraf sitesine göre gruplandırılır. Sonuçlar, görüntüleme sayısına göre azalan düzende sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki VIDEO_ID dizesini, yüklediğiniz videoların video kimlikleri için bir veya daha fazla video kimliğinin virgülle ayrılmış listesiyle değiştirmeniz gerektiğini unutmayın.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Oynatma listesi raporları

Oynatma listesi görüntüleme sayısı ve farklı oynatma konumlarından izlenme süresi

Bu sorgu, belirli bir kanalın oynatma listeleri için görüntüleme sayısı (toplu video metriği), oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), tahmini izlenme süresi ve oynatma listesi başlatma sayısı bilgilerini alır. Sonuçlar, video oynatıldığı sayfanın veya uygulamanın türüne göre toplanır ve oynatma listesi başlatma sayısına göre büyükten küçüğe sıralanır.

dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts

Farklı oynatma konumlarındaki günlük oynatma listesi görüntüleme sayıları ve izlenme süresi

Bu sorgu; belirli bir kanalın oynatma listeleri için günlük oynatma listesi başlatma sayısı, görüntüleme sayılarını (toplu video metriği), oynatma listesi görüntüleme sayısını (oynatma listesi içi metrik) ve ABD'deki tahmini izlenme süresini alır. Sonuçlar, oynatma listesi görüntülemelerinin gerçekleştiği her sayfa veya uygulama türü için güne göre gruplandırılır. Sonuçlar kronolojik olarak sıralanır.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day
Trafik kaynağı

Video raporları

Bir ülkedeki farklı trafik kaynaklarından gelen görüntüleme sayısı ve izlenme süresi

Bu istek, kanalın videolarının belirli bir ülkedeki görüntüleme sayısını ve tahmini izlenme süresini alır. Metrikler, kullanıcıların videoya ulaşma şeklini açıklayan trafik kaynağına göre toplanır.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==US

Farklı trafik kaynaklarından gelen günlük görüntüleme sayısı ve izlenme süresi

Bu istek, kanal videolarının günlük görüntüleme sayısını ve günlük tahmini izlenme süresini alır. Metrikler trafik kaynağına göre günlük olarak toplanır ve kronolojik olarak sıralanır.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=day

İlk 10: Bir video için en fazla trafiği oluşturan YouTube arama terimleri

Bu sorgu, bir veya daha fazla özel video için YouTube arama sonuçlarından en çok görüntüleme oluşturan 10 arama terimini getirir. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki VIDEO_ID dizesini, en fazla 500 video kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

Örneğin, sorguyu tek bir video için çalıştırabilir veya söz konusu video için en fazla trafiği üreten arama terimlerini belirlemek üzere VIDEO_ID ifadesini değiştirebilirsiniz. Belirli bir oynatma listesindeki videoların tümünü listeleyerek bu oynatma listesindeki videolardan herhangi biri için hangi arama terimlerinin en fazla trafiği oluşturduğunu belirleyebilirsiniz.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

İlk 10: Video için en çok trafik oluşturan harici web siteleri

Bu sorgu, belirli bir video veya video grubu için en çok görüntülemeyi sağlayan 10 harici web sitesini getirir. Sonuçlar, tahmini izlenme süresine göre çoktan aza doğru sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki VIDEO_ID dizesini, yüklediğiniz videolar için en fazla 500 video kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Oynatma listesi raporları

Bir ülkedeki farklı trafik kaynaklarından gelen oynatma listesi görüntüleme sayısı ve izlenme süresi

Bu istek; belirli bir ülkedeki görüntüleme sayısını (toplu video metriği), oynatma listesi görüntülemelerini (oynatma listesi içi metrik), oynatma listesi başlatma sayısını ve oynatma listesi görüntülemelerinin tahmini izlenme süresini alır. Metrikler, kullanıcıların oynatma listesine ulaşma biçimini açıklayan trafik kaynağına göre toplanır.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US

Farklı trafik kaynaklarından günlük oynatma listesi görüntüleme sayısı ve izlenme süresi

Bu istek, kanalın günlük oynatma listesi görüntüleme sayısını (oynatma listesi içi metrik), oynatma listesi başlatma sayısını ve tahmini izlenme süresini alır. Ayrıca toplam görüntüleme sayısını da (toplu video metriği) alır. Metrikler trafik kaynağına göre günlük olarak toplanır ve kronolojik olarak sıralanır.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day
Cihaz/İşletim Sistemi

Video raporları

Android işletim sistemi için günlük cihaz türü metrikleri

Bu sorgu, belirli bir kanalın videoları için Android cihazlardaki günlük görüntüleme sayılarını ve tahmini izlenme süresini alır. Sonuçlar, video oynatmalarının gerçekleştiği her cihaz türü için güne göre gruplandırılır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day

Mobil cihazlar için günlük işletim sistemi metrikleri

Bu sorgu, belirli bir kanalın videoları için günlük görüntüleme sayılarını ve mobil cihazlardaki tahmini izlenme süresini alır. Sonuçlar, video oynatmalarının gerçekleştiği her işletim sistemi için güne göre gruplandırılır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=day

Günlük işletim sistemi ve cihaz türü metrikleri

Bu sorgu, bir kanal için günlük görüntüleme sayılarını ve tahmini izlenme süresini alır. İstatistikler, işletim sistemi ve cihaz türüne göre gruplandırılır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Oynatma listesi raporları

Android işletim sisteminde oynatma listesi görüntülemeleri için günlük cihaz türü metrikleri

Bu sorgu, belirli bir kanalın oynatma listeleri için Android cihazlardaki günlük görüntüleme sayısını (toplu video metriği), oynatma listesi görüntüleme sayısını (oynatma listesi içi metrik) ve tahmini izlenme süresini alır. Sonuçlar, oynatma listesinin görüntülendiği her cihaz türü için güne göre gruplandırılır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=day

Mobil cihazlarda oynatma listesi görüntülemelerine ilişkin günlük işletim sistemi metrikleri

Bu sorgu, belirli bir kanalın oynatma listeleri için günlük görüntüleme sayısını (toplu video metriği), oynatma listesi görüntüleme sayısını (oynatma listesi içi metrik) ve mobil cihazlardaki tahmini izlenme süresini alır. Sonuçlar, oynatma listesi görüntülemelerinin gerçekleştiği her işletim sistemi için güne göre gruplandırılır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day
Demografik

Video raporları

Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet)

Bu rapor, Kaliforniya'da kanalın videolarını izleyen izleyicilerin yaş grubu ve cinsiyetiyle ilgili istatistikleri alır. Sonuçlar cinsiyete ve ardından yaş grubuna göre sıralanır. Bu sorgu, filters parametre değeri ayarlanarak dünya genelindeki tüm görüntüleyenler veya bir ülke, kıta, alt kıta ya da başka bir ABD eyaletindeki tüm görüntüleyenler için aynı istatistikleri alacak şekilde değiştirilebilir.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

Oynatma listesi raporları

Kaliforniya'da oynatma listesi görüntüleyenlerinin demografisi (yaş grubu ve cinsiyet)

Bu rapor, Kaliforniya'da kanalın oynatma listelerini izleyen izleyicilerin yaş grubu ve cinsiyetiyle ilgili istatistikleri alır. Sonuçlar cinsiyete ve ardından yaş grubuna göre sıralanır. Bu sorgu, filters parametre değeri ayarlanarak dünya genelindeki tüm görüntüleyenler veya bir ülke, kıta, alt kıta veya başka bir ABD eyaletindeki tüm görüntüleyenler için aynı istatistikleri alacak şekilde değiştirilebilir.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup
Sosyal

Videoların paylaşıldığı hizmete göre toplanan paylaşım metrikleri

Bu istek, kullanıcıların bir kanalın videolarını paylaşmak için Share düğmesini kaç kez kullandıklarını getirir. Sonuçlar paylaşım hizmetine (Google+, Twitter vb.) göre toplanır ve paylaşım sayısına göre büyükten küçüğe sıralanır.

dimensions=sharingService
metrics=shares
sort=-shares
Kitleyi elde tutma

Bir videonun kitleyi elde tutma metrikleri

Bu rapor, bir videonun kitlesini elde tutma becerisini ölçer. Rapor, bir defada yalnızca tek bir video için alınabilir. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki VIDEO_ID dizesini yüklediğiniz videolardan birinin video kimliğiyle değiştirmeniz gerektiğini unutmayın. Kitleyi elde tutma raporlarının, video filtresi için birden çok değer belirtme özelliğini desteklemediğini unutmayın.

Bu örnekte raporda, yalnızca video araması veya önerilen bir videonun tıklanması gibi doğrudan kullanıcı işlemlerinin sonucu olan organik görüntülemelere ilişkin verileri içerecek şekilde yanıtı kısıtlamak için audienceType filtresi kullanılmaktadır. Bu nedenle rapor, Yayın içi (In-stream) TrueView veya Görüntülü TrueView (TrueView In-display) reklamlarına ait görüntülemelere ilişkin verileri içermez. Tüm kitle türlerinden videonun kitleyi elde tutma verilerini almak için filtreyi kaldırabilirsiniz.

audienceType filtresine ilişkin verilerin 25 Eylül 2013 tarihinden itibaren kullanılabileceğini unutmayın. API, önceki tarihlerden veri almaya çalışmak için filtreyi kullanan sorgular için veri döndürmez. Filtreyi kullanmayan sorgular 1 Temmuz 2008'den sonraki herhangi bir tarih için çalışır.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
Gelir/Reklamlar

Kanal geliri ve reklam performansı metrikleri

Bu istek, kanalın gelir ve reklam performansı metriklerini alır. Rapor, belirtilen tarih aralığında istenen her metrik için toplamları içeren tek bir veri satırı döndürür.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Günlük gelir ve reklam performansı metrikleri

Bu istek, kanalın günlük gelir ve reklam performansı metriklerini alır.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks

Ülkelere özgü gelir ve reklam performansı metrikleri

Bu istek, kanalın ülkeye özgü gelir ve reklam performansı metriklerini alır. Sonuçlar gelir tutarına göre azalan düzende sıralanır. Diğer bir deyişle, listelenen ilk ülke, iş ortağının en yüksek net gelire sahip olduğu ülke olacaktır.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenue

İlk 10 - En yüksek gelir sağlayan videolar

Bu istek, kanalın en yüksek geliri getiren 10 videosunun gelir ve reklam performansı metriklerini alır. Sonuçlar gelir tutarına göre azalan düzende sıralanır. Diğer bir deyişle, ilk video en yüksek tahmini gelire sahip olan video olur.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue

Farklı reklam türleri için reklam performansı metrikleri

Bu istek, içerik sahibinin hak talebinde bulunulan içeriğiyle ilgili reklam performansı metriklerini getirir. Sonuçlar reklam türüne göre gruplandırılır. Böylece, farklı reklam türleri arasında gelir ve BGBM değerlerini karşılaştırabilirsiniz.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType

İçerik sahibi raporları

Temel istatistikler

Video raporları

Hak talebinde bulunulan tüm içerikler için toplam görüntüleme sayısı, tahmini izlenme süresi ve daha fazlası

Bu sorgu, içerik sahibinin hak talebinde bulunulan içeriğiyle ilgili toplu metrikleri getirir. Rapor, belirtilen tarih aralığında istenen her metrik için toplamları içeren tek bir veri satırı döndürür.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed

Kendi yüklediği tüm videolar için ülkeye özgü görüntüleme sayıları (ve daha fazlası)

Bu sorgu, içerik sahibinin yüklediği videolar için belirli bir ülkenin metriklerini alır. Rapor, belirtilen tarih aralığında istenen her metrik için toplamları içeren tek bir veri satırı döndürür.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR

Hak talebinde bulunulan tüm üçüncü taraf içerikleri için toplam görüntüleme sayısı (ve daha fazlası)

Bu sorgu, içerik sahibinin hak talebinde bulunduğu ancak yüklemediği videolarla ilgili toplu metrikleri getirir. Rapor, belirtilen tarih aralığında istenen her metrik için toplamları içeren tek bir veri satırı döndürür.

metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed

Kendi yüklediği tüm içerikler için toplam görüntüleme sayısı (ve daha fazlası)

Bu sorgu, içerik sahibinin yüklediği videolar için toplu metrikleri getirir. Rapor, belirtilen tarih aralığında istenen her metrik için toplamları içeren tek bir veri satırı döndürür.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self

Hak talebinde bulunulan, kendi kendine yüklenen tüm içeriklerin toplam görüntüleme sayısı (ve daha fazlası)

Bu sorgu, içerik sahibinin yüklediği ve hak talebinde bulunduğu videolar için toplu metrikleri getirir. Rapor, belirtilen tarih aralığında istenen her metrik için toplamları içeren tek bir veri satırı döndürür.

metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimed

En Çok İzlenen 10 Video - İçerik sahiplerinin en çok izlenen videoları

Bu sorgu, belirtilen tarih aralığında içerik sahibinin yüklediği görüntüleme sayısıyla ölçülen en çok görüntülenen 10 videoyu getirir. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır.

dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-views

En Popüler 10 - İçerik sahiplerinin en çok izlenen videoları

Bu sorgu, en çok izlenen 10 videoyu getirir. Bu videolar, belirtilen tarih aralığında içerik sahibinin yüklediği tahmini izleme süresini ifade eder. Sonuçlar, tahmini izlenme süresine göre, azalan düzende sıralanır.

dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched

İlk 10 - İçerik sahibinin kanalında en çok görüntülenen video

Bu sorgu, içerik sahibinin yönettiği belirli bir kanal veya kanal grubu için en çok görüntülenen 10 videoyu getirir. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini, kanallarınız için en fazla 500 kanal kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

İlk 10 – Kanalın en çok görüntülenen videoları için ek açıklama tıklama oranları

Bu istek, belirli bir kanal veya kanal grubunda en çok görüntülenen 10 video için görüntüleme sayılarını, ek açıklama tıklama oranlarını, ek açıklama kapatma oranlarını ve ek açıklama gösterimlerini alır. Sonuçlar, görüntüleme sayısına göre azalan düzende sıralanır. Bu, en çok görüntülenen videonun listenin başında olacağı anlamına gelir. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini, kanallarınız için en fazla 500 kanal kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

Oynatma listesi raporları

İçerik sahibinin kanalları için oynatma listesi görüntülemeleri

Bu istek; içerik sahibinin kanallarındaki oynatma listelerinin toplam oynatma listesi başlatma sayısını, oynatma listesi tahmini izlenme süresini, oynatma listesi görüntülemelerini ve oynatma listesi başlatma başına görüntüleme sayılarını alır. playlistViews metriği yalnızca bir oynatma listesi bağlamında gerçekleşen video görüntülemelerini sayar. İstenen tüm metrikler oynatma listesi içi metrikler olduğundan isteğin oynatma listesi veya grup filtresini de içermesi gerekmez.

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

Belirli bir oynatma listesiyle ilgili istatistikler

Bu istek belirli bir oynatma listesi için toplam oynatma listesi başlatma sayısı, tahmini izlenen dakika, görüntüleme sayısı (toplu video metriği), oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik) ve oynatma listesi başlatma başına görüntüleme sayısını toplar. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki PLAYLIST_ID dizesini içerik sahibinin kanallarından birindeki oynatma listesinin oynatma listesi kimliğiyle değiştirmeniz gerektiğini unutmayın.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID

Birden fazla oynatma listesinin toplam istatistiklerini almak için PLAYLIST_ID dizesini, içerik sahibinin kanallarındaki oynatma listeleri için en fazla 500 oynatma listesi kimliğinden oluşan virgülle ayrılmış bir listeyle de değiştirebilirsiniz.

Zamana dayalı

Video raporları

Kendi yüklediğiniz içerikler için günlük izlenme süresi metrikleri

Bu sorgu, içerik sahibinin yüklediği videoların günlük izlenme süresi metriklerinin yanı sıra görüntüleme sayılarını, para kazanılan oynatma sayılarını ve gösterim sayılarını alır. Rapor, istenen tarih aralığındaki her gün için bir veri satırı döndürür ve satırlar kronolojik olarak sıralanır.

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

Hak talebinde bulunulan içerikler için ek açıklama metrikleri

Bu istek, içerik sahibinin hak talebinde bulunulan içeriği için günlük görüntüleme sayılarını, ek açıklama tıklama oranlarını, ek açıklama kapatma oranlarını ve ek açıklama gösterimlerini alır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

Oynatma listesi raporları

İçerik sahibinin günlük oynatma listesi görüntüleme sayısı

Bu istek, kullanıcıların içerik sahibinin oynatma listelerindeki videolarla günlük etkileşimleriyle ilgili metrikleri alır. Raporda alınan metrikler şunlardır: playlistViews, playlistStarts, playlistEstimatedMinutesWatched ve viewsPerPlaylistStart. Bu metriklerin tümü, oynatma listesi içi metriklerdir. İstenen tüm metrikler oynatma listesi içi metrikler olduğundan isteğin oynatma listesi veya grup filtresini de içermesi gerekmez.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day
Coğrafi

Video raporları

Kendi yüklediği içerikler için ülkeye özgü izlenme süresi metrikleri

Bu sorgu, her ülke için görüntüleme sayılarını, izlenme süresi metriklerini ve tahmini reklam gelirini alır. Metrikler içerik sahibinin yüklediği videolara yöneliktir. Rapor, videoların izlendiği her ülke için bir veri satırı döndürür ve satırlar, izlenen dakika sayısına göre azalan düzende sıralanır.

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Kendi kendine yüklenen içerikler için ülkeye özgü ek açıklama metrikleri

Bu istek, içerik sahibinin yüklediği videolar için ülkeye özgü görüntüleme sayılarını, ek açıklama tıklama oranlarını, ek açıklama kapatma oranlarını ve ek açıklama gösterimlerini alır. Sonuçlar ek açıklama tıklama oranına göre azalan düzende sıralanır. Diğer bir deyişle, en yüksek ek açıklama tıklama oranına sahip ülke ilk sırada listelenir.

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate

ABD eyaletleri ve Washington D.C. için eyaletlere özgü metrikler

Bu istekle birlikte içerik sahibinin hak talebinde bulunulan videoları için görüntüleme sayılarının, tahmini izlenme süresinin ve ortalama görüntüleme süresinin bölgelere göre dökümü alınır. Veriler ABD eyaletlerini ve Washington D.C. eyaletlerini kapsar. Sonuçlar, eyaletlerin ISO 3166-2 kodlarına göre alfabetik olarak sıralanır.

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

Toplam görüntüleme sayısına göre ABD'deki ilk 10 şehir

Bu sorgu, belirtilen tarih aralığında içerik sahibinin hak talebinde bulunulan videolarının en çok görüntülenmesini sağlayan 10 ABD şehrinin listesini getirir. Sorgu, başka bir ülke için veri isteğinde bulunacak şekilde, söz konusu filtre için başka bir geçerli değer seçilerek değiştirilebilir. Benzer şekilde sorgu, subContinent filtresi ve geçerli değerlerinden biri kullanılarak Batı Avrupa veya Güneydoğu Asya gibi bir alt kıtaya ilişkin verileri alacak şekilde değiştirilebilir. Diğer filtreler de desteklenir. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır.

    dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Her içerik türü için toplam görüntüleme sayısına göre ABD'deki ilk 10 şehir

Bu sorgu, desteklenen her creatorContentType için belirtilen tarih aralığında, içerik sahibinin hak talebinde bulunduğu içerikle ilgili en çok görüntüleme sayısını sağlayan 10 ABD şehrinin listesini getirir. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır.

    dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views

Toplam izlenme süresine göre ABD'deki ilk 10 şehir

Bu sorgu, içerik sahibinin hak talebinde bulunulan içeriğinin en yüksek toplam günlük izlenme süresi ABD'deki herhangi bir şehirde olduğu zaman belirtilen tarih aralığında en çok kullanılan 10 günün listesini getirir. Sorgu sonuçları toplam izlenme süresini, izlenme süresinin gerçekleştiği tarihi ve içeriğin görüntülendiği tahmin edilen şehri tanımlar. Sonuçlar, toplam izlenme süresine göre azalan düzende sıralanır.

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

En Popüler 10 - Avrupa'da en çok izlenen videolar

Bu sorgu, içerik sahibinin hak talebinde bulunduğu videolar arasından Avrupa'da en çok izlenen 10 videoyu getirir. Bu videolar, belirtilen tarih aralığındaki görüntüleme sayısıyla ölçülür. Sorgu, başka bir kıta için veri isteğinde bulunacak şekilde, söz konusu filtre için başka bir geçerli değer seçilerek değiştirilebilir. Benzer şekilde sorgu, subContinent filtresi ve geçerli değerlerinden biri kullanılarak Batı Avrupa veya Güneydoğu Asya gibi bir alt kıtaya ilişkin verileri alacak şekilde değiştirilebilir. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır.

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

Oynatma listesi raporları

İçerik sahibinin oynatma listeleri için ülkeye özel izlenme süresi metrikleri

Bu sorgu, içerik sahibinin kanallarındaki tüm oynatma listeleri için ülkeye özel oynatma listesi görüntüleme sayılarını ve oynatma listesi izlenme süresi metriklerini alır. Rapor, oynatma listelerinin izlendiği her ülke için bir veri satırı döndürür. Satırlar, izlenen dakika sayısına göre büyükten küçüğe sıralanır.

dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatched

En Popüler 10 - ABD'de en çok başlatılan oynatma listeleri

Bu sorgu, içerik sahibinin kanallarından, ABD'deki izleyicilerin belirtilen tarih aralığında en sık izlemeye başladığı 10 oynatma listesini getirir. Sonuçlar, oynatma listesi başlatma sayısına göre büyükten küçüğe sıralanır.

Not: Bu raporda playlist boyutu kullanıldığından, sort istek parametresi için bir değer belirtmeniz ve th maxResults parametresini 10 veya daha az bir tam sayı olarak ayarlamanız gerekir.

dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts
Oynatma ayrıntıları

Video raporları

İçerik türüne göre beğeni ve beğenmeme sayısı

Bu sorgu, belirli bir kanal veya kanal grubundaki her bir içerik türü için beğeni ve beğenmeme sayısını getirir. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini, kanallarınız için en fazla 500 kanal kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID
Oynatma konumu

Video raporları

Farklı oynatma konumlarından gelen görüntüleme sayısı ve izlenme süresi

Bu sorgu, belirli bir kanala veya kanal grubuna yüklenen videolar için görüntüleme sayısını ve tahmini izlenme süresini alır. Sonuçlar, video oynatmalarının gerçekleştiği sayfanın veya uygulamanın türüne göre toplanır ve sonuçlar, görüntüleme sayısına göre büyükten küçüğe sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini, kanallarınız için en fazla 500 kanal kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-views

Farklı oynatma konumlarındaki günlük görüntüleme sayıları ve izlenme süresi

Bu sorgu, belirli bir kanala veya kanal grubuna yüklenen videolar için ABD'deki günlük görüntüleme sayılarını ve tahmini izlenme süresini alır. Sonuçlar, video oynatmaların gerçekleştiği her sayfa türü veya uygulama için güne göre gruplandırılır. Sonuçlar ters kronolojik düzende sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini, kanallarınız için en fazla 500 kanal kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-day

İlk 10 – Yerleştirilmiş videolar için en çok görüntüleme sağlayan üçüncü taraf siteleri

Bu sorgu, belirli bir video veya video grubu için görüntüleme sayılarını ve tahmini izlenme süresini alır. Sonuçlar, videonun yerleştirildiği üçüncü taraf sitesine göre gruplandırılır. Sonuçlar, görüntüleme sayısına göre azalan düzende sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki VIDEO_ID dizesini, yüklediğiniz videolar için en fazla 500 video kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views

Oynatma listesi raporları

Oynatma listesi görüntüleme sayısı ve farklı oynatma konumlarından izlenme süresi

Bu sorgu içerik sahibinin kanallarındaki tüm oynatma listeleri için oynatma listesi görüntüleme sayısını, oynatma listesi tahmini izlenme süresini ve oynatma listesi başlatma sayısını alır. Sonuçlar, video oynatıldığı sayfanın veya uygulamanın türüne göre toplanır ve oynatma listesi başlatma sayısına göre büyükten küçüğe sıralanır.

dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts

Oynatma listesi görüntüleme sayısı ve farklı oynatma konumlarından izlenme süresi

Bu sorgu, içerik sahibinin kanallarındaki tüm oynatma listeleri için ABD'deki günlük oynatma listesi başlatma sayısı, oynatma listesi görüntüleme sayısı ve oynatma listesi tahmini izlenme süresini alır. Oynatma listesi görüntülemelerinin gerçekleştiği her sayfa veya uygulama türü için sonuçlar döndürülür.

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched
filters=country==US
Trafik kaynağı

Video raporları

Farklı trafik kaynaklarından gelen görüntüleme sayısı ve izlenme süresi

Bu istek, içerik sahibinin videolarının görüntüleme sayısını ve tahmini izlenme süresini alır. Metrikler, kullanıcıların videoya ulaşma şeklini açıklayan trafik kaynağına göre toplanır.

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

Farklı trafik kaynaklarından gelen günlük görüntüleme sayısı ve izlenme süresi

Bu istek, içerik sahibinin videolarının günlük görüntüleme sayısını ve günlük tahmini izlenme süresini alır. Metrikler trafik kaynağına göre günlük olarak toplanır ve ters kronolojik düzende sıralanır.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

Not: Sonraki iki örnek rapor yalnızca belirli trafik kaynakları için desteklenir. Örneğin, NO_LINK_EMBEDDED trafik kaynağında ek ayrıntılar bulunmadığından, bu kaynak için bu raporlar kullanılamaz. Bu tür raporların kullanılabildiği trafik kaynaklarıyla ilgili ayrıntılar için insightTrafficSourceType tanımına bakın.

İlk 10: Bir video için en fazla trafiği oluşturan YouTube arama terimleri

Bu sorgu, belirli bir video veya video grubu için YouTube arama sonuçlarından en çok görüntüleme sağlayan 10 arama terimini getirir. Sonuçlar, görüntüleme sayısına göre çoktan aza doğru sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki VIDEO_ID dizesini, yüklediğiniz videolar için en fazla 500 video kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-views

İlk 10: Video için en çok trafik oluşturan harici web siteleri

Bu sorgu, belirli bir video veya video grubu için Google arama sonuçlarından en çok görüntüleme sağlayan 10 harici web sitesini getirir. Sonuçlar, tahmini izlenme süresine göre çoktan aza doğru sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki VIDEO_ID dizesini, yüklediğiniz videolar için en fazla 500 video kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched

Oynatma listesi raporları

Bir ülkedeki farklı trafik kaynaklarından gelen oynatma listesi görüntüleme sayısı ve izlenme süresi

Bu istek, belirli bir ülkedeki oynatma listesi görüntülemelerinin sayısını, oynatma listesi başlatma sayısını ve oynatma listesi tahmini izlenme süresini alır. Metrikler, trafik kaynağına göre toplanır. Trafik kaynağı, kullanıcıların oynatma listesine ulaşma biçimini açıklar.

dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==US

Farklı trafik kaynaklarından gelen oynatma listesi görüntüleme sayısı ve izlenme süresi

Bu istek, içerik sahibinin bir veya daha fazla kanalındaki oynatma listeleri için oynatma listesi görüntüleme sayısını, oynatma listesi başlatma sayısını ve oynatma listesi tahmini izlenme süresini alır. Metrikler trafik kaynağına göre toplanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini kanallarınız için en fazla 500 kanal kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID
Cihaz/İşletim Sistemi

Video raporları

Hak talebinde bulunulan videolar için günlük cihaz türü metrikleri

Bu sorgu, belirli bir içerik sahibi tarafından hak talebinde bulunulan videolar için cihaz türüne göre günlük görüntüleme sayılarını ve tahmini izlenme süresini alır. Sonuçlar, video oynatmalarının gerçekleştiği her cihaz türü için güne göre gruplandırılır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

Mobil cihazlarda görüntülenen hak talebinde bulunulan videolarla ilgili günlük işletim sistemi metrikleri

Bu sorgu, belirli bir içerik sahibi tarafından mobil cihazlarda hak talebinde bulunulan videoların görüntüleme sayıları için işletim sistemine göre günlük görüntüleme sayılarını ve tahmini izlenme süresini alır. Sonuçlar, video oynatmalarının gerçekleştiği her işletim sistemi için güne göre gruplandırılır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

Günlük işletim sistemi ve cihaz türü metrikleri

Bu sorgu, belirli bir içerik sahibi tarafından hak talebinde bulunulan videoların günlük görüntüleme sayılarını ve tahmini izlenme süresini alır. İstatistikler, işletim sistemi ve cihaz türüne göre gruplandırılır. Sonuçlar kronolojik düzende sıralanır.

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

Oynatma listesi raporları

Android işletim sisteminde oynatma listesi görüntülemeleri için cihaz türü metrikleri

Bu sorgu, içerik sahibinin bir veya daha fazla kanalındaki oynatma listeleri için Android cihazlardaki oynatma listesi görüntüleme sayılarını ve oynatma listesi tahmini izlenme süresini alır. Oynatma listesi görüntülemelerinin gerçekleştiği her cihaz türü için sonuçlar döndürülür. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini kanallarınız için en fazla 500 kanal kimliği içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROID

Mobil cihazlarda oynatma listesi görüntülemelerine ilişkin işletim sistemi metrikleri

Bu sorgu, içerik sahibinin herhangi bir kanalındaki oynatma listeleri için oynatma listesi görüntüleme sayılarını ve oynatma listesi tahmini izlenme süresini mobil cihazlarda alır. Oynatma listesi görüntülemelerinin gerçekleştiği her işletim sistemi için sonuçlar döndürülür.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
Demografi

Video raporları

Kaliforniya'daki izleyici demografisi (yaş grubu ve cinsiyet)

Bu rapor, içerik sahibinin hak talebinde bulunulan içeriklerini izleyen Kaliforniya'daki izleyicilerin yaş grubu ve cinsiyetiyle ilgili istatistikleri alır. Sonuçlar cinsiyete ve ardından yaş grubuna göre sıralanır. Bu sorgu, filters parametre değeri ayarlanarak dünya genelindeki tüm görüntüleyenler veya bir ülke, kıta, alt kıta ya da başka bir ABD eyaletindeki tüm görüntüleyenler için aynı istatistikleri alacak şekilde değiştirilebilir.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup
Sosyal

Videoların paylaşıldığı hizmete göre toplanan paylaşım metrikleri

Bu istek, kullanıcıların içerik sahibinin yüklediği videoları paylaşmak için Share düğmesini kaç kez kullandığını alır. Sonuçlar paylaşım hizmetine (Google+, Twitter vb.) göre toplanır ve paylaşım sayısına göre büyükten küçüğe sıralanır.

dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares
Kitleyi elde tutma

Bir videonun kitleyi elde tutma metrikleri

Bu rapor, bir videonun kitlesini elde tutma becerisini ölçer. Rapor, bir defada yalnızca tek bir video için alınabilir. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki VIDEO_ID dizesini yüklediğiniz videolardan birinin video kimliğiyle değiştirmeniz gerektiğini unutmayın. Kitleyi elde tutma raporlarının, video filtresi için birden çok değer belirtme özelliğini desteklemediğini unutmayın.

Bu örnekte raporda, yalnızca video araması veya önerilen bir videonun tıklanması gibi doğrudan kullanıcı işlemlerinin sonucu olan organik görüntülemelere ilişkin verileri içerecek şekilde yanıtı kısıtlamak için audienceType filtresi kullanılmaktadır. Bu nedenle rapor, Yayın içi (In-stream) TrueView veya Görüntülü TrueView (TrueView In-display) reklamlarına ait görüntülemelere ilişkin verileri içermez. Tüm kitle türlerinden videonun kitleyi elde tutma verilerini almak için filtreyi kaldırabilirsiniz.

audienceType filtresine ilişkin verilerin 25 Eylül 2013 tarihinden itibaren kullanılabileceğini unutmayın. API, önceki tarihlerden veri almaya çalışmak için filtreyi kullanan sorgular için veri döndürmez. Filtreyi kullanmayan sorgular 1 Temmuz 2008'den sonraki herhangi bir tarih için çalışır.

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
Gelir/Reklamlar

Hak talebinde bulunulan içerikler için gelir ve reklam performansı metrikleri

Bu istek, içerik sahibinin hak talebinde bulunulan içeriğiyle ilgili gelir ve reklam performansı metriklerini alır. Rapor, belirtilen tarih aralığında istenen her metrik için toplamları içeren tek bir veri satırı döndürür.

metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Günlük gelir ve reklam performansı metrikleri

Bu istek, içerik sahibinin hak talebinde bulunulan içeriğiyle ilgili günlük gelir ve reklam performansı metriklerini alır.

dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed

Ülkelere özgü gelir ve reklam performansı metrikleri

Bu istek, içerik sahibinin hak talebinde bulunulan içeriğiyle ilgili ülkeye özgü gelir ve reklam performansı metriklerini alır. Sonuçlar gelir tutarına göre azalan düzende sıralanır. Diğer bir deyişle, listelenen ilk ülke, iş ortağının en yüksek tahmini gelire sahip olduğu ülke olacaktır.

dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenue

İlk 10 - En yüksek gelir sağlayan videolar

Bu istek, içerik sahibinin hak talebinde bulunduğu ve en yüksek geliri sağlayan 10 videonun gelir ve reklam performansı metriklerini alır. Sonuçlar gelir tutarına göre azalan düzende sıralanır. Diğer bir deyişle, ilk video en yüksek tahmini gelire sahip olan video olur.

dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue

Farklı reklam türleri için reklam performansı metrikleri

Bu istek, içerik sahibinin hak talebinde bulunulan içeriğiyle ilgili reklam performansı metriklerini getirir. Sonuçlar reklam türüne göre gruplandırılır. Böylece, farklı reklam türleri arasında gelir ve BGBM değerlerini karşılaştırabilirsiniz.

dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType