Method: properties.runRealtimeReport

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Mülkünüz için gerçek zamanlı etkinlik verilerinin özelleştirilmiş bir raporunu döndürür. Etkinlikler, Google Analytics'e gönderilmelerinden saniyeler sonra gerçek zamanlı raporlarda görünür. Gerçek zamanlı raporlar, geçerli andan 30 dakika öncesine kadar (Google Analytics 360 mülkleri için en fazla 60 dakika) etkinlik ve kullanım verilerini gösterir.

Gerçek zamanlı istekler oluşturma ve yanıtları anlama rehberi için Gerçek Zamanlı Rapor Oluşturma bölümüne bakın.

HTTP isteği

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runRealtimeReport

URL, gTB Kod Geçişi söz dizimini kullanır.

Yol parametreleri

Parametreler
property

string

Etkinlikleri izlenen bir Google Analytics GA4 mülkü tanımlayıcısı. URL yolunda belirtilir, gövdede belirtilmez. Daha fazla bilgi edinmek için Mülk kimliğinizi bulma başlıklı makaleyi inceleyin.

Örnek: mülkler/1234

İstek metni

İstek gövdesi aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "limit": string,
  "metricAggregations": [
    enum (MetricAggregation)
  ],
  "orderBys": [
    {
      object (OrderBy)
    }
  ],
  "returnPropertyQuota": boolean,
  "minuteRanges": [
    {
      object (MinuteRange)
    }
  ]
}
Alanlar
dimensions[]

object (Dimension)

İstenen boyutlar gösteriliyor.

metrics[]

object (Metric)

İstenen ve görüntülenen metrikler.

dimensionFilter

object (FilterExpression)

Boyutların filtre koşulu. Metrikler bu filtrede kullanılamaz.

metricFilter

object (FilterExpression)

Metriklerin filtre koşulu. SQL derlemesi adımına benzer şekilde, toplama sonrası aşamada uygulanır. Boyutlar bu filtrede kullanılamaz.

limit

string (int64 format)

Döndürülecek satır sayısı. Belirtilmemesi halinde 10.000 satır döndürülür. API, istediğiniz istek sayısı ne olursa olsun istek başına maksimum 100.000 satır döndürür. limit pozitif olmalıdır.

limit kadar boyut boyutu yoksa API, istenen limit öğesinden daha az satır da döndürebilir. Örneğin, country boyutu için 300'den az olası değer vardır. Bu nedenle, yalnızca country hakkında rapor oluşturduğunuzda limit değerini daha yüksek bir değere ayarlasanız bile 300'den fazla satır alamazsınız.

metricAggregations[]

enum (MetricAggregation)

Metriklerin toplamı. Toplu metrik değerleri,SizeValues'un "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir.

orderBys[]

object (OrderBy)

Yanıtta satırların nasıl sıralanacağını belirtir.

returnPropertyQuota

boolean

Bu Analytics Mülkü'nün Gerçek Zamanlı kotasının mevcut durumunu döndürüp döndürmeyeceğini belirler. Kota PropertyKotalar'ta döndürülür.

minuteRanges[]

object (MinuteRange)

Okunacak etkinlik verilerinin dakika aralıkları. Belirtilmemesi halinde son 30 dakika için bir dakikalık aralık kullanılır. Birden fazla dakika aralığı istenirse her yanıt satırında sıfır tabanlı bir dakika aralığı dizini bulunur. İki dakikalık aralıklar çakışırsa çakışan dakikalarla ilgili etkinlik verileri, her iki dakika aralığının yanıt satırlarına dahil edilir.

Yanıt metni

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Bir isteğe karşılık gelen yanıt gerçek zamanlı rapor tablosu.

JSON gösterimi
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "totals": [
    {
      object (Row)
    }
  ],
  "maximums": [
    {
      object (Row)
    }
  ],
  "minimums": [
    {
      object (Row)
    }
  ],
  "rowCount": integer,
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Alanlar
dimensionHeaders[]

object (DimensionHeader)

Boyut sütunlarını açıklar. Boyut Başlıkları'nın sayısı ve Boyut Başlıkları'nın sıralaması, satırlarda bulunan boyutlarla eşleşir.

metricHeaders[]

object (MetricHeader)

Metrik sütunlarını açıklar. MetricHeaders sayısı ve MetricHeaders sıralamaları, satırlardaki metriklerle eşleşir.

rows[]

object (Row)

Rapordaki boyut değeri kombinasyonları ve metrik değeri satırları.

totals[]

object (Row)

İstenirse metriklerin toplam değerleri.

maximums[]

object (Row)

İstenirse, metriklerin maksimum değerleri.

minimums[]

object (Row)

İstenirse, metriklerin minimum değerleri.

rowCount

integer

Sorgu sonucundaki toplam satır sayısı. rowCount, yanıtta döndürülen satır sayısından ve limit istek parametresinden bağımsızdır. Örneğin, bir sorgu 175 satır döndürürse ve API isteğinde limit/50 değerini içerirse yanıt, 175 üzerinden rowCount fakat yalnızca 50 satır içerir.

propertyQuota

object (PropertyQuota)

Bu istek dahil olmak üzere bu Analytics Mülkü'nün gerçek zamanlı kota durumu.

kind

string

Bu mesajın ne tür bir kaynak olduğunu tanımlar. Bu kind, her zaman sabit dizedir "analyticsData#runRealtimeReport" JSON'deki yanıt türlerini ayırt etmek için kullanışlıdır.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

Dakika Aralığı

Devam eden bir dakika kümesi: startMinutesAgo, startMinutesAgo + 1, ..., endMinutesAgo. İstekler en fazla 2 dakikalık aralıklara izin verir.

JSON gösterimi
{
  "name": string,
  "startMinutesAgo": integer,
  "endMinutesAgo": integer
}
Alanlar
name

string

Bu dakika aralığına bir ad atar. dateRange boyutu, rapor yanıtında bu ada sahip. Ayarlanmışsa date_range_ veya RESERVED_ ile başlayamaz. Ayarlanmazsa dakika aralıkları istekteki sıfır tabanlı diziniyle adlandırılır: date_range_0, date_range_1 vb.

startMinutesAgo

integer

Sorgunun kaç dakika önce başlayacağı dahil kapsayıcı başlangıç dakikası. Örneğin, "startMinutesAgo": 29, raporun 29 dakika ve sonrasına ait etkinlik verilerini içermesi gerektiğini belirtir. endMinutesAgo tarihinden sonra olamaz.

Belirtilmezse startMinutesAgo varsayılan olarak 29 değerine ayarlanır. Standart Analytics mülkleri, son 30 dakikaya kadar etkinlik verilerini (startMinutesAgo <= 29) isteyebilir ve 360 Analytics mülkleri, son 60 dakikaya kadar etkinlik verilerini (startMinutesAgo <= 59) isteyebilir.

endMinutesAgo

integer

Sorgunun kaç dakika önce gerçekleşeceğine dair bitiş tarihi. startMinutesAgo tarihinden önce olamaz. Örneğin, "endMinutesAgo": 15, raporun 15 dakika öncesine ait etkinlik verilerini içermesi gerektiğini belirtir.

Bir değer belirtilmezse endMinutesAgo varsayılan olarak 0 değerine ayarlanır. Standart Analytics mülkleri, etkinlik verilerinin son 30 dakika içindeki herhangi bir dakikasını (endMinutesAgo <= 29) ve 360 Analytics mülkleri, son 60 dakika içindeki etkinlik verilerini (endMinutesAgo <= 59) isteyebilir.