YouTube Analytics API - Data Model

YouTube Analytics API, YouTube Analytics verilerini içeren özel raporlar oluşturmanıza olanak tanır. API, kanallar ve içerik sahipleri için raporları destekler. Rapor alanları boyut veya metrik olarak sınıflandırılır:

• Boyutlar, verileri toplamak için kullanılan ortak ölçütlerdir (ör. bir işlemin gerçekleştiği tarih veya kullanıcıların bulunduğu ülke).

  Bir raporda, her veri satırının benzersiz bir boyut değerleri kombinasyonu vardır. Bu nedenle, bir rapor için seçtiğiniz boyutlar, YouTube'un bu rapordaki metriklerin değerlerini nasıl hesaplayacağını belirler.

• Metrikler, kullanıcı etkinliği, reklam performansı veya tahmini gelirle ilgili ayrı ölçümlerdir. Kullanıcı etkinliği metrikleri arasında video görüntüleme sayısı ve puanlar (beğenme ve beğenmeme) gibi öğeler yer alır.

Analytics API, filtreleme ve sıralama parametreleri sağladığından çağıran uygulamanın bu işlevleri yerel olarak desteklemesi gerekmez. API, YouTube Analytics grupları için de veri almanıza olanak tanır. Gruplar, en fazla 500 video, oynatma listesi, kanal veya öğe içeren özel koleksiyonlardır.

Rapor parametrelerini seçme

API'nin reports.query yöntemini kullanarak bir rapor istediğinizde, API isteği rapor değerlerinin nasıl hesaplanacağını belirleyen beş parametre içerir:

• startDate ve endDate parametreleri, raporun veri içereceği zaman aralığını belirtir. API yanıtı, sorgudaki tüm metriklerin sorgu sırasında kullanılabilir olduğu, belirtilen son güne kadar olan verileri içerir.

• metrics parametresi, rapora dahil edilecek ölçümleri belirtir. Kanal raporlarında metrikler, kullanıcı etkinliğini ölçer ve görüntüleme sayısı ile beğeni sayısı gibi değerleri içerir. Bazı metrikler reklam performansını veya tahmini geliri de ölçer.

• dimensions parametresi, metriklerin nasıl gruplandırılacağını açıklar.

• filters parametresi, rapor verilerinin nasıl filtreleneceğini açıklar. Bu nedenle, örneğin bir kanalın tüm verilerini döndürmek yerine, bir rapor yalnızca belirli bir ülke, video veya video grubuna ait metrikleri içerecek şekilde filtrelenebilir.

  Not: API, video, oynatma listesi ve kanal filtreleri için birden fazla değer belirtmenize olanak tanır. Bu durumda, döndürülen metriklerin video, oynatma listesi veya kanala göre de gruplandırılması için söz konusu filtreyi boyutlar listesine ekleyebilirsiniz.

Örnek raporlama seçenekleri

Örneğin, bir kanal sahibi, kanal videolarının mobil cihazlarda, oyun konsollarında, TV'lerde vb. kaç kez görüntülendiğini belirlemek için bir video cihaz türü raporu almak istiyor.

• Kanal sahibi, startDate parametresini 2015-06-01, endDate parametresini ise 2015-07-31 olarak ayarlar. Bu değerlere göre raporda iki aylık döneme ait veriler yer alır.

• Cihaz türü raporu, görüntülemeler ve estimatedMinutesWatched metriklerini desteklediğinden kanal sahibi, metrics parametresini views,estimatedMinutesWatched olarak ayarlar.

• Kanal sahibi, dimensions parametresi için çeşitli seçeneklere sahiptir. Bunlardan ikisi aşağıdaki listede gösterilmektedir. Üçüncüsü ise bu bölümün ilerleyen kısımlarında filters parametre değerinin açıklamasında ele alınmaktadır.

  • Parametre değerinin deviceType olarak ayarlanması, raporun kapsadığı süre boyunca görüntüleme sayısı ve izlenme süresi sayılarının cihaz türüne göre gruplandırılacağı anlamına gelir. Bu nedenle, bu değerle birlikte rapor verileri aşağıdaki gibi soruları yanıtlar:

    • Kanalın videoları 1 Haziran 2015 ile 31 Temmuz 2015 tarihleri arasında mobil cihazlarda kaç kez görüntülendi?
    • Kanalın videoları 1 Haziran 2015 ile 31 Temmuz 2015 tarihleri arasında oyun konsollarında kaç kez görüntülendi?

    Rapor, her cihaz türü için toplam görüntüleme ve izlenme süresi sayısını içerir.

  • Parametre değerinin day,deviceType olarak ayarlanması, görüntüleme sayısı ve izlenme süresi sayılarının raporlama dönemindeki her gün için cihaz türüne göre hesaplanacağı anlamına gelir. Bu nedenle, bu değerle birlikte rapor verileri aşağıdaki gibi soruları yanıtlar:

    • Kanalın videoları 1 Haziran 2015'te mobil cihazlarda kaç kez görüntülendi?
    • Kanalın videoları 14 Temmuz 2015'te televizyonlarda kaç kez görüntülendi?

• Son olarak, filters parametresi, kanal sahibinin raporu yalnızca belirli filtre değerleriyle eşleşen verileri içerecek şekilde kısıtlamasına olanak tanır. Rapor, tümünü açıklamak için çok fazla filtreleme seçeneğini desteklediğinden bu örnekler, oluşturabileceğiniz raporların yalnızca bir kısmını temsil etmektedir.

  • Kanal sahibi, isteği yalnızca Android işletim sistemine ait değerleri döndürecek şekilde filtreleyebilir. (Raporlama döneminde Android mobil cihazlarda kaç görüntüleme gerçekleşti?)

  • Kanal sahibi, isteği yalnızca belirli bir ülkeye ait değerleri döndürecek şekilde filtreleyebilir. (Raporlama döneminin her gününde Kanada'da videolar kaç kez görüntülendi?)

  • Kanal sahibi, isteği yalnızca belirli videolar için değer döndürecek şekilde filtreleyebilir. Ancak video filtresi, virgülle ayrılmış değer listesini desteklediğinden rapor aslında birçok videoyla ilgili veriler içerebilir.

    Ayrıca, video filtresi birden fazla değer belirtiyorsa video da boyut olarak belirtilebilir. Bu, dimensions parametresinin deviceType,video ve day,deviceType,video değerlerini de desteklediği anlamına gelir.

    • Kanal sahibi, boyutlar listesine video boyutunu eklerse metrikler her video için ayrı değerler belirtir. (XYZ videosu 1 Haziran 2015'te oyun konsolunda kaç kez görüntülendi?)
    • Kanal sahibi boyut listesine videoyu dahil etmezse metrikler, belirtilen tüm videoları kapsayan toplam değerleri gösterir. (ABC, DEF ve XYZ videoları 1 Haziran 2015'te oyun konsolunda kaç kez görüntülendi?)

Raporları alma

Bir raporu almak için API'nin reports.query yöntemine yetkili bir GET isteği gönderin ve almak istediğiniz raporu tanımlayan parametreleri belirtin.

API'nin desteklediği raporların listesi için kanal raporları ve içerik sahibi raporları belgelerine bakın. Her rapor tanımı, raporun metrics, dimensions ve filters parametreleri için izin verdiği değerleri tanımlar.

En iyi uygulamalar

YouTube Analytics API'yi kullanan uygulamalar her zaman şu uygulamaları takip etmelidir:

• Raporun sütunlarının sıralamasını belirlemek için bir yanıtın başlık satırını kullanın. Örneğin, görüntülemeler, rapor açıklamasında listelenen ilk metrik olduğu için yanıtta döndürülen ilk metrik olacağını varsaymayın. Bunun yerine, hangi sütunda bu verilerin bulunduğunu belirlemek için yanıtın başlık satırını kullanın.
• YouTube Analytics API yanıtlarında tanımlanan kaynaklar için ek meta verileri almak üzere YouTube Data API'yi kullanın. YouTube API Hizmetleri Geliştirici Politikaları'nda (III.E.4.b ile III.E.4.d bölümleri) belirtildiği gibi, API istemcileri 30 gün sonra depolanan kaynak meta verilerini silmeli veya yenilemelidir.

Toplu metrikler ve silinen öğeler

YouTube Analytics API yanıtları, silinen öğeler için metrik dökümleri içermez. Örneğin, bir kanal sahibi bir videoyu silerse bu video artık tek tek videolarla ilgili metrikleri döndüren bir API yanıtında listelenmez. Ancak bir kaynak grubunun metriklerini toplayan raporlar, silinmiş öğelerle ilişkili metrikleri içermeye devam eder.

Örneğin, bir kanal sahibinin iki rapor aldığını varsayalım. İlk raporda, belirli bir dönemdeki tüm kanal videolarının günlük toplam görüntüleme sayısı listelenir. İkinci raporda ise aynı dönemdeki günlük toplam görüntülemeler video bazında listelenir.

Bu durumda, ilk rapordaki sayılar, günlük toplamlar içerdiğinden daha sonra silinen videoların görüntülemelerini de kapsar. Ancak ikinci rapor, silinen öğelerle ilişkili görüntülemeleri içermez. Bunun nedeni, ikinci raporda görüntülemelerin video bazında listelenmesidir. Bu nedenle, kanal raporun kapsadığı dönemde videoları sildiyse ilk raporda bildirilen toplam günlük görüntüleme sayısı, ikinci rapordaki günlük ve videoya özel görüntüleme sayılarının toplamından daha yüksek olabilir.

Veri anonimleştirme

Metrikler belirli bir eşiği karşılamadığında bazı YouTube Analytics verileri sınırlı olur. Bu durum çeşitli raporlarda görülebilir. Uygulamada bu, aşağıdaki durumlarda bir raporun verilerinizin tümünü (veya herhangi birini) içermeyebileceği anlamına gelir:

1. bir video veya kanalın belirli bir dönemde sınırlı trafiği varsa,

   veya

2. Değerlerinin belirli bir eşiği karşılamadığı trafik kaynağı veya ülke gibi bir filtre ya da boyut seçtiyseniz

Verilerin sınırlı olduğu durumlarda, raporların verileri birleştirme şekline bağlı olarak, farklı raporlarda belirtilen toplamlar arasında fark olabilir.

Örneğin, bir kanal sahibinin iki rapor aldığını varsayalım. İlk raporda belirli bir videonun toplam görüntüleme sayısı, ikinci raporda ise aynı videonun ülke bazında toplam görüntüleme sayısı listelenir. Belirtilen dönem boyunca videonun 500'ü ABD'de, 498'i Kanada'da ve ikisi Fransa'da olmak üzere 1.000 kez görüntülendiğini düşünelim.

Bu örnekte, ilk rapor videonun 1.000 kez görüntülendiğini gösterir. İkinci raporda ise yalnızca videonun ABD'de 500 kez, Kanada'da ise 498 kez görüntülendiği belirtilir. Bu nedenle, iki rapordaki toplam görüntüleme sayısı arasında fark olacaktır. İkinci raporda, diğer iki görüntülemenin de gerçekleştiğine (veya Fransa'da görüntüleme gerçekleştiğine) dair herhangi bir gösterge bulunmadığını unutmayın.

Verilerin sınırlandırıldığı gerçek eşikler yayınlanmaz ve YouTube'un takdirine bağlı olarak değiştirilebilir.

Sınırlı veri türleri

YouTube Analytics raporlarında aşağıdaki veriler sınırlı olabilir:

• Yaş ve cinsiyet gibi demografik veriler.
• İzleyicilerin bulunduğu ülkeler veya bölgelerle ilgili metrikler ya da boyutlar (ör. ülkeleri veya bölgeleri) dahil olmak üzere coğrafi veriler. Ancak raporların, gelir metriklerine coğrafi eşikler uygulamadığını unutmayın.
• Videolarınızın görüntülenmesine yol açan arama terimleri veya harici URL'ler gibi belirli trafik kaynaklarıyla ilgili metrikler. Örneğin, çok az sayıda görüntülemeye yol açan arama terimleri ve URL'ler raporlarda görünmez. Bununla birlikte, içeriğinize çok sayıda izleyici yönlendiren terimleri ve URL'leri görmeye devam edersiniz.

YouTube Analytics raporlarındaki sınırlı veriler hakkında daha fazla bilgi için YouTube Yardım Merkezi'ne bakın.

Kota kullanımı

Yaptığınız her API isteği, API kullanım kotanızın bir birimi olarak sayılır. Kota sınırları, Google API Konsolu'ndaki Kotalar panelinde görülebilir.