Örnek API İstekleri

Bu sayfada örnek YouTube Analytics API istekleri gösterilmektedir. Her örnekte, 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ı dokümanları, API'nin desteklediği raporları tanımlar.)

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

APIs Explorer'a bağlandıktan sonra, raporları aldığınız kanalı veya içerik sahibini belirtmeniz gerekir. API Gezgini, ids parametre değerini tıkladığınız sorguya bağlı olarak channel==MINE veya contentOwner==CONTENT_OWNER_ID ile doldurur. Kanal raporları için 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 yerine içerik sahibi kimliğinizi girmeniz gerekir.

APIs Explorer'ın, OAuth 2.0 kullanarak API isteklerinizi yetkilendirebilmesi için, belirtilen kanal veya içerik sahibi olarak da 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/metrike 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 trafik kaynağı türünden (ör. EXT_URL) belirli bir günde elde edilen 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. Her güne ait sonuç grubu içinde sonuçlar, izlenme sayısına göre azalan düzende sıralanır. Dolayısıyla, sonuç kümesindeki ilk satır, istenen tarih aralığındaki ilk günde en çok görüntüleme alan trafik kaynağına ait verileri içerir. İkinci satır, ilk günde en yüksek ikinci görüntüleme sayısını elde eden trafik kaynağına ilişkin verileri içerir.

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ın içeriğiyle ilgili birleştirilmiş metrikleri 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,averageViewDuration

Bir kanalın ülkeye özel görüntüleme sayıları (ve daha fazlası)

Bu sorgu, bir kanalın videoları için belirli bir ülkeye ait 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=country==US

İlk 10: Bir kanalın en çok izlenen videoları

Bu sorgu, belirtilen tarih aralığındaki tahmini izlenme süresi ölçütüne göre bir kanalın en çok izlenen 10 videosunu alır. Sonuçlar, izlenme süresi tahminine 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 küçük bir tam sayı değerine ayarlamanızı gerektirir.

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

İlk 10 – Bir 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 videosunun 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. Yani en çok görüntülenen video ilk sırada listelenir.

Not: Bu rapor için sort istek parametresi için bir değer belirtmeniz ve maxResults parametresini 10 veya daha düşük bir tam sayı değerine ayarlamanız gerekir.

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

Oynatma listesi raporları

Bir kanalın oynatma listelerinin toplam görüntüleme sayısı

Bu istek, kimliği doğrulanan kullanıcının kanalındaki oynatma listeleri için 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ı bilgilerini alır.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

Belirli bir oynatma listesi için istatistikler

Bu istek, belirli bir oynatma listesi için toplam oynatma listesi başlatma sayısını, tahmini izlenme süresini, görüntülemeleri (toplu video metriği), oynatma listesi görüntülemelerini (oynatma listesi içi metrik) ve oynatma listesi başlatma başına görüntüleme sayısını alır. Bu sorguyu API Explorer'da ç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 listesi için toplu istatistikleri almak istiyorsanız PLAYLIST_ID dizesini, kimliği doğrulanmış kullanıcının kanalındaki oynatma listelerinin kimliklerinin virgülle ayrılmış listesini içeren 500'e kadar öğe içeren bir listeyle de değiştirebilirsiniz.

İlk 10: Bir kanalın en çok izlenen oynatma listeleri

Bu sorgu, belirtilen tarih aralığındaki oynatma listesi görüntüleme sayısına göre bir kanalın en çok izlenen 10 oynatma listesini alır. Ayrıca, izleyicilerin her oynatma listesini başlatma sayısı ve bir izleyicinin oynatma listesi başlatıldıktan sonra oynatma listesindeki videoları izlemek için harcadığı ortalama süre gibi başka oynatma listesi metriklerini de alır. Sonuçlar, oynatma listesi görüntüleme sayısına göre azalan düzende sıralanır.

Not: Bu rapor playlist boyutunu kullandığından sort istek parametresi için bir değer belirtmeniz ve maxResults parametresini 10 veya daha düşük bir tam sayı değerine ayarlamanız gerekir.

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

Video raporları

Kanalın videolarına ait 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ı getirir. Rapor, istenen tarih aralığındaki her gün için bir veri satırı döndürür. Satırlar kronolojik olarak sıralanır.

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

Kanalın videolarıyla ilgili 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 sıraya göre sıralanır.

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

Oynatma listesi raporları

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

Bu istek, kimliği doğrulanan 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üleme sayısı (oynatma listesi içi metrik), oynatma listesi başlatma sayısı, tahmini izleme dakikaları ve oynatma listesi başlatma başına görüntüleme sayısı bilgilerini alır. Sonuçlar kronolojik sıraya göre sıralanır.

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

Video raporları

Bir kanalın videolarına ait ülkeye özel izlenme süresi metrikleri

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

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

Bir kanalın videoları için ülkeye özgü ek açıklama metrikleri

Bu istek, kanalın videolarına ait ülkeye özel 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. Yani ek açıklama tıklama oranının en yüksek olduğu ülke önce listelenir.

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

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

Bu istek, kanaldaki videoların görüntüleme sayılarının, tahmini izlenme dakikalarının ve ortalama görüntüleme süresinin il bazında dökümünü alır. Veriler ABD eyaletlerini ve Washington D.C.'yi kapsar. Sonuçlar, illerin 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 izlenen videolar

Bu sorgu, belirli bir ülkedeki kanalın belirtilen tarih aralığındaki görüntüleme sayısına göre en çok görüntülenen 10 videosunu alır. Sonuçlar görüntüleme sayısına göre azalan düzende sıralanır.

Not: Bu rapor için sort istek parametresi için bir değer belirtmeniz ve maxResults parametresini 10 veya daha düşük bir tam sayı değerine ayarlamanız gerekir.

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

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

Bu sorgu, belirtilen tarih aralığında kanal içeriğinin en çok görüntülendiği 10 ABD şehrinin listesini getirir. Sorgu, ilgili filtre için başka bir geçerli değer seçerek başka bir ülke için veri isteyecek şekilde değiştirilebilir. Benzer şekilde, sorgu altkıta filtresi ve geçerli değerlerinden biri kullanılarak Batı Avrupa veya Güneydoğu Asya gibi bir alt kıtayla ilgili verileri alacak şekilde değiştirilebilir. Diğer filtreler de desteklenir. Sonuçlar görüntüleme sayısına göre büyükten küçüğe 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 en popüler 10 şehir

Bu sorgu, desteklenen her creatorContentType için belirtilen tarih aralığında kanal içeriğinin en fazla görüntülenmeyi sağlayan ABD'deki 10 şehrinin bir listesini getirir. Sonuçlar görüntüleme sayısına göre azalan düzende sıralanır.

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

Toplam izlenme süresine göre ABD'deki en popüler 10 şehir

Bu sorgu, belirtilen tarih aralığında kanal içeriğinin en yüksek toplam günlük izlenme süresi ABD'deki bir şehir olduğunda en iyi performans gösteren 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 tahmini olarak görüntülendiği ş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

İlk 10: Avrupa'da en çok izlenen videolar

Bu sorgu, belirtilen tarih aralığındaki görüntüleme sayısına göre kanalın Avrupa'da en çok izlenen 10 videosunu alır. Sorgu, söz konusu filtre için başka bir geçerli değer seçerek başka bir kıta için veri isteyecek şekilde değiştirilebilir. Benzer şekilde, sorgu altkıta filtresi ve geçerli değerlerinden biri kullanılarak Batı Avrupa veya Güneydoğu Asya gibi bir alt kıtayla ilgili verileri alacak şekilde değiştirilebilir. Sonuçlar görüntüleme sayısına göre azalan düzende sıralanır.

Not: Bu rapor için sort istek parametresi için bir değer belirtmeniz ve maxResults parametresini 10 veya daha düşük bir tam sayı değerine ayarlamanız gerekir.

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 özel izlenme süresi metrikleri

Bu sorgu, ülkeye özgü görüntüleme sayılarını (toplu video metriği), oynatma listesi görüntülemelerini (oynatma listesi metriği) ve kanalın oynatma listelerinin 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 iyi 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 alır. Sonuçlar, oynatma listesi başlatma sayısına göre azalan düzende sıralanır.

Not: Bu rapor playlist boyutunu kullandığından sort istek parametresi için bir değer belirtmeniz ve maxResults parametresini 10 veya daha küçük bir tam sayı değerine 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ındaki görüntüleme sayıları ve izlenme süresi

Bu sorgu, belirli bir kanalın videolarının görüntüleme sayısını ve tahmini izlenme süresini alır. Sonuçlar, video oynatma işlemlerinin gerçekleştiği sayfa veya uygulamanın türüne göre toplanır ve görüntüleme sayısına göre azalan düzende sıralanır.

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

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

Bu sorgu, ABD'de belirli bir kanalın videoları için günlük görüntüleme sayılarını ve tahmini izlenme süresini alır. Sonuçlar, video oynatma işlemlerinin 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=estimatedMinutesWatched,views
filters=country==US
sort=day

İlk 10: Yerleştirilmiş bir video için en çok görüntüleme sağlayan üçüncü taraf siteler

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 videolara ait 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ı

Farklı oynatma konumlarından oynatma listesi görüntüleme sayıları ve 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ını getirir. Sonuçlar, video oynatma işlemlerinin gerçekleştiği sayfa veya uygulamanın türüne göre toplanır ve oynatma listesi başlatma sayısına göre azalan düzende sıralanır.

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

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

Bu sorgu, belirli bir kanalın oynatma listeleri için ABD'de oynatma listesi başlatma sayısını, 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 listesi görüntülemelerinin gerçekleştiği her sayfa veya uygulama türüne göre güne göre gruplandırılır. Sonuçlar kronolojik sırada 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ıları 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 tanımlayan 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ıları ve izlenme süresi

Bu istek, kanalın videolarının günlük izlenme 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 sıraya göre 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 belirli videonun YouTube arama sonuçlarında en çok görüntüleme alan 10 arama terimini alı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 en fazla 500 video kimliğini 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 VIDEO_ID yerine o video için en fazla trafik oluşturan arama terimlerini tanımlayabilirsiniz. Ayrıca belirli bir oynatma listesindeki videolar için hangi arama terimlerinin en fazla trafiği oluşturduğunu belirlemek üzere tüm videoları listeleyebilirsiniz.

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

İlk 10: Bir video için en fazla trafiği oluşturan harici web siteleri

Bu sorgu, belirli bir video veya video grubu için en çok görüntüleme alan 10 harici web sitesini alır. Sonuçlar, tahmini izlenme süresine 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üklenen videolarınıza ait 500'e kadar video kimliğinin virgülle ayrılmış listesi ile 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ıları ve izlenme süresi

Bu istek, belirli bir ülkedeki oynatma listesi görüntüleme sayısı 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), oynatma listesi başlatma sayısı ve tahmini izlenme süresi alır. Metrikler, kullanıcıların oynatma listesine ulaşma şeklini tanımlayan trafik kaynağına göre toplanır.

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

Farklı trafik kaynaklarından gelen oynatma listesi günlük 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 getirir. Ayrıca toplam görüntüleme sayısını (toplu video metriği) alır. Metrikler, trafik kaynağına göre günlük olarak toplanır ve kronolojik sıraya göre ayarlanır.

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day
Cihaz/OS

Video raporları

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

Bu sorgu, belirli bir kanalın videolarının Android cihazlarda günlük görüntüleme sayısını ve tahmini izlenme süresini alır. Sonuçlar, video oynatma işlemlerinin gerçekleştiği her cihaz türü için güne göre gruplandırılır. Sonuçlar kronolojik olarak 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 mobil cihazlarda günlük görüntüleme sayılarını ve tahmini izlenme süresini alır. Sonuçlar, video oynatma işlemlerinin gerçekleştiği her işletim sistemi için güne göre gruplandırılır. Sonuçlar kronolojik sıraya göre 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ın günlük görüntüleme sayısı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 sıraya göre sıralanır.

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

Oynatma listesi raporları

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

Bu sorgu, belirli bir kanalın oynatma listelerinin 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 metriği) ve tahmini izlenme süresini alır. Sonuçlar, oynatma listesi görüntülemelerinin gerçekleştiği her cihaz türüne göre güne göre gruplandırılır. Sonuçlar kronolojik olarak sıralanır.

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

Mobil cihazlarda oynatma listesi görüntüleme sayısına göre 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 cihazlarda oynatma listelerinin 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 sıraya göre sıralanır.

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

Video raporları

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

Bu rapor, Kaliforniya'da kanalın videolarını izleyen kullanıcıların yaş grubu ve cinsiyetiyle ilgili istatistikleri getirir. Sonuçlar önce cinsiyete, ardından yaş grubuna göre sıralanır. Bu sorgu, filters parametre değeri ayarlanarak dünya genelindeki tüm izleyiciler veya bir ülkedeki, kıtadaki, alt kıtadaki ya da ABD'deki başka bir eyaletteki tüm izleyiciler 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'daki oynatma listesi izleyicilerinin demografisi (yaş grubu ve cinsiyet)

Bu rapor, Kaliforniya'da kanalın oynatma listelerini izleyen izleyicilere ait yaş grubu ve cinsiyet istatistiklerini 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 izleyiciler veya bir ülkedeki, kıtadaki, alt kıtadaki ya da ABD'deki başka bir eyaletteki tüm izleyiciler 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ığını gösterir. Sonuçlar, paylaşım hizmeti (Google+, Twitter vb.) tarafından toplanır ve paylaşım sayısına göre azalan düzende sıralanır.

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

Videoların kitleyi elde tutma metrikleri

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

Bu örnekte rapor, yanıtı yalnızca bir video araması veya önerilen bir videonun tıklanması gibi doğrudan kullanıcı işleminin bir sonucu olan organik görüntülemelere ilişkin verileri içerecek şekilde kısıtlamak için audienceType filtresini kullanmaktadır. Bu nedenle, raporda TrueView yayın içi veya TrueView görüntülü reklamlardan elde edilen görüntülemelerle ilgili veriler yer almaz. Videonun tüm kitle türlerindeki kitleyi elde tutma verilerini almak için filtreyi kaldırabilirsiniz.

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

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 getirir.

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

Ülkeye özgü gelir ve reklam performansı metrikleri

Bu istek, bir kanalın ülkeye özel 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 geliri sağlayan videolar

Bu istek, kanalın en yüksek gelire sahip 10 videosunun gelir ve reklam performansı metriklerini alır. Sonuçlar, gelir tutarına göre azalan düzende sıralanır. Yani ilk video, en yüksek tahmini gelire sahip olan video olacaktır.

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 bulunduğu içerikle ilgili reklam performansı metriklerini alır. Sonuçlar reklam türüne göre gruplandırılır. Bu sayede farklı reklam türlerindeki 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çeriklerle ilgili toplam görüntüleme sayısı, tahmini izlenme süresi ve daha fazlası

Bu sorgu, içerik sahibinin hak talebinde bulunduğu içerikle ilgili birleştirilmiş metrikleri 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,averageViewDuration
filters=claimedStatus==claimed

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

Bu sorgu, içerik sahibinin yüklediği videolarla ilgili belirli bir ülkeye ait metrikleri 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 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==thirdParty;claimedStatus==claimed

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

Bu sorgu, içerik sahibinin yüklediği videolarla ilgili birleştirilmiş metrikleri alır. Rapor, belirtilen tarih aralığında talep edilen 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 ve kendi yüklediğiniz 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 videolarla ilgili toplu metrikleri 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=uploaderType==self;claimedStatus==claimed

En popüler 10: İçerik sahibinin en çok görüntülenen videoları

Bu sorgu, içerik sahibinin yüklediği ve belirtilen tarih aralığındaki görüntüleme sayısına göre en çok görüntülenen 10 videoyu alır. Sonuçlar görüntüleme sayısına göre büyükten küçüğe sıralanır.

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

İlk 10: İçerik sahipleri için en çok izlenen video

Bu sorgu, içerik sahibinin yüklediği ve belirtilen tarih aralığında izlenen tahmini dakika sayısına göre ölçülen en çok izlenen 10 videoyu alır. Sonuçlar, izlenme süresi tahminine 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 videolar

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 azalan düzende sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini, kanallarınıza ait 500'e kadar kanal kimliğinin virgülle ayrılmış listesi ile 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ının ek açıklama tıklama oranları

Bu istek, belirtilen bir kanalda veya kanal grubunda en çok görüntülenen 10 videonun görüntüleme sayısını, ek tıklama oranlarını, ek kapatma oranlarını ve ek gösterimlerini alır. Sonuçlar, görüntüleme sayısına göre azalan düzende sıralanır. Yani en çok görüntülenen video ilk sırada listelenir. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini kanallarınıza ait en fazla 500 kanal kimliğini 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ının oynatma listesi görüntüleme sayısı

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

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

Belirli bir oynatma listesi için istatistikler

Bu istek, belirli bir oynatma listesi için toplam oynatma listesi başlatma sayısını, tahmini izlenme süresini, görüntülemeleri (toplu video metriği), oynatma listesi görüntülemelerini (oynatma listesi içi metrik) ve oynatma listesi başlatma başına görüntüleme sayısını alır. 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 listesi için toplu istatistikleri almak istiyorsanız PLAYLIST_ID dizesini, içerik sahibinin kanallarındaki oynatma listelerinin 500'e kadar kimliğinin virgülle ayrılmış listesi ile 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 sıraya göre dizilir.

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

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

Bu istek, içerik sahibinin hak talebinde bulunduğu içerik 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 sıraya göre sıralanır.

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

Oynatma listesi raporları

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

Bu istek, kullanıcıların içerik sahibinin oynatma listelerindeki videolarla günlük etkileşimlerine dair metrikleri alır. Raporda alınan metrikler playlistViews, playlistStarts, playlistEstimatedMinutesWatched ve viewsPerPlaylistStart'tır. Bu metriklerin tümü oynatma listesi içi metriklerdir. İstenen tüm metriklerin oynatma listesi içi metrikler olduğundan, isteğin aynı zamanda oynatma listesi veya grup filtresini de içermesine gerek yoktur.

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

Video raporları

Kullanıcı tarafından yüklenen içerikler için ülkeye özel izlenme süresi metrikleri

Bu sorgu, her ülke için görüntüleme sayısını, izlenme süresi metriklerini ve tahmini reklam gelirini alır. Metrikler, içerik sahibinin yüklediği videolar içindir. Rapor, videoları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,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched

Kullanıcı tarafından yüklenen içerikler için ülkeye özel ek açıklama metrikleri

Bu istek, içerik sahibinin yüklediği videoların ülkeye özgü görüntüleme sayılarını, ek tıklama oranlarını, ek kapatma oranlarını ve ek 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 eyalete özgü metrikler

Bu istek, içerik sahibinin hak talebinde bulunduğu videoların görüntüleme sayılarının, tahmini izlenen dakika sayısının ve ortalama görüntüleme süresinin il bazında dökümünü alır. Veriler ABD eyaletlerini ve Washington D.C.'yi kapsar. Sonuçlar, illerin 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 en popüler 10 şehir

Bu sorgu, içerik sahibinin hak talebinde bulunduğu videoların belirtilen tarih aralığında en çok görüntülendiği 10 ABD şehrinin listesini alır. Sorgu, ilgili filtre için başka bir geçerli değer seçerek başka bir ülke için veri isteyecek şekilde değiştirilebilir. Benzer şekilde, sorgu altkıta filtresi ve geçerli değerlerinden biri kullanılarak Batı Avrupa veya Güneydoğu Asya gibi bir alt kıtayla ilgili verileri alacak şekilde değiştirilebilir. Diğer filtreler de desteklenir. Sonuçlar görüntüleme sayısına göre azalan düzende 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 en popüler 10 şehir

Bu sorgu, desteklenen her creatorContentType için belirtilen tarih aralığında içerik sahibinin hak talebinde bulunduğu içeriğin en çok görüntülendiği 10 ABD şehrinin listesini alır. Sonuçlar görüntüleme sayısına göre büyükten küçüğe 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 en popüler 10 şehir

Bu sorgu, belirtilen tarih aralığında içerik sahibinin hak talebinde bulunulan içeriği için en yüksek toplam günlük izlenme süresi ABD'deki herhangi bir şehir tarafından sağlandığında en iyi 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ülenebilir olduğu tahmin edilen şehri tanımlar. Sonuçlar, toplam izlenme süresi azalan düzende sıralanır.

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

Top 10 – Avrupa'da en çok izlenen videolar

Bu sorgu, içerik sahibi tarafından hak talebinde bulunulan videolar arasından, belirtilen tarih aralığındaki görüntüleme sayısına göre Avrupa'da en çok izlenen 10 videoyu alır. Sorgu, söz konusu filtre için başka bir geçerli değer seçerek başka bir kıta için veri isteyecek şekilde 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 ait verileri alacak şekilde değiştirilebilir. Sonuçlar görüntüleme sayısına göre azalan düzende 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 özgü oynatma listesi görüntüleme sayılarını ve oynatma listesi izlenme süresi metriklerini getirir. 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 azalan düzende sıralanır.

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

En iyi 10: ABD'de en çok başlatılan oynatma listeleri

Bu sorgu, içerik sahibinin kanallarındaki ABD'deki izleyicilerin belirtilen tarih aralığında en sık izlemeye başladığı 10 oynatma listesini alır. Sonuçlar, oynatma listesi başlatma sayısına göre azalan düzende sıralanır.

Not: Bu rapor playlist boyutunu kullandığından sort istek parametresi için bir değer belirtmeniz ve maxResults parametresini 10 veya daha düşük bir tam sayı değerine 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ğenilen ve beğenilmeyen içerikler

Bu sorgu, belirli bir kanaldaki veya kanal grubundaki her içerik türünün beğeni ve beğenmeme sayısını alır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini, kanallarınıza ait 500'e kadar kanal kimliğinin virgülle ayrılmış listesi ile 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ıları ve izlenme süresi

Bu sorgu, belirli bir kanala veya kanal grubuna yüklenen videoların 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 azalan düzende sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini kanallarınıza ait en fazla 500 kanal kimliğini 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ından elde edilen günlük görüntüleme sayıları ve izlenme süresi

Bu sorgu, belirli bir kanala veya kanal grubuna yüklenen videoların ABD'deki günlük görüntüleme sayısını ve tahmini izlenme süresini alır. Sonuçlar, video oynatmalarının gerçekleştiği her sayfa veya uygulama türü için güne göre gruplandırılır. Sonuçlar, ters kronolojik sırayla sıralanır. Bu sorguyu API Gezgini'nde çalıştırmak için filters parametre değerindeki CHANNEL_ID dizesini kanallarınıza ait en fazla 500 kanal kimliğini 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ş bir video için en çok görüntüleme sağlayan üçüncü taraf siteler

Bu sorgu, belirli bir videonun veya video grubunun görüntüleme sayısı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üklenen videolarınıza ait 500'e kadar video kimliğinin virgülle ayrılmış listesi ile 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ıları ve farklı oynatma konumlarındaki izlenme süreleri

Bu sorgu, içerik sahibinin kanallarındaki tüm oynatma listelerinin 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 oynatma işlemlerinin gerçekleştiği sayfa veya uygulamanın türüne göre toplanır ve oynatma listesi başlangıçlarına göre azalan düzende sıralanır.

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

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

Bu sorgu, içerik sahibinin kanallarındaki tüm oynatma listeleri için ABD'de oynatma listelerinin günlük başlatma sayısını, oynatma listesi görüntüleme sayısını ve oynatma listelerinin 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 döndürülür.

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

Video raporları

Farklı trafik kaynaklarından 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 tanımlayan 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ıları 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 sıraya göre 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. VIDEO_REMIXES, NOTIFICATION, END_SCREEN, CAMPAIGN_CARD, VIDEO_REMIXES ve NO_LINK_EMBEDDED trafik kaynakları desteklenmeyen kaynaklardan bazılarıdır.

İ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ında en çok görüntüleme alan 10 arama terimini alı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üklenen videolarınıza ait 500'e kadar video kimliğinin virgülle ayrılmış listesi ile değiştirmeniz gerektiğini unutmayın.

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

İlk 10: Bir videoya en çok trafik getiren harici web siteleri

Bu sorgu, belirli bir video veya video grubu için Google arama sonuçlarından en fazla görüntüleme sağlayan 10 harici web sitesini getirir. Sonuçlar, tahmini izlenme süresine 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 videolara ait en fazla 500 video kimliğinin yer aldığı 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ıları 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, kullanıcıların oynatma listesine nasıl ulaştığını tanımlayan trafik kaynağına göre toplanır.

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

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

Bu istek, içerik sahibinin bir veya daha fazla kanalındaki oynatma listelerinin görüntüleme sayısını, oynatma listelerinin başlatılma sayısını ve oynatma listelerinin 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ıza ait 500 adede kadar kanal kimliğinin virgülle ayrılmış listesi ile 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 sahibinin hak talebinde bulunduğu videoların günlük görüntüleme sayısını ve cihaz türüne göre tahmini izlenme süresini alır. Sonuçlar, video oynatma işlemlerinin gerçekleştiği her cihaz türü için güne göre gruplandırılır. Sonuçlar kronolojik sıraya göre sıralanır.

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

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

Bu sorgu, belirli bir içerik sahibi tarafından hak talebinde bulunulan videoların mobil cihazlarda görüntüleme sayısı 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 oynatma işlemlerinin gerçekleştiği her işletim sistemi için güne göre gruplandırılır. Sonuçlar kronolojik sıraya göre 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ısı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 sıraya göre sıralanır.

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

Oynatma listesi raporları

Android işletim sistemindeki oynatma listesi görüntüleme sayısına göre cihaz türü metrikleri

Bu sorgu, içerik sahibinin bir veya daha fazla kanalındaki oynatma listelerinin Android cihazlardaki oynatma listesi görüntüleme sayılarını ve oynatma listesi tahmini izlenme süresini alır. Sonuçlar, oynatma listesi görüntülemelerinin gerçekleştiği her cihaz türü için 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ın en fazla 500 kanal kimliğini 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üleme sayısıyla ilgili işletim sistemi metrikleri

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

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

Video raporları

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

Bu rapor, içerik sahibinin hak talebinde bulunduğu içeriği izleyen Kaliforniya'daki izleyicilere ait yaş grubu ve cinsiyet istatistiklerini alır. Sonuçlar önce cinsiyete, ardından yaş grubuna göre sıralanır. Bu sorgu, filters parametre değeri ayarlanarak dünya genelindeki tüm izleyiciler veya bir ülkedeki, kıtadaki, alt kıtadaki ya da ABD'deki başka bir eyaletteki tüm izleyiciler 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ı gösterir. Sonuçlar, paylaşım hizmeti (Google+, Twitter vb.) tarafından toplanır ve paylaşım sayısına göre azalan düzende sıralanır.

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

Videoların kitleyi elde tutma metrikleri

Bu rapor, bir videonun kitleyi elde tutma oranını ölçer. Rapor aynı anda 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üklenen videolarınızdan birinin video kimliğiyle değiştirmeniz gerektiğini unutmayın. Kitleyi elde tutma raporlarının, video filtresi için birden fazla değer belirtme özelliğini desteklemediğini unutmayın.

Bu örnekte rapor, yanıtı yalnızca bir video araması veya önerilen bir videonun tıklanması gibi doğrudan kullanıcı işleminin bir sonucu olan organik görüntülemelere ilişkin verileri içerecek şekilde kısıtlamak için audienceType filtresini kullanmaktadır. Bu nedenle rapor, yayın içi TrueView veya TrueView görüntülü reklamlardan elde edilen görüntülemelerle ilgili verileri içermez. Videonun tüm kitle türlerindeki kitleyi elde tutma verilerini almak için filtreyi kaldırabilirsiniz.

audienceType filtresiyle ilgili verilerin 25 Eylül 2013'ten itibaren kullanılabileceğini unutmayın. API, önceki tarihlere ait verileri almaya çalışmak için filtreyi kullanan sorgulara ait verileri döndürmez. 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ğinin gelir ve reklam performansı metriklerini 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,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 bulunduğu içerik için 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

Ülkeye özgü gelir ve reklam performansı metrikleri

Bu istek, içerik sahibinin hak talebinde bulunulan içeriği için ülkeye özgü gelir ve reklam performansı metriklerini getirir. Sonuçlar, gelir tutarına göre azalan düzende sıralanır. Bu nedenle, listelenen ilk ülke, iş ortağının en yüksek tahmini gelir elde ettiği ülke olur.

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

İlk 10: En yüksek geliri sağlayan videolar

Bu istek, içerik sahibi tarafından hak talebinde bulunulan ve en yüksek geliri elde eden 10 videonun gelir ve reklam performansı metriklerini alır. Sonuçlar, gelir tutarına göre azalan düzende sıralanır. Yani ilk video, en yüksek tahmini gelire sahip olan video olacaktır.

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ğinin reklam performansı metriklerini getirir. Sonuçlar reklam türüne göre gruplandırılır. Bu sayede farklı reklam türlerindeki gelir ve BGBM değerlerini karşılaştırabilirsiniz.

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