Bu belgede, YouTube Analytics API ve YouTube Reporting API'nin YouTube Analytics verilerine erişim sağlama yöntemlerindeki benzerlikler ve farklılıklar açıklanmaktadır. Böylece, uygulamanız için doğru API'yi seçebilirsiniz.
Her iki API de YouTube Analytics verilerini almanıza olanak tanır. Ayrıca her iki API de YouTube kanal sahiplerini ve YouTube içerik sahiplerini destekler. Bu kullanıcıların her biri belirli bir rapor grubuna erişebilir:
-
Kanal raporları, belirli bir kanala ait kullanıcı etkinliği metriklerini içerir.
-
İçerik sahibi raporları, belirtilen bir YouTube içerik sahibine bağlı tüm kanallardaki metrikleri toplar. Örneğin, bir plak şirketi, şirketin tüm sanatçılarının YouTube kanallarıyla ilgili birleştirilmiş istatistikleri içeren bir rapor alabilir. Bazı içerik sahibi raporları kullanıcı etkinliği metrikleri içerirken diğerleri gelir ve reklam performansıyla ilgili metrikler içerir.
Reporting API, bazı içerik sahiplerinin sistem tarafından yönetilen reklam geliri raporlarına erişmesine de olanak tanır. Sistem tarafından yönetilen raporlardaki veriler yalnızca Reporting API ile alınabilir.
Tüm YouTube Analytics ve YouTube Reporting API istekleri, istenen verilerin sahibi olan kanal veya içerik sahibi tarafından yetkilendirilmelidir.
Rapor içeriği
API'lerin aldığı raporlar iki tür veri içerir:
-
Boyutlar, verileri toplamak için kullanılan ortak ölçütlerdir. Örneğin, kullanıcı etkinliğinin 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, her satırın boyut değeri kombinasyonu, söz konusu satırın birincil anahtarı olarak işlev görür.
-
Metrikler, kullanıcı etkinliği, reklam performansı veya tahmini gelirin ayrı ayrı ölçümleridir. Kullanıcı etkinliği metrikleri arasında video görüntüleme sayıları ve puanlar (beğenme ve beğenmeme) gibi öğeler yer alır.
Uygulamanız için doğru API'yi seçme
- YouTube Analytics API'sı
- YouTube Analytics API, özel YouTube Analytics raporları oluşturmak için gerçek zamanlı hedefli sorguları destekler. API, filtreleme ve sıralama parametreleri sağlar. Bu nedenle, çağıran uygulamanın bu işlevleri yerel olarak desteklemesi gerekmez.
Her API isteğinde, verilerin döndürüleceği tarih aralığı belirtilir. API, haftalık ve aylık veri kümelerini almanıza da olanak tanır. Bu nedenle, arama uygulamasının alınan veri kümelerini depolaması veya tarih aralıklarındaki istatistikleri toplaması gerekmez. - YouTube Reporting API
- YouTube Reporting API, bir kanal veya içerik sahibine ait YouTube Analytics verilerini içeren toplu raporları alır. Büyük veri kümelerini içe aktarabilen ve bu verileri filtrelemek, sıralamak ve veri madenciliği yapmak için araçlar sağlayan uygulamalar için tasarlanmıştır.
Her rapor, önceden tanımlanmış bir alan grubu içerir. API'yi kullanarak, her biri YouTube'un oluşturması gereken bir raporu tanımlayan raporlama işleri planlarsınız. YouTube daha sonra eşzamansız olarak indirilebilen günlük bir rapor oluşturur. Her rapor, benzersiz bir 24 saatlik döneme ait verileri içerir.
Ayrıca YouTube, YouTube İçerik Üretici Stüdyosu'nda ilgili raporlara erişimi olan içerik sahipleri için sistem tarafından yönetilen bir dizi raporu otomatik olarak oluşturur. Bu raporlar, reklam geliri verilerine programatik erişim imkanı sağlar.
Desteklenen raporlar
Aşağıdaki tabloda, API'leri kullanarak alabileceğiniz farklı rapor türleri tanımlanmaktadır. YouTube Analytics API ile hedeflenmiş sorgular, YouTube Reporting API ile toplu raporlar kullanılabilir.
Bir API'de bulunan veriler diğerinde bulunmayabilir. Örneğin, YouTube Analytics API, kullanıcı etkinliği metriklerini haftalık veya aylık olarak almanıza olanak tanır ancak YouTube Reporting API, bu verileri kendiniz toplamanızı gerektirir. Öte yandan, YouTube Reporting API, içerik sahipleri için öğe raporlarını destekler ancak bu veriler YouTube Analytics API'de kullanılamaz.
Rapor türleri | |
---|---|
Video raporları | Kanallar (query veya bulk) ve içerik sahipleri (query veya bulk) için desteklenir. Video raporları, bir kanalın videoları veya bir içerik sahibinin videolarıyla ilgili tüm kullanıcı etkinliği istatistiklerini sağlar. Örneğin, bu raporlarda videolarınızın aldığı görüntüleme sayısı yer alır. YouTube Analytics API'de, bazı içerik sahibi video raporları tahmini gelir ve reklam performansı metriklerini de içerir. |
Oynatma listesi raporları | Kanallar (query veya bulk) ve içerik sahipleri (query veya bulk) için desteklenir. Oynatma listesi raporları, oynatma listesi bağlamında gerçekleşen video görüntülemeleriyle ilgili istatistikler sağlar. YouTube Reporting API, oynatma listeleri için kitleyi elde tutma raporlarını destekler ancak YouTube Analytics API benzer bir raporu desteklemez. |
Reklam performans raporları | İçerik sahipleri (query veya bulk) için desteklenir. Reklam performansı raporları, video oynatma sırasında yayınlanan reklamlar için gösterime dayalı metrikler sağlar. Bu metrikler her reklam gösterimini hesaba katar ve her video oynatma işlemi birden fazla gösterim sağlayabilir. |
Tahmini gelir raporları | İçerik sahipleri (toplu) için desteklenir. Tahmini gelir raporları, Google tarafından satılan reklam kaynaklarından ve reklam dışı kaynaklardan elde edilen videolara ait toplam tahmini geliri gösterir. Bu raporlar bazı reklam performansı metriklerini de içerir. Sistem tarafından yönetilen raporların gerçek geliri içerdiğini unutmayın. |
Öğe raporları | İçerik sahipleri (toplu) için desteklenir. Öğe raporları, içerik sahibinin öğelerine bağlı videolarla ilgili kullanıcı etkinliği metriklerini sağlar. Bir video, içerik sahibi tarafından öğelerinden biriyle eşleştiği iddia edilirse içerik sahibinin raporuna dahil edilir. Video, içerik sahibi veya başka bir YouTube kullanıcısı tarafından yüklenmiş olabilir. |
Sistem tarafından yönetilen raporlar | YouTube İçerik Stüdyosu'nun Raporlar menüsündeki ilgili raporlara erişimi olan içerik sahipleri tarafından kullanılabilir. Sistem tarafından yönetilen raporlar, öğeler ve videolardan elde edilen gerçek gelir verilerini sağlar. Ek bir raporda, hak talebinde bulunulan videolar ve bu videolarla eşleşen öğeler listelenir. API'de tüm İçerik Stüdyosu raporları kullanılamaz. Not: YouTube, İçerik Stüdyosu'nda ilgili raporlara erişimi olan içerik sahipleri için sistem tarafından yönetilen raporları otomatik olarak oluşturur. Bu nedenle, bu raporları alma süreci, listedeki diğer rapor türlerinden farklıdır. Daha fazla bilgi için sistem tarafından yönetilen raporlar ile ilgili dokümanları inceleyin. |
Temel farklılıklar
Aşağıdaki tabloda, YouTube Analytics ve Reporting API'leri arasındaki önemli farklılıklar vurgulanmaktadır.
Özellik | YouTube Analytics API'sı | YouTube Reporting API |
---|---|---|
Veri alma süreci | Her API isteğinde, döndürülecek boyutlar ve metriklerin yanı sıra verilerin döndürüleceği dönem belirtilir. | Uygulamalar, raporlama işlerini planlar. YouTube, her iş için eşzamansız olarak indirilebilen günlük raporlar oluşturur. |
Tarih Aralıkları | Bazı API raporlarında, kullanıcı etkinliğinin gerçekleştiği tarih belirtilir. Bu raporlardan bazıları, kullanıcı etkinliği metriklerini aya göre toplamak için boyutları destekler. | Tüm API raporlarında, kullanıcı etkinliğinin gerçekleştiği gün belirtilir. API'yi kullanan uygulamalar, verileri belirli aralıklarla toplamak için özellikler uygulayabilir. |
Verileri filtreleme | Raporları, yalnızca bir boyutun belirli bir değere sahip olduğu satırları içerecek şekilde filtreleyebilirsiniz. API, yalnızca filtre olarak kullanılan continent ve subContinent gibi bazı boyutları da destekler. | API, tam veri kümelerinin toplu olarak indirilmesini destekler. Yalnızca filtreleme için kullanılan boyutlarda filtreleme veya veri döndürme desteklenmez. İstemci uygulaması, indirilen verileri depolar ve verileri filtrelemek için kendi özelliklerini uygular. |
Sıralama | Raporlar, döndürülen metrik değerlerine göre sıralanabilir. Bazı raporlar yalnızca sınırlı sayıda sonucu destekler. Örneğin, bir kanalın en çok görüntülenen videolarını listeleyen rapor en fazla 200 satır döndürür. | Bu API, eksiksiz veri kümelerinin toplu olarak indirilmesini destekler. İstemci uygulamaları, indirilen verileri sıralamak için kendi özelliklerini uygulayabilir. |
Numaralandırmalar | API raporları, numaralandırılmış boyut değerlerini tanımlamak için "ANDROID" veya "KANAL" gibi metin değerleri içerir. | API raporları, metin değerleriyle eşlenebilen tam sayılar içerir. |
Kota | API sunucusu, kota maliyetini belirlemek için her sorguyu değerlendirir. Kota kullanımı bölümünde yöntem daha ayrıntılı olarak açıklanmaktadır. | Veriler bir kez alındıktan sonra uygulama içinde filtrelendiği, sıralandığı ve sorgulandığı için kota kullanımı sorun teşkil etmez. |
Unique reports |
|
|
Benzersiz boyutlar | group (yalnızca filtreleme için kullanılan boyut) continent (yalnızca filtreleme için kullanılan boyut) subContinent (yalnızca filtreleme için kullanılan boyut) month viewsPerPlaylistStart averageTimeInPlaylist |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
Tekil metrikler | uniques relativeRetentionPerformance viewsPerPlaylistStart averageTimeInPlaylist |
card_click_rate card_clicks card_impressions card_teaser_click_rate card_teaser_clicks card_teaser_impressions estimated_partner_adsense_revenue estimated_partner_doubleclick_revenue playlist_saves_added playlist_saves_removed |
API'ler arasındaki adlandırma farklılıkları
İki API, boyutları ve metrikleri tanımlamak için farklı adlandırma kuralları kullanır. YouTube Analytics API adlarında adType
gibi camelCase kullanılır. YouTube Reporting API adları küçük harflerle yazılır ve alt çizgi kullanılır (ör. ad_type
).
Aşağıdaki tablolarda, iki API'nin aynı metrikleri ve boyutları tanımlamak için kullandığı farklı adlar belirtilmektedir. Bazı durumlarda, iki ad arasındaki fark, bir adı camelCase'den alt çizgiye dönüştürdüğünüzde elde edeceğiniz farktan daha fazladır. Örneğin, YouTube Analytics API'deki video
boyutu, YouTube Reporting API'de video_id
olarak adlandırılır.