Mülkünüz için gerçek zamanlı etkinlik verileriyle ilgili özelleştirilmiş bir rapor döndürür. Etkinlikler, Google Analytics'e gönderildikten saniyeler sonra gerçek zamanlı raporlarda görünür. Gerçek zamanlı raporlar, içinde bulunulan andan 30 dakika öncesine kadar (Google Analytics 360 mülkleri için 60 dakikaya kadar) zaman aralıklarına ait etkinlikleri ve kullanım verilerini gösterir.
Gerçek zamanlı istekler oluşturma ve yanıtları anlama ile ilgili kılavuz için Gerçek Zamanlı Rapor Oluşturma başlıklı makaleyi inceleyin.
HTTP isteği
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runRealtimeReport
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
property |
Etkinlikleri izlenen bir Google Analytics GA4 mülkü tanımlayıcısı. Gövde metninde değil, URL yolunda belirtilir. Daha fazla bilgi için Mülk kimliğinizi nerede bulacağınızı öğrenin. Örnek: mülkleri/1234 |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "dimensions": [ { object ( |
Alanlar | |
---|---|
dimensions[] |
İstenen ve görüntülenen boyutlar. |
metrics[] |
İstenen ve gösterilen metrikler. |
dimensionFilter |
Boyutların filtre ifadesi. Metrikler bu filtrede kullanılamaz. |
metricFilter |
Metriklerin filtre ifadesi. SQL toplama yan tümcesine benzer şekilde, toplama sonrası aşamasında uygulanır. Boyutlar bu filtrede kullanılamaz. |
limit |
Döndürülecek satır sayısı. Belirtilmemesi halinde 10.000 satır döndürülür. API, kaç tane istediğinize bakılmaksızın istek başına maksimum 250.000 satır döndürür. Ayrıca, |
metricAggregations[] |
Metriklerin toplamı. Toplu metrik değerleri,dimensionValues değerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir. |
orderBys[] |
Yanıtta satırların nasıl sıralandığını belirtir. |
returnPropertyQuota |
Bu Analytics Mülkü'nün Gerçek Zamanlı kotasının mevcut durumunun döndürülüp döndürülmeyeceğini değiştirir. Kota, PropertyQuota içinde döndürülür. |
minuteRanges[] |
Okunacak etkinlik verilerinin dakika aralıkları. Belirtilmemişse son 30 dakika için bir dakika aralığı kullanılır. Birden fazla dakika aralığı istenirse her yanıt satırı sıfır tabanlı bir dakika aralığı dizini içerir. İki dakika aralıkları çakışırsa çakışan dakikalara ait etkinlik verileri her iki dakika aralığının yanıt satırlarına eklenir. |
Yanıt gövdesi
Bir isteğe karşılık gelen yanıt gerçek zamanlı rapor tablosu.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "dimensionHeaders": [ { object ( |
Alanlar | |
---|---|
dimensionHeaders[] |
Boyut sütunlarını açıklar. DimensionHeaders sayısı ve DimensionHeaders öğesinin sıralaması, satırlarda bulunan boyutlarla eşleşir. |
metricHeaders[] |
Metrik sütunlarını açıklar. MetricHeaders'ın sayısı ve MetricHeaders'ın sıralaması, satırlardaki metriklerle eşleşir. |
rows[] |
Rapordaki boyut değeri kombinasyonları ve metrik değerleri satırları. |
totals[] |
İstenirse metriklerin toplam değerleri. |
maximums[] |
İstenirse metriklerin maksimum değerleri. |
minimums[] |
İstenirse metriklerin minimum değerleri. |
rowCount |
Sorgu sonucundaki toplam satır sayısı. |
propertyQuota |
Bu istek dahil olmak üzere bu Analytics Mülkü'nün gerçek zamanlı kota durumu. |
kind |
Bu mesajın ne tür bir kaynak olduğunu tanımlar. Bu |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
MinuteRange
Bitişik dakika grubu: startMinutesAgo
, startMinutesAgo + 1
, ..., endMinutesAgo
. İstekler için en fazla 2 dakikalık aralıklara izin verilir.
JSON gösterimi |
---|
{ "name": string, "startMinutesAgo": integer, "endMinutesAgo": integer } |
Alanlar | |
---|---|
name |
Bu dakika aralığına bir ad atar. |
startMinutesAgo |
Şu ana kadarki dakika sayısı şeklinde sorgu için dahil başlangıç dakikası. Örneğin Belirtilmemesi halinde |
endMinutesAgo |
Şu ana kadarki dakika sayısı olarak sorgunun dahil olduğu bitiş dakikası. Bir değer belirtilmezse |