YouTube Analytics API - Data Model

YouTube Analytics API, YouTube Analytics verilerini içeren özel raporlar oluşturmanızı sağlar. API, kanallar ve içerik sahipleri için raporları destekler. Rapor alanları boyut veya metrik olarak nitelendirilir:

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

    Bir raporda, her veri satırının boyut değerlerinin benzersiz bir kombinasyonu vardır. Bu nedenle, bir rapor için seçtiğiniz boyutlar YouTube'un rapordaki metriklere ilişkin değerleri nasıl hesapladığını belirler.

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

Analytics API'si filtreleme ve sıralama parametreleri sağladığından, çağrı uygulamasının bu işlevleri yerel olarak desteklemesi gerekmez. API, YouTube Analytics gruplarının verilerini almanıza da olanak tanır. Bu gruplar, 500'e kadar video, oynatma listesi, kanal veya öğeden oluşan özel bir koleksiyondur.

Rapor parametrelerini seçme

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

  • startDate ve endDate parametreleri, raporun veri içerdiği dönemi belirtir. API yanıtı gerçekte, sorgu sırasında sorgudaki tüm metriklerin 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 kanalla ilgili tüm verileri döndürmek yerine, rapor yalnızca belirli bir ülke, video veya video grubuna ilişkin metrikleri içerecek şekilde filtrelenebilir.

    Not: API; video, oynatma listesi ve kanal filtreleri için birden fazla değer belirtmenizi sağlar. Bu durumda, döndürülen metrikleri video, oynatma listesi veya kanala göre de gruplamak için bu filtreyi boyut listesine de ekleyebilirsiniz.

Örnek raporlama seçenekleri

Örneğin bir kanal sahibinin, mobil cihazlarda, oyun konsollarında, TV'lerde ve benzer cihazlarda kanal videolarının kaç kez izlendiğini belirlemek için bir 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ğerler temel alınarak rapor, iki aylık döneme ait verileri içerir.

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

  • dimensions parametresi için kanal sahibinin birden fazla seçeneği vardır. Bunlardan ikisi aşağıdaki listede, üçüncüsü de bu bölümün ilerleyen kısımlarında yer alan filters parametre değerinin açıklamasında açıklanmıştır.

    • Parametre değeri deviceType olarak ayarlanırsa görüntüleme sayısı ve izlenme süresi sayıları, raporun kapsamında bulunan tüm dönem için cihaz türüne göre gruplandırılır. Bu nedenle, rapor verileri aşağıdaki gibi soruları yanıtlar:

      • 1 Haziran 2015 ile 31 Temmuz 2015 tarihleri arasında kanalın videoları 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 aslında her cihaz türü için toplam görüntüleme sayısını ve izlenme süresini içerir.

    • Parametre değeri day,deviceType olarak ayarlanırsa görüntüleme sayısı ve izlenme süresi sayısı, raporlama dönemindeki her gün için cihaz türüne göre hesaplanır. Bu nedenle, rapor verileri aşağıdaki gibi soruları yanıtlar:

      • 1 Haziran 2015 tarihinde kanalın videoları mobil cihazlarda kaç kez görüntülendi?
      • 14 Temmuz 2015 tarihinde kanalın videoları 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çıklayamayacak kadar 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 sistemi için değer döndürmesi amacıyla filtreleyebilir. (Raporlama döneminde Android mobil cihazlarda kaç görüntüleme gerçekleşti?)

    • Kanal sahibi, isteği yalnızca belirli bir ülke için değer döndürmesi şeklinde filtreleyebilir. (Raporlar, raporlama döneminin her günü 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 birçok videonun verilerini içerebilir.

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

      • Kanal sahibi, boyut listesinde video ifadesini içeriyorsa metrikler, her bir video için bağımsız değerleri belirtir. (XYZ videosu 1 Haziran 2015 tarihinde bir oyun konsolunda kaç kez görüntülendi?)
      • Kanal sahibi, boyut listesine video özelliğini eklemezse metrikler, belirtilen tüm videoları kapsayan toplam değerleri belirtir. (ABC, DEF ve XYZ videoları 1 Haziran 2015 tarihinde bir oyun konsolunda kaç kez görüntülendi?)

Raporları alma

Bir raporu almak için API'nin reports.query yöntemine bir yetkili 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ı dokümanlarını inceleyin. 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ı izlemelidir:

  • 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 raporun açıklamasında listelenen ilk metrik olduğu için görüntülemelerin yanıtta döndürülen ilk metrik olacağını varsaymayın. Bunun yerine, hangi verilerin bu verileri içerdiğini 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 belirtildiği üzere (III.E.4.b ile III.E.4.d bölümleri arasında), API istemcilerinin depolanan API meta verilerini 30 gün sonra silmeleri veya yenilemeleri gerekir.

Toplu metrikler ve silinmiş öğeler

YouTube Analytics API yanıtları, silinen öğeler için metrik dökümlerini içermez. Örneğin, bir kanal sahibi videoyu silerse söz konusu video, artık video bazında metrikler döndüren bir API yanıtında listelenmez. Ancak bir grup kaynak için metrikleri toplayan raporlarda, silinmiş öğelerle ilişkili metrikler yer almaya devam eder.

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

Bu durumda, ilk rapordaki sayılar ilk raporda günlük toplu veriler olduğu için daha sonra silinen videoların görüntüleme sayılarını içerir. Ancak ikinci raporda, görüntüleme sayısı video bazında listelendiği için silinen öğelerle ilişkili görüntülemeler yer almaz. Bunun sonucunda, kanal raporun kapsadığı dönemdeki videoları sildiyse ilk raporda raporlanan toplam günlük görüntüleme sayısı, ikinci rapordaki günlük, videoya özel görüntüleme sayılarından daha yüksek olabilir.

Veri anonimleştirme

Metrikler belirli bir eşiği karşılamadığında bazı YouTube Analytics verileri sınırlıdır. Bu durum çeşitli raporlarda gerçekleşebilir. Pratikte bu, bir raporun tüm verilerinizi (veya herhangi birini) içermeyebileceği anlamına gelir. Bu durumda:

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

    veya

  2. Değerlerin belirli bir eşiği karşılamadığı bir filtre veya boyut (ör. trafik kaynağı veya ülke) seçtiniz.

Verilerin sınırlı olduğu durumlarda, bu raporların verileri nasıl topladığına bağlı olarak farklı raporlarda bildirilen toplamlar arasında fark olabilir.

Örneğin, bir kanal sahibinin iki rapor aldığını varsayalım. İlk rapor belirli bir video için toplam görüntüleme sayısını, ikinci rapor ise ülke bazında toplam listesini gösterir. Belirtilen dönemde videonun 1.000 kez görüntülendiği varsayılmıştır. ABD'de 500 görüntüleme, Kanada'da 498 görüntüleme ve Fransa'da iki kez gerçekleşmiştir.

Bu örnekte ilk rapor, videonun 1.000 kez görüntülendiğini gösterir. İkinci rapor, videonun yalnızca ABD'de 500 ve Kanada'da 498 kez gösterildiğini belirtir. Bu nedenle, iki rapordaki toplam görüntüleme sayıları arasında bir fark olacaktır. İkinci raporun, diğer iki görüntülemenin de gerçekleştiğine (veya Fransa'da herhangi bir görüntülemenin gerçekleştiğine) dair herhangi bir gösterge içermeyeceğini 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 demografi verileri.
  • İzleyicilerin bulundukları ülkeler veya bölgelerle ilgili metrikler ya da boyutlar (ör. ülke veya bölgeler) dahil olmak üzere coğrafi veriler. Ancak raporların gelir metriklerine coğrafi eşikler uygulamadığını unutmayın.
  • Arama terimleri veya videolarınızın izlenmesine neden olan 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 yine de 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'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ünür.