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 nitelendirilir:

  • 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 o rapordaki metriklerin değerlerini nasıl hesaplayacağını belirler.

  • Metrikler; kullanıcı etkinliği, reklam performansı veya tahmini gelirle ilgili ayrı ayrı ölçümlerdir. Kullanıcı etkinliği metrikleri, video görüntüleme sayısı ve puanlar (beğeniler ve beğenmemeler) gibi bilgileri içerir.

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ıyla ilgili verileri almanıza da olanak tanır. Bu gruplar, en fazla 500 video, oynatma listesi, kanal veya öğeden oluşan özel koleksiyonlardır.

Rapor parametrelerini seçme

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

  • startDate ve endDate parametreleri, raporun hangi döneme ait verileri içereceğini belirtir. API yanıtı, sorgu sırasında sorgudaki tüm metriklerin kullanılabildiği, 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, raporlama verilerinin nasıl filtreleneceğini açıklar. Örneğin, bir kanalın tüm verilerini döndürmek yerine, raporu yalnızca belirli bir ülke, video veya video grubu için metrikleri içerecek şekilde filtreleyebilirsiniz.

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

Örnek raporlama seçenekleri

Örneğin, bir kanal sahibinin kanal videolarının mobil cihazlar, oyun konsolları, TV'ler vb. cihazlarda kaç kez görüntülendiğini belirlemek için video cihaz türü raporu almak istediğini varsayalım.

  • Kanal sahibi, startDate parametresini 2015-06-01, endDate parametresini ise 2015-07-31 olarak ayarlar. Bu değerlere göre rapor, iki aylık bir döneme ait verileri içerir.

  • Cihaz türü raporu, views 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österilmiştir. Üçüncüsü ise bu bölümün ilerleyen kısımlarında filters parametre değerinin açıklamasında ele alınmıştır.

    • Parametre değerinin deviceType olarak ayarlanması, görüntüleme sayılarının ve izlenme süresi sayılarının raporun kapsadığı tüm dönem için cihaz türüne göre gruplandırılacağı anlamına gelir. Bu değer sayesinde raporlama verileri, şu 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ğerini day,deviceType olarak ayarlarsanız görüntüleme sayısı ve izlenme süresi sayısı, raporlama dönemi boyunca her gün için cihaz türüne göre hesaplanır. Bu değer sayesinde raporlama verileri, şu 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, hepsini açıklayamayacağımız kadar çok filtreleme seçeneğini destekler. Bu nedenle, bu örnekler oluşturabileceğiniz raporların yalnızca bir kısmını temsil eder.

    • Kanal sahibi, isteği yalnızca Android işletim sistemi için değer 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 videolar Kanada'da kaç kez görüntülendi?)

    • Kanal sahibi, isteği yalnızca belirli videoların değerlerini döndürecek şekilde filtreleyebilir. Ancak video filtresi, virgülle ayrılmış bir 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, boyutlar listesine video boyutunu eklemezse metrikler, belirtilen tüm videoları kapsayan toplam değerleri belirtir. (ABC, DEF ve XYZ videoları 1 Haziran 2015'te oyun konsolunda kaç kez görüntülendi?)

Veri güncelliği ve gecikmesi

YouTube Analytics API, hedefli sorguları desteklese de temel analiz verileri gerçek zamanlı değildir. Veri işleme genellikle 48 ila 72 saatlik bir gecikmeye neden olur. Bu nedenle, API yanıtları son günlere ait verileri içermez ve raporunuzun endDate, yalnızca istenen tüm metriklerin tamamen işlendiği son güne kadar olan verileri içerir.

Veri gecikmesi nedeniyle, API tarafından döndürülen veriler ile YouTube Studio'da görünen gerçek zamanlı metrikler arasında tutarsızlıklar görebilirsiniz. Uygulamanız, tek tek videolar için mevcut görüntüleme, beğeni veya yorum sayısı gibi gerçek zamanlı istatistikler gerektiriyorsa YouTube Analytics API yerine YouTube Data API'nin videos.list yöntemini kullanın.

Raporlar alınıyor

Rapor almak için API'nin reports.query yöntemine yetkili bir GET isteği göndererek 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 aşağıdaki uygulamaları takip etmelidir:

  • Rapor sütunlarının sıralamasını belirlemek için yanıtın başlık satırını kullanın. Örneğin, bir rapor açıklamasında listelenen ilk metrik olduğu için görüntüleme sayısının bir yanıtta döndürülen ilk metrik olacağını varsaymayın. Bunun yerine, yanıtın başlık satırını kullanarak verilerin hangi sütunda yer aldığını belirleyin.
  • YouTube Analytics API yanıtlarında tanımlanan kaynaklar için ek meta veriler almak üzere YouTube Data API'yi kullanın. YouTube API Hizmetleri Geliştirici Politikaları'nda (III.E.4.b ile III.E.4.d arasındaki bölümler) belirtildiği üzere, API istemcileri söz konusu API'den depolanan kaynak meta verilerini 30 gün sonra 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, kanal sahibi bir videoyu silerse bu video, video bazında metrik döndüren bir API yanıtında artık listelenmez. Ancak bir kaynak grubu için metrikleri toplayan raporlar, silinen öğelerle ilişkili metrikleri içermeye devam eder.

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

Bu durumda, ilk rapor günlük toplamları içerdiğinden ilk rapordaki sayılar daha sonra silinen videoların görüntüleme sayılarını da içerir. Ancak ikinci rapor, videoları tek tek listelediği için silinen öğelerle ilişkili görüntülemeleri içermez. Sonuç olarak, kanal raporun kapsadığı dönemde video sildiyse ilk raporda bildirilen toplam günlük görüntüleme sayısı, ikinci rapordaki günlük, 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ı olabilir. Bu durum çeşitli raporlarda görülebilir. Pratikte bu, aşağıdaki durumlarda bir raporun verilerinizin tümünü (veya hiçbirini) içermeyebileceği anlamına gelir:

  1. Bir video veya kanalın belirli bir dönemdeki trafiği sınırlıysa

    veya

  2. Değerleri belirli bir eşiği karşılamayan bir filtre veya boyut (ör. trafik kaynağı ya da ülke) 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 rapor, belirli bir videonun toplam görüntüleme sayısını listeler. İkinci rapor ise bu videonun toplam görüntüleme sayısını ülke bazında listeler. 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 videonun yalnızca 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 bulunmaz.

Sınırlı veri türleri

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

  • Yaş ve cinsiyet gibi demografi verileri.
  • İzleyicilerin bulunduğu ülke veya bölgelerle ilgili metrikler ya da boyutlar dahil olmak üzere coğrafi veriler. Ancak raporların, gelir metriklerine coğrafya eşikleri uygulamadığını unutmayın.
  • Videolarınızın görüntülenmesini sağlayan arama terimleri veya harici URL'ler gibi belirli trafik kaynaklarıyla ilgili metrikler. Örneğin, çok az sayıda görüntüleme sağlayan arama terimleri ve URL'ler raporlarda görünmez. Ancak içeriğinize çok sayıda izleyici çeken 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'ni ziyaret edin.

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 Cloud Console'daki Kotalar panelinde gösterilir.