Kaynak Tabanlı Kota

Bu belgede, yalnızca Analytics 360 müşterilerinin kullanabileceği Google Analytics Reporting API v4 için Kaynak Tabanlı Kota sistemi açıklanmaktadır. API'lere uygulanan sınırların tamamı için API Sınırları ve Kotalar sayfasına bakın.

Giriş

Paylaşılan kaynakların kullanılabilirliğini ve güvenilirliğini sağlamak için Analytics Reporting API'ye erişen her proje sınırlara ve kotalara tabidir. Büyük veri kümelerini sorgularken Analytics Reporting API tarafından örnekleme yöntemi kullanılabilir. Bu API, verilerinizin sonuçlarını etkileyebilir.

Kaynak tabanlı kota sistemi, Analytics Reporting API'yi kullanırken Analytics 360 hesaplarının daha yüksek örnekleme eşiklerine sahip olmasını sağlayacak yeni bir kota sistemidir. Bu sistem isteğe bağlıdır ve Google API Konsolu'nun kotalar sayfasında bildirilenler gibigörüntülemelere ve projelere eklenen mevcut sınırlardanbağımsızdır.

Kaynak tabanlı kota

Tüm istekler eşit değildir. Bazı istekler, işlem açısından diğerlerine göre çok daha pahalıdır. Kaynak tabanlı kota sistemi, daha yüksek bir örnekleme eşiğini destekleyecek ve Analytics Raporlama altyapısını korumaya devam edecek şekilde tasarlanmıştır.

Her mülke belirli bir miktarda sorgu kaynağı jetonu verilir. API istemcisi, göreli sorgu kaynağı jetonları karşılığında daha yüksek bir örnekleme eşiği almak için API isteğine isteğe bağlı bir alan ekleyebilir. Hesaplamayla ilgili daha pahalı bir istek için daha fazla jeton gerekir.

Örnekleme eşiği

Google Analytics API v4'ü kullanan veri istekleri, istenen tarih aralığı (mülk düzeyinde) için oturum sayısına dayalı olarak aşağıdaki genel örnekleme eşiklerine tabidir:

  • Analytics Standart: 500 bin oturum
  • Analytics 360: 1 milyon oturum
  • Kaynak tabanlı kota kullanan Analytics 360: 100 milyon oturum

Kaynak Tabanlı Kotayı Etkinleştirme

Belirli bir istek için kaynak tabanlı kotaları etkinleştirmek üzere API çağrısının batchGet yönteminde isteğe bağlı useResourceQuotas alanını içermesi gerekir.

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

Örneğin:

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

Sorgu kaynağı maliyet yanıtı alanı

batchGet yöntemine yapılan her çağrıda bir queryCost alanı bulunur.

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

queryCost alanı, batchGet isteğindeki tüm ReportRequests öğelerinin toplam kaynak maliyetini temsil eden bir tam sayıdır. Örneğin:

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

Kota ayırma

Analytics 360 mülk kotası

  • Mülk başına günlük 100.000 sorgu maliyet birimi.
  • Mülk başına saatte 25.000 sorgu maliyet birimi.

Kota sınırınızı aşarsanız RESOURCE_EXHAUSTED hatası alırsınız. Ayrıntılar için Hata Yanıtları başlıklı makaleye bakın.

Maliyet hesaplaması

Bir isteğin maliyeti şunlarla orantılıdır:

  • Tarih aralığının boyutu.
  • Görünümdeki isabet sayısı.
  • İstenen boyutların kardinalitesi.
  • İstenen boyutların ve metriklerin sayısı.
  • Segment ve filtre tanımlarının karmaşıklığı.
  • İstenen bilgilerin işleme durumu (bugünkü verileri istemek, dünkü verileri istemekten daha pahalıdır).
  • Sorgu Zamanını içe aktarma boyutları ve metriklerinin varlığı.

API sınırları ve kullanımı

API'ler, kaynak tabanlı kota sistemine ek olarak Analytics API v4'teki sınırlara ve kotalara da tabidir.

Notlar

  • queryCost yanıt alanı, bir isteğin işlem maliyetini temsil eder. Parasal bir maliyet söz konusu değildir ve API'yı kullanmak ücretsizdir.
  • Gün içi ve belirli geçmiş veriler (1+ yaş) raporları, useResourceQuotas ayarından bağımsız olarak örneklemeye tabi tutulabilir.
  • Bir istek için daha yüksek bir örnekleme eşiği karşılanamazsa kaynak kotası jetonları düşülmez (Örneklenmiş yanıtların her zaman kaynak kota maliyeti yoktur).
  • Yanıtta samplesReadCounts, samplingSpaceSizes alanları varsa rapor örneklenmiş veriler içerir.

Projenizin kullanım sınırlarını görüntülemek, değiştirmek veya kotanızda artış talep etmek için şunları yapın:

  1. Projeniz için faturalandırma hesabınız yoksa hesap oluşturun.
  2. API Konsolu'nda API kitaplığının Etkin API'ler sayfasını ziyaret edin ve listeden bir API seçin.
  3. Kota ile ilgili ayarları görüntülemek ve değiştirmek için Kotalar'ı seçin. Kullanım istatistiklerini görüntülemek için Kullanım'ı seçin.