Kaynak Tabanlı Kota

Bu belgede, yalnızca Analytics 360 müşterilerinin kullanabildiğ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ı'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, örnekleme yöntemini kullanabilir ve bu da 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 gibi görünümler ve projeler için belirlenen mevcut sınırlardan bağımsızdır.

Kaynak tabanlı kota

Tüm istekler eşit oluşturulmaz; bazı istekler işlemsel olarak diğerlerinden çok daha pahalıdır. Kaynak tabanlı kota sistemi, Analytics Raporlama altyapısını korurken daha yüksek bir örnekleme eşiğini destekleyecek şekilde tasarlanmıştır.

Her mülke belirli miktarda sorgu kaynağı jetonu ayrılır. API istemcisi, göreli sorgu kaynak 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. Hesaplama açısından daha pahalı olan bir istek için daha fazla jeton gerekir.

Örnekleme eşiği

Google Analytics API v4 kullanılarak veri gönderilen istekler, istenen tarih aralığı için (mülk düzeyinde) oturum sayısına bağlı 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ştir

Belirli bir istekte kaynak tabanlı kotaları etkinleştirmek için API çağrısı, batchGet yönteminde isteğe bağlı useResourceQuotas alanını içermelidir.

{
  "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 kaynak maliyeti yanıt alanı

batchGet yöntemine yapılan her çağrı için yanıtta bir queryCost alanı olacaktır.

{
  "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 saatlik 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ı bölümüne bakın.

Maliyet hesaplaması

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

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

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

API'ler, kaynak tabanlı kota sisteminin yanı sıra Analytics API v4'teki sınırlara ve kotalara da tabidir.

Notlar

  • queryCost yanıt alanı, bir isteğin işlem maliyetini gösterir. Parasal bir maliyet yoktur ve API'nin kullanımı ücretsizdir.
  • Gün içi ve bazı geçmiş veri (1 yıldan eski) raporlar, useResourceQuotas ayarından bağımsız olarak örneklemeye tabi olabilir.
  • Bir istek için daha yüksek bir örnekleme eşiği karşılanamazsa kaynak kota jetonları düşülmez (örneklenmiş yanıtların kaynak kotası her zaman sıfır maliyeti olur).
  • 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.