Örnek API İstekleri

Bu sayfada örnek YouTube Analytics API istekleri gösterilmektedir. Her örnek, alınan raporu kısaca açıklar ve ardından ilgili dimensions, metrics, filters ve sort parametre değerlerini gösterir. (Kanal raporları ve içerik sahibi raporları dokümanları, API'nin desteklediği raporları tanımlar.)

Her örnek, Google API Gezgini'ne bağlantı oluşturur 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.

API Gezgini'ne bağlandıktan sonra da raporlarını 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ı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 yerine içerik sahibi kimliğinizi girmeniz gerekir.

API Gezgini'nin 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/metriğe göre sıralama

API, birden fazla boyut veya metrik kullanarak yanıt verilerini sıralama özelliğini destekler. Örneğin, aşağıdaki istek, belirli bir kanalın videoları için 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. Dolayısıyla, sonuç kümesindeki ilk satır, istenen tarih aralığının ilk gününde en çok görüntüleme alan trafik kaynağına ait verileri içerir. İkinci satır, ilk gün sonraki en yüksek görüntüleme sayısını oluşturan trafik kaynağına ait 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 içeriğiyle ilgili toplu metrikleri getirir. 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,averageViewDuration

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

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

İlk 10 - Kanalda en çok izlenen video

Bu sorgu, bir kanalın en çok izlenen 10 videosunu getirir. Bu videolar, belirtilen tarih aralığında dakika cinsinden tahmini izlenme süresine göre ölçülür. Sonuçlar, dakika cinsinden tahmini izleme 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 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 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 ilk sıralarda yer alacağı anlamına gelir.

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=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views

Oynatma listesi raporları

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

Bu istek toplam oynatma listesi başlatma sayısı, tahmini izlenme süresi, görüntüleme sayısı ( toplu video metriği) kullandığınızdan emin olun. oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), sayısı ve görüntüleme sayısıdır.

metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart

Belirli bir oynatma listesiyle ilgili istatistikler

Bu istek toplam oynatma listesi başlatma sayısı, tahmini izlenme süresi, görüntüleme sayısı ( toplu video metriği) kullandığınızdan emin olun. oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), görüntüleme sayısını artırabilirsiniz. Bu sorguyu API'lerde çalıştırmak için filters içindeki PLAYLIST_ID dizesini değiştirmeniz gerekir parametre değeri, kimliği doğrulanan kullanıcının kanalındaki bir oynatma listesinin oynatma listesi kimliğiyle birlikte kullanılır.

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

Birden fazla oynatma listesine ilişkin toplu istatistikleri almak için PLAYLIST_ID dizesini, kimliği doğrulanmış kullanıcının kanalındaki oynatma listeleri için 500 adede kadar oynatma listesi kimliğini içeren virgülle ayrılmış bir listeyle de değiştirebilirsiniz.

İlk 10: Kanalın en çok izlenen oynatma listesi

Bu sorgu, bir kanalın en çok izlenen 10 oynatma listesini getirir (oynatma listesi görüntüleme sayısına göre ölçülür) olduğunu unutmayın. Birçok başka oynatma listesi metriğini de getirir. Örneğin, izleyicilerin her bir oynatma listesini kaç kez oynatmaya başladığı ve Bir izleyicinin oynatma listesi başlatıldıktan sonra oynatma listesindeki videoları izlediği süredir. Sonuçlar 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 küçük bir tam sayı değerine ayarlamanız gerekir.

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

Video raporları

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

Bu sorgu, bir kanalın videolarına ait 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

Bir kanalın videolarına ait 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 olarak 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, günlük görüntüleme sayılarını ( toplu video metriği) kullandığınızdan emin olun. oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), kimliği doğrulanmış oynatma listesi başlatma sayısı, tahmini izlenme süresi ve oynatma listesi başına görüntüleme sayısı kanal. Sonuçlar kronolojik olarak sıralanır.

dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day
'nı inceleyin.
Coğrafi

Video raporları

Kanalın 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ı getirir. Rapor, kanaldaki videoları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ı 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 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 eyaletlere 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. Bu videolar, belirtilen tarih aralığında belirli bir ülkedeki izlenme sayısıyla ölçülür. Sonuçlar görüntüleme sayısına göre büyükten küçüğe 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=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, başka bir ülke için veri istemek üzere, 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 ait 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 ilk 10 ABD şehri

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 büyükten küçüğe sıralanır.

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

Toplam izlenme süresine göre ilk 10 ABD şehri

Bu sorgu, belirtilen tarih aralığında kanal içeriğinin en büyük 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 görüntülendiğini tahmin ettiğ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

Avrupa'da en çok görüntülenen ilk 10 video

Bu sorgu, kanalın Avrupa'da en çok görüntülenen 10 videosunu getirir. Video, belirtilen tarih aralığındaki görüntüleme sayısıyla ölçülür. Sorgu, başka bir kıta için veri istemek üzere, 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 ait verileri alacak şekilde değiştirilebilir. Sonuçlar görüntüleme sayısına göre büyükten küçüğe 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=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views

Oynatma listesi raporları

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) kullandığınızdan emin olun. oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), izlenme süresi metriklerini görebilirsiniz. Rapor, her biri için bir veri satırı döndürür Kanaldaki oynatma listelerinin izlendiği ülke. Satırlar, dakika sayısına göre azalan düzende sıralanır.

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

İlk 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 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
'nı inceleyin.
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ı için görüntüleme sayısını ve tahmini izlenme süresini getirir. 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.

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

Farklı oynatma konumlarında günlük izlenme sayısı 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 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 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 fazla görüntülemeyi 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ı

Oynatma listesi görüntüleme sayıları ve farklı oynatma konumlarındaki izlenme süreleri

Bu sorgu, görüntüleme sayılarının (bir toplu video metriği) kullandığınızdan emin olun. oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), tahmini izlenme süresini ve oynatma listesi başlatma sayısını temel 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, oynatma listesi başlatma sayısına göre azalan düzende sıralanır.

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

Oynatma listesinin günlük izlenme sayısı ve farklı oynatma konumlarındaki izlenme süresi

Bu sorgu, günlük oynatma listesi başlatma sayısını, görüntüleme sayılarını ( toplu video metriği) kullandığınızdan emin olun. oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), ve belirli bir kanalın oynatma listeleri için Amerika Birleşik Devletleri'nde tahmini izlenme süresini gösterir. 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 düzende sıralanır.

dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day
'nı inceleyin. 'nı inceleyin.
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 getirir. Metrikler, kullanıcıların videoya erişme ş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ıları ve izlenme süresi

Bu istek, kanalın videoları için günlük görüntüleme sayıları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, belirli bir veya daha fazla video için YouTube arama sonuçlarından en fazla görüntüleme sağlayan 10 arama terimini getirir. 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 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, tek bir video için sorgu çalıştırabilir veya bu video için en fazla trafiği oluşturan arama terimlerini belirlemek üzere VIDEO_ID değerini değiştirebilirsiniz. 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 fazla görüntülemeyi oluşturan 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ısı ve izlenme süresi

Bu istek, görüntüleme sayısını ( toplu video metriği) kullandığınızdan emin olun. oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), oynatma listesi başlatma sayısı ve belirli bir ülkedeki oynatma listesi görüntüleme sayısı için tahmini izlenme süresi gibi bilgileri içerir. İlgili içeriği oluşturmak için kullanılan metrikler, kullanıcıların oynatma listesine nasıl eriştiğini açıklayan trafik kaynağına göre toplanır.

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

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

Bu istek, bir kanalın günlük oynatma listesi görüntüleme sayısını ( oynatma listesi içi metriği) oynatma listesi başlatma sayısı ve tahmini izlenme süresi gibi metrikleri içerir. Ayrıca toplam görüntüleme sayısını ( toplu video metriği). 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,playlistStarts,playlistViews
sort=day
'nı inceleyin.
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 cihazlarda 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 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 oynatmalarının gerçekleştiği her işletim sistemi için güne göre gruplandırılır. Sonuçlar kronolojik olarak 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, kanalın günlük görüntüleme sayısını ve tahmini izlenme süresini getirir. İstatistikler, işletim sistemi ve cihaz türüne göre gruplandırılır. Sonuçlar kronolojik olarak sıralanır.

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

Oynatma listesi raporları

Android işletim sistemindeki oynatma listesi görüntülemeleriyle ilgili günlük cihaz türü metrikleri

Bu sorgu, günlük görüntüleme sayısını ( toplu video metriği) kullandığınızdan emin olun. oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), ve belirli bir kanalın oynatma listeleri için Android cihazlardaki tahmini izlenme süresini gösterir. Sonuçlar oynatma listesi görüntülemelerinin 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=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, günlük görüntüleme sayısını ( toplu video metriği) kullandığınızdan emin olun. oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), ve belirli bir kanalın oynatma listeleri için mobil cihazlarda tahmini izlenme süresidir. Sonuçlar oynatma listesi görüntülemelerinin gerçekleştiği her işletim sistemi için güne göre gruplanır. Sonuçlar kronolojik olarak sıralanır.

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day
'nı inceleyin.
Demografi

Video raporları

Kaliforniya'daki izleyici 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 görüntüleyenler ya da bir ülke, kıta, alt kıta veya başka bir ABD eyaletinde bulunan tüm görüntüleyenler için aynı istatistikleri almak üzere değiştirilebilir.

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

Oynatma listesi raporları

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

Bu rapor, Kaliforniya'da ikamet eden ve kanalın oynatma listelerini izlemiştir. Sonuçlar önce cinsiyete, ardından yaş grubuna göre sıralanır. Bu sorgusu, dünya genelindeki tüm görüntüleyenler veya tüm görüntüleyenler için aynı istatistikleri almak üzere değiştirilebilir filters parametre değerini ayarlayarak bir ülke, kıta, alt kıta veya başka bir ABD eyaletindeki görüntüleyen kullanıcılar.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup
'nı inceleyin.
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
'nı inceleyin.
Kitleyi elde tutma

Bir video için kitleyi elde tutma metrikleri

Bu rapor, videonun kitleyi elde tutma becerisini ö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ü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 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 (In-stream) TrueView veya Görüntülü (In-display) TrueView reklamlarının görüntüleme verilerini içermez. Videonun kitleyi elde tutma verilerini tüm kitle türlerinden almak için filtreyi kaldırabilirsiniz.

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

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
'nı inceleyin.
Gelir/Reklamlar

Kanal geliri ve reklam performansı metrikleri

Bu istek, kanalın gelir ve reklam performansı metriklerini getirir. 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,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, kanalın ülkeye özgü gelir ve reklam performansı metriklerini getirir. 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 gelire sahip videolar

Bu istek, kanalın en yüksek gelire sahip 10 videosundan gelir ve reklam performansı metriklerini getirir. 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 bulunulan içeriğinin reklam performansı metriklerini getirir. Sonuçlar reklam türüne göre gruplandırılır. Böylece, 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 bulunulan içeriğine ait toplu metrikleri getirir. 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,averageViewDuration
filters=claimedStatus==claimed

Kendi yüklediğiniz tüm videoların ülkeye özel izlenme sayısı (ve daha fazlası)

Bu sorgu, içerik sahibinin yüklediği videolar için belirli bir ülkeye ait metrikleri getirir. 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,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 talep edilen 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 toplu metrikleri getirir. 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, kendi kendine yüklenen tüm içerikler için 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 getirir. 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;claimedStatus==claimed

İlk 10: İçerik sahibi için en çok görüntülenen video

Bu sorgu, içerik sahibinin yüklediği ve en çok görüntülenen 10 videoyu getirir (belirtilen tarih aralığında görüntüleme sayısıyla ölçülü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, en çok izlenen 10 videoyu getirir. Bu video, belirtilen tarih aralığında içerik sahibinin yüklediği tahmini izlenme süresine göre ölçülür. Sonuçlar, dakika cinsinden tahmini izleme 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ı için 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 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ı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
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

İlk 10 – Bir 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 videonun 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 ilk sıralarda yer alacağı anlamına gelir. 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; toplam oynatma listesi başlatma sayısı, oynatma listesi tahmini izlenme süresi, oynatma listesi bilgilerini alır. görüntüleme sayısı ve görüntüleme sayısı. İlgili içeriği oluşturmak için kullanılan playlistViews metriği, yalnızca aşağıdaki bağlamda gerçekleşen video görüntülemelerini sayar: oynatma listesi. İstenen metriklerin tümü oynatma listesi içi metrikler olduğundan istek oynatma listesi veya grup filtresini de dahil etmeniz gerekir.

metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart

Belirli bir oynatma listesiyle ilgili istatistikler

Bu istek toplam oynatma listesi başlatma sayısı, tahmini izlenme süresi, görüntüleme sayısı ( toplu video metriği) kullandığınızdan emin olun. oynatma listesi görüntüleme sayısı (oynatma listesi içi metrik), görüntüleme sayısını artırabilirsiniz. Bu sorguyu API'lerde çalıştırmak için filters içindeki PLAYLIST_ID dizesini değiştirmeniz gerekir parametre değerini döndürür.

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

Birden fazla oynatma listesine ilişkin toplu istatistikleri almak için PLAYLIST_ID dizesini, içerik sahibinin kanallarındaki oynatma listeleri için en fazla 500 oynatma listesi kimliğini içeren virgülle ayrılmış bir listeyle de değiştirebilirsiniz.

Zamana dayalı

Video raporları

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

Bu sorgu, içerik sahibinin yüklediği videoların görüntüleme sayılarını, para kazanılan oynatma sayılarını ve gösterim sayılarının yanı sıra günlük izlenme süresi metriklerini 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 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 olarak 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, içerik sahibinin oynatma listeleri. Raporda alınan metrikler playlistViews, playlistStarts, playlistEstimatedMinutesWatched ve viewsPerPlaylistStart. Bu metriklerin tümü oynatma listesi içi metriklerdir. İstenen metriklerin tümü oynatma listesi içi metrikler olduğundan isteğin şunları yapması gerekmez: oynatma listesi veya grup filtresini de ekleyin.

dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day
'nı inceleyin.
Coğrafi

Video raporları

Kendi yüklediğiniz içerikler için ülkeye özel 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 videolar içindir. 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 yüklediğiniz içerikler için ülkeye özgü ek açıklama metrikleri

Bu istek, içerik sahibinin yüklediği videoların ü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 eyalete özgü metrikler

Bu istek, 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 eyalet bazında dökümünü alır. Veriler ABD eyaletlerini ve Washington D.C.'yi kapsar. Sonuçlar eyaletlere 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 ilk 10 ABD şehri

Bu sorgu, belirtilen tarih aralığında içerik sahibinin hak talebinde bulunulan videolarının en fazla görüntüleme sayısına sahip olan 10 ABD şehrinin bir listesini getirir. Sorgu, başka bir ülke için veri istemek üzere, 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 ait 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=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 ilk 10 ABD şehri

Bu sorgu, desteklenen her bir creatorContentType için belirtilen tarih aralığında içerik sahibinin hak talebinde bulunulan içeriğinin en fazla görüntülenme sayısına sahip olan 10 ABD şehrinin listesini getirir. 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 ilk 10 ABD şehri

Bu sorgu, belirtilen tarih aralığında herhangi bir ABD şehrinin içerik sahibinin hak talebinde bulunulan içeriği için en yüksek toplam günlük izlenme süresi olduğu durumlarda 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ğini tahmin ettiği ş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

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

Bu sorgu, belirtilen tarih aralığındaki görüntüleme sayısıyla ölçülen içerik sahibi tarafından hak talebinde bulunulan videolar arasından Avrupa'da en çok izlenen 10 videoyu getirir. Sorgu, başka bir kıta için veri istemek üzere, 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 ait verileri alacak şekilde değiştirilebilir. Sonuçlar görüntüleme sayısına göre büyükten küçüğe 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 özgü izlenme süresi metrikleri

Bu sorgu, ülkeye özgü oynatma listesi görüntüleme sayılarını ve oynatma listesi izlenme süresi metriklerini getirir içerik sahibinin kanalındaki tüm oynatma listeleri için geçerlidir. Rapor, her biri için bir veri satırı döndürür oynatma listelerinin izlendiği ülke. Satırlar, sütun sayısına göre azalan düzende sıralanır dakika izleme süresi.

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

İlk 10: ABD'de en çok başlatılan oynatma listeleri

Bu sorgu, 2022'de toplam 10 oynatma listesini içerik sahibinin kanallarından ABD, belirtilen tarih aralığında en sık izlemeye başladı. Sonuçlar oynatma listesi başlatma sayısına göre azalan düzende sıralar.

Not: Bu raporda playlist boyutu sort istek parametresi için bir değer belirtin ve maxResults parametresini 10 veya daha küçük bir tam sayı değerine ayarlayın.

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

Video raporları

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

Bu sorgu, belirli bir kanal veya kanal grubundaki her bir içerik türüne ilişkin beğenme 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ıza ait en fazla 500 kanal kimliğini içeren virgülle ayrılmış bir listeyle değiştirmeniz gerektiğini unutmayın.

dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID
'nı inceleyin.
Oynatma konumu

Video raporları

Farklı oynatma konumlarındaki 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 getirir. 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ında günlük izlenme sayısı ve izlenme süresi

Bu sorgu, Amerika Birleşik Devletleri'nde belirli bir kanala veya kanal grubuna yüklenen videoların 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 sayfa veya uygulama türü 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ı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 fazla görüntülemeyi 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 en fazla 500 video kimliğinin yer aldığı 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ıları ve farklı oynatma konumlarındaki izlenme süreleri

Bu sorguyla; oynatma listesi görüntüleme sayısı, oynatma listesi tahmini izlenme süresi ve oynatma listesi, içerik sahibinin kanallarındaki tüm oynatma listeleri için başlatılır. Sonuçlar şu ölçütlere göre toplanır: video oynatıldığı sayfa veya uygulama türünde olur ve sonuçlar azalan düzende sıralanır.

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

Oynatma listesi görüntüleme sayıları ve farklı oynatma konumlarındaki izlenme süreleri

Bu sorgu; günlük oynatma listesi başlatma sayısı, oynatma listesi görüntüleme sayısı ve oynatma listesi tahmini izleme verilerini alır Bir içerik sahibinin kanalındaki tüm oynatma listeleri için Amerika Birleşik Devletleri'nde geçirilen süre. Sonuçlar döndürülür oynatma listesi görüntülemelerinin gerçekleştiği her sayfa veya uygulama türü için geçerlidir.

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

Video raporları

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

Bu istek, içerik sahibinin videolarının görüntüleme sayısını ve tahmini izlenme süresini getirir. Metrikler, kullanıcıların videoya erişme ş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ıları ve izlenme süresi

Bu istek, içerik sahibinin videoları için günlük görüntüleme sayıları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 raporlar bu kaynak için kullanılamaz. Bu rapor türlerinin kullanılabileceğ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 fazla görüntülemeyi oluşturan 10 arama terimini getirir. 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 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=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 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ısı ve izlenme süresi

Bu istek; oynatma listesi görüntüleme, oynatma listesi başlatma ve oynatma listesi tahmini izlenme sayısını getirir oynatma listesi görüntülemelerinin belirli bir ülkede aldığı süre. Metrikler trafik kaynağına göre toplanır, Bu bölüm, kullanıcıların oynatma listesine erişme 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ıları ve izlenme süresi

Bu istek; 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. bir veya daha fazla kanaldaki oynatma listeleri için geçerlidir. Metrikler şuna göre toplanır: trafik kaynağı. Bu sorguyu API Gezgini'nde çalıştırmak için dizeyi değiştirmeniz gerektiğini unutmayın filters parametre değerinde virgülle ayrılmış CHANNEL_ID kanallarınız için 500 adede kadar kanal kimliğinden oluşan bir liste oluşturabilirsiniz.

dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID
'nı inceleyin.
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 olarak 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 oynatmalarının gerçekleştiği her işletim sistemi için güne göre gruplandırılır. Sonuçlar kronolojik olarak 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 olarak 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, Android cihazlardaki oynatma listesi görüntüleme sayılarını ve oynatma listesi tahmini izlenme süresini alır. bir veya daha fazla kanaldaki oynatma listeleri için geçerlidir. Şunun için sonuçlar döndürülür: oynatma listesi görüntülemelerinin gerçekleştiği her cihaz türünü gösterir. Bu sorguyu API'lerde çalıştırmak için filters içindeki CHANNEL_ID dizesini değiştirmeniz gerekir parametre değerini kanallarınız için 500 adede kadar kanal kimliğinin yer aldığı virgülle ayrılmış bir listeyle birlikte ekleyin.

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, mobil cihazlardaki oynatma listesi görüntüleme sayılarını ve oynatma listesi tahmini izlenme süresini alır. bir içerik sahibinin kanalındaki oynatma listeleri için geçerlidir. Her biri için sonuç döndürülür görüntülemelerin gerçekleştiği işletim sistemi.

dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
'nı inceleyin.
Demografi

Video raporları

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

Bu rapor, Kaliforniya'da bulunan ve içerik sahibinin hak talebinde bulunulan içeriğini 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 görüntüleyenler ya da bir ülke, kıta, alt kıta veya başka bir ABD eyaletinde bulunan tüm görüntüleyenler için aynı istatistikleri almak üzere değiştirilebilir.

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup
'nı inceleyin.
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
'nı inceleyin.
Kitleyi elde tutma

Bir video için kitleyi elde tutma metrikleri

Bu rapor, videonun kitleyi elde tutma becerisini ö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ü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 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 (In-stream) TrueView veya Görüntülü (In-display) TrueView reklamlarının görüntüleme verilerini içermez. Videonun kitleyi elde tutma verilerini tüm kitle türlerinden almak için filtreyi kaldırabilirsiniz.

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

dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC
'nı inceleyin.
Gelir/Reklamlar

Hak talebinde bulunulan içeriklerin 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 talep edilen 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ğine ait 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. Yani 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 gelire sahip videolar

Bu istek, içerik sahibinin hak talebinde bulunduğu ve en yüksek geliri sağlayan 10 videonun gelir ve reklam performansı metriklerini getirir. 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. Böylece, farklı reklam türlerindeki gelir ve BGBM değerlerini karşılaştırabilirsiniz.

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