Introduction

Bu belgede, YouTube Analytics API ile YouTube Reporting API'nin YouTube Analytics verilerine erişim sağlama yöntemlerindeki 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. Buna ek olarak, her iki API de belirli bir rapor grubuna erişebilen YouTube kanal sahiplerini ve YouTube içerik sahiplerini destekler:

  • Kanal raporları, belirli bir 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 şirketinin tüm sanatçılarının YouTube kanalları için 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ı benzersiz bir boyut değerleri kombinasyonuna sahiptir. Bu nedenle, her bir satırın boyut değeri kombinasyonu, ilgili 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, video görüntüleme sayıları 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ğlar. Bu nedenle, ç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 sayesinde haftalık ve aylık veri kümeleri de alabilirsiniz. Dolayısıyla, çağıran uygulamanın alınan veri kümelerini depolamasına veya tarih aralıkları genelinde istatistikleri toplamasına gerek yoktur.
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 sağlayan uygulamalar için tasarlanmıştır.

Her raporda önceden tanımlanmış bir alan grubu bulunur. Geliştiriciler, raporlama işlerini planlamak için API'yi kullanır. Bu işlerin her biri, YouTube'un oluşturması gereken bir raporu tanımlar. 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.

Buna ek olarak YouTube, YouTube İçerik Stüdyosu'nda ilgili raporlara erişimi olan içerik sahipleri için otomatik olarak bir dizi sistem tarafından yönetilen rapor oluşturur. Bu raporlar, reklam geliri verilerine programatik erişim sağlar.

Desteklenen raporlar

Aşağıdaki tabloda, API'leri kullanarak alabileceğiniz farklı rapor türleri tanımlanmaktadır. Hedeflenen sorgular YouTube Analytics API'de, 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 erişilemez.

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 ilişkin istatistikler 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'si benzer bir raporu desteklemez.
Reklam performans raporları İçerik sahipleri için desteklenir (sorgu veya toplu).

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ı, Google tarafından satılan reklam kaynaklarından ve reklam harici kaynaklardan gelen videolar için 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 için desteklenir (toplu).

Öğe raporları, içerik sahibinin öğelerine bağlı videolarla ilgili kullanıcı etkinliği metriklerini sağlar. İçerik sahibi, video üzerinde içerik sahibinin öğelerinden biriyle ilgili olarak hak talebinde bulunduysa söz konusu 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 menüsünde ilgili raporlara erişimi olan içerik sahipleri için desteklenir.

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 videoların eşleştiği öğeler listelenir. Şu anda tüm İçerik Stüdyosu raporlarının API'de bulunmadığını unutmayın.

Not: YouTube, İçerik Stüdyosu'nda ilgili raporlara erişimi olan içerik sahipleri için otomatik olarak sistem tarafından yönetilen raporlar 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.

Temel farklar

Aşağıdaki tabloda, YouTube Analytics ve Reporting API'leri arasındaki önemli farklılıklar vurgulanmaktadır.

Öne Çıkarın YouTube Analytics API'sı YouTube Reporting API
Veri alma süreci 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 metriklerinin aya göre toplanmasını sağlayan boyutları destekler. Tüm API raporları, kullanıcı etkinliğinin gerçekleştiği günü belirtir. API'yı kullanan uygulamalar, verileri periyodik 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 kıta ve subContinent gibi bazı boyutları da destekler. API, veri kümelerinin tamamının toplu olarak indirilmesini destekler. Yalnızca filtre uygulanan boyutlar için filtrelemeyi veya veri döndürmeyi desteklemez. İ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, kanalın en çok görüntülenen videolarını listeleyen rapor en fazla 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şleştirilebilen tam sayılar içerir.
Kota API sunucusu, kota maliyetini belirlemek için her sorguyu değerlendirir. Bu yöntem, kota kullanımı bölümünde daha ayrıntılı olarak açıklanmaktadır. Veriler bir kez alındıktan sonra filtrelenip uygulama içinde sıralandığı ve sorgulandığı için kota kullanımı sorun teşkil etmez.
Benzersiz raporlar
  • 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)
Benzersiz boyutlar group (yalnızca filtre boyutu)
kıta (yalnızca filtre boyutu)
subContinent (yalnızca filtre boyutu)
ay
isCurated==1 (yalnızca filtre boyutu)
viewsPerPlaylistStart
averageTimeInPlaylist
annotation_id
annotation_type
asset_id
card_id
card_type
live_or_on_demand
subscribed_status
subtitle_language
Benzersiz metrikler benzersizs
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_addedplaylist_saves_removed

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ı kullanmaktadır. Şu anda YouTube Analytics API adları büyük-küçük harf kullanı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ı camelCase yerine 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.

Boyutlar

YouTube Analytics API adı YouTube Reporting API adı
adType ad_type
ageGroup age_group
öğe asset_id
audienceType audience_retention_type
kanal channel_id
claimedStatus claimed_status
contentOwner content_owner_id
country country_code
gün tarih
deviceType device_type
elapsedVideoTimeRatio elapsed_video_time_percentage
gender [cinsiyet] gender [cinsiyet]
insightPlaybackLocationDetail playback_location_detail
insightPlaybackLocationType playback_location_type
insightTrafficSourceDetail traffic_source_detail
insightTrafficSourceType traffic_source_type
liveOrOnDemand live_or_on_demand
operatingSystem operating_system
oynatma listesi playlist_id
province province_code
sharingService sharing_service
subscribedStatus subscribed_status
subtitleLanguage subtitle_language
uploaderType uploader_type
video video_id

Metrikler

YouTube Analytics API adı YouTube Reporting API adı
adEarnings estimated_partner_ad_revenue
annotationImpressions annotation_impressions
annotationClickableImpressions annotation_clickable_impressions
annotationClicks annotation_clicks
annotationClickThroughRate annotation_click_through_rate
annotationClosableImpressions annotation_closable_impressions
annotationCloses annotation_closes
annotationCloseRate annotation_close_rate
audienceWatchRatio audience_retention_percentage
averageViewDuration average_view_duration_seconds
averageViewPercentage average_view_duration_percentage
cardClickRate card_click_rate
cardClicks card_clicks
cardImpressions card_impressions
cardTeaserClickRate card_teaser_click_rate
cardTeaserClicks card_teaser_clicks
cardTeaserImpressions card_teaser_impressions
yorum yorum
beğenmeme beğenmeme
kazanç estimated_partner_revenue
estimatedMinutesWatched watch_time_minutes
estimatedPartnerAdSenseRevenue estimated_partner_adsense_revenue
estimatedPartnerDoubleClickRevenue estimated_partner_doubleclick_revenue
grossRevenue estimated_youtube_ad_revenue
impressionBasedCpm estimated_cpm
gösterim sayısı ad_impressions
beğeni beğeni
monetizedPlaybacks estimated_monetized_playbacks
playbackBasedCpm estimated_playback_based_cpm
playlistStarts playlist_starts
savesAdded playlist_saves_added
savesRemoved playlist_saves_removed
paylaşım paylaşım
subscribersGained subscribers_gained
subscribersLost subscribers_lost
videosAddedToPlaylists videos_added_to_playlists
videosRemovedFromPlaylists videos_removed_from_playlist
viewerPercentage views_percentage
görüntülemeler görüntülemeler