Bu belgede, YouTube Analytics API ile YouTube Reporting API'nin YouTube Analytics verilerine erişim sağlama şeklindeki benzerlikler ve farklılıklar açıklanmaktadır. Belgenin amacı, uygulamanız için doğru API'yi seçmenize yardımcı olmaktır.
Her iki API de geliştiricilerin YouTube Analytics verilerini alabilmesini sağlar. Ayrıca, her iki API de belirli bir rapor grubuna erişebilen YouTube kanal sahiplerini ve YouTube içerik sahiplerini destekler:
-
Kanal raporları, belirtilen kanal için kullanıcı etkinliği metriklerini içerir.
-
İçerik sahibi raporları, belirli bir YouTube içerik sahibine bağlı olan tüm kanallara ait metrikleri toplar. Örneğin, bir plak şirketi, plak şirketine ait tüm sanatçıların YouTube kanallarına ait birleştirilmiş istatistikleri içeren bir rapor alabilir. Bazı içerik sahibi raporları kullanıcı etkinliği metriklerini, bazıları ise gelir ve reklam performansıyla ilgili metrikleri 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 birleştirmek için kullanılan yaygın ölçütlerdir (ör. kullanıcı etkinliğinin gerçekleştiği tarih veya kullanıcıların bulunduğu ülke).
Raporlarda, her veri satırında boyut değerlerinin benzersiz bir kombinasyonu vardır. Dolayısıyla, her bir 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ğinin, reklam performansının veya tahmini gelirin ayrı ayrı ölçümleridir. Kullanıcı etkinliği metrikleri, videonun izlenme sayısı ve puanları (beğenme ve beğenmeme sayısı) gibi bilgileri içerir.
Uygulamanız için doğru API'yi seçin
- YouTube Analytics API'sı
- YouTube Analytics API, özel YouTube Analytics raporları oluşturmak için gerçek zamanlı hedeflenen sorguları destekler. API, filtreleme ve sıralama parametreleri sağladığından çağıran uygulamanın bu işlevleri yerel olarak desteklemesi gerekmez.
Her API isteği, verilerin döndürüleceği tarih aralığını belirtir. API ayrıca haftalık ve aylık veri kümeleri almanızı da sağlar. Dolayısıyla, çağıran uygulamanın alınan veri kümelerini depolaması veya tarih aralıkları genelinde istatistikleri toplaması gerekmez. - YouTube Reporting API
- YouTube Reporting API, bir kanal veya içerik sahibi için 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 madenciliği yapmak için araçlar sunan uygulamalar için tasarlanmıştır.
Her raporda önceden tanımlanmış bir alan grubu bulunur. Geliştiriciler API'yi kullanarak raporlama işlerini planlayabilir. Bu işlerin her biri, YouTube'un oluşturması gereken bir raporu tanımlar. Bunun ardından YouTube, 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 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 sağlar. - Altyazılarla ilgili kullanıcı etkinliği
- Oynatma listeleri için kitleyi elde tutma verileri
- İçerik sahipleri için tahmini gelir raporları (2 farklı rapor mevcuttur)
- İçerik sahipleri için öğe raporları (11 farklı rapor mevcuttur)
Desteklenen raporlar
Aşağıdaki tabloda, API'leri kullanarak alabileceğiniz farklı rapor türleri tanımlanmaktadır. Hedeflenen sorgular, YouTube Analytics API'si aracılığıyla, toplu raporlara ise YouTube Reporting API aracılığıyla erişilebilir.
Bir API'de bulunan veriler, diğerinde mevcut olmayabilir. Örneğin, YouTube Analytics API kullanıcı etkinliği metriklerini haftalık veya aylık olarak almanıza olanak tanırken, YouTube Reporting API bu verileri sizin toplamanızı gerektirir. Öte yandan YouTube Reporting API, içerik sahipleri için öğe raporlarını destekler ancak bu verilere YouTube Analytics API'den ulaşılamaz.
| Rapor türleri | |
|---|---|
| Video raporları | Kanallar (sorgu veya toplu) ve içerik sahipleri (sorgu veya toplu) için desteklenir. Video raporları, bir kanalın veya içerik sahibinin videolarıyla ilgili tüm kullanıcı etkinliklerine ait istatistikleri sağlar. Örneğin, bu raporlarda videolarınızın aldığı görüntüleme sayısı yer alır. YouTube Analytics API'deki bazı içerik sahibi video raporları, tahmini gelir ve reklam performansı metriklerini de içerir. |
| Oynatma listesi raporları | Kanallar (sorgu veya toplu) ve içerik sahipleri (sorgu veya toplu) için desteklenir. Oynatma listesi raporları, özellikle bir 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 raporları desteklemez. |
| Reklam performans raporları | İçerik sahipleri (sorgu veya toplu) 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 bir reklam gösterimini hesaba katar ve her video oynatma birden fazla gösterim sağlayabilir. |
| Tahmini gelir raporları | İçerik sahipleri için desteklenir (toplu). Tahmini gelir raporlarında, Google tarafından satılan reklam kaynaklarından ve reklam dışı kaynaklardan gelen videolar için toplam tahmini gelir gösterilir. 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 için desteklenir (toplu). Öğe raporları, içerik sahibinin öğelerine bağlı videolarla ilgili kullanıcı etkinliği metriklerini sağlar. İçerik sahibi, o videoyla ilgili içerik sahibinin öğelerinden birinin eşleşmesi olarak hak talebinde bulunduysa ilgili video 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 bölümünde ilgili raporlara erişimi olan içerik sahipleri için desteklenir. Sistem tarafından yönetilen raporlar, öğeler ve videolardan kazanılan gerçek gelir verilerini sağlar. Ek bir raporda, hak talebinde bulunulan videolar ve bu videoların eşleştiği öğeler listelenir. Şu anda İçerik Stüdyosu raporlarının şu anda API'de bulunmadığını unutmayın. 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 bu listedeki diğer rapor türlerinden farklıdır. Daha fazla bilgi için sistem tarafından yönetilen raporlar ile ilgili dokümanlara bakın. |
Önemli farklar
Aşağıdaki tabloda, YouTube Analytics ve Reporting API'leri arasındaki önemli farklılıklar gösterilmektedir.
| Öne Çıkarın | YouTube Analytics API'sı | YouTube Reporting API |
|---|---|---|
| Verileri alma işlemi | Her API isteği, döndürülecek boyutları ve metriklerin yanı sıra verilerin döndürüleceği dönemi belirtir. | 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ı, kullanıcı etkinliğinin gerçekleştiği tarihi belirtir. Bu raporlardan bazıları, kullanıcı etkinliği metriklerini aya göre toplayan boyutları destekler. | Tüm API raporları, kullanıcı etkinliğinin gerçekleştiği günü belirtir. API kullanan uygulamalar düzenli aralıklarla veri 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 kıta ve altKıta gibi bazı boyutları da destekler. | API, veri kümelerinin tamamının toplu olarak indirilmesini destekler. Filtrelemeyi desteklemez veya yalnızca filtreye sahip boyutlar için veri döndürmez. İ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ın listelendiği rapor maksimum 200 satır döndürür. | Bu API, veri kümelerinin tamamının toplu olarak indirilmesini destekler. İstemci uygulamaları, indirilen verileri sıralamak için kendi özelliklerini uygulayabilir. |
| Sıralamalar | API raporları, numaralandırılmış boyut değerlerini tanımlamak için "ANDROID" veya "CHANNEL" gibi metin değerleri içerir. | API raporları, metin değerleriyle eşlenebilecek tam sayılar içerir. |
| Kota | API sunucusu, kota maliyetini belirlemek için her sorguyu değerlendirir. Kota kullanımı bölümünde, bu metodoloji daha ayrıntılı olarak açıklanmaktadır. | Veriler bir kez alınıp uygulamada filtrelenip sıralandığından ve sorgulandığından kota kullanımı bir sorun oluşturmaz. |
| Benzersiz raporlar |
|
|
| Benzersiz boyutlar | group (yalnızca filtre boyutu) kıta (yalnızca filtre boyutu) subContinent (yalnızca filtre boyutu) month isCurated==1 (yalnızca filtrelenen boyut) viewsPerPlaylistStart Ortalama Oynatma Listesindeki Zaman |
annotation_id annotation_type asset_id card_id card_type live_or_on_demand subscribed_status subtitle_language |
| Benzersiz metrikler | benzersizskans relativeEnrollmentPerformance viewsPerPlaylistStart ortalamaZamanInPlaylist |
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} estimated_partner_doubleclick_revenue kaydettir |
API'ler arasındaki adlandırma farklılıkları
Bu iki API, boyutları ve metrikleri tanımlamak için şu anda farklı adlandırma kuralları kullanır. Şu anda YouTube Analytics API adları büyük/küçük harf kullanılırken YouTube Reporting API adları alt çizgiyle ayrılmış adlar kullanmaktadır.
Aşağıdaki tablolarda, iki API'nin aynı metrikleri ve boyutları tanımlamak için kullandığı farklı adlar açıklanmaktadır. Bazı durumlarda iki ad arasındaki fark, bir adı deve e-tablosundan alt çizgiye dönüştürdükten sonra elde edeceğinizden daha fazla olabilir. Örneğin, YouTube Analytics API'deki video boyutu YouTube Reporting API'de video_id olarak adlandırılır.