Mülkünüz için gerçek zamanlı etkinlik verilerini içeren özelleştirilmiş bir rapor döndürür. Etkinlikler, Google Analytics'e gönderildikten birkaç saniye 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) arasındaki zaman dilimlerine ait etkinlikleri ve kullanım verilerini gösterir.
Gerçek zamanlı istekler oluşturma ve yanıtları anlamayla 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övdede değil, URL yolunda belirtilir. Daha fazla bilgi için Mülk kimliğinizi nerede bulacağınızı öğrenin. Örnek: mülkler/1234 |
İstek içeriği
İstek gövdesi, aşağıdaki yapıyla 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 koşulu. Metrikler bu filtrede kullanılamaz. |
metricFilter |
Metriklerin filtre koşulu. SQL'in tüm maddesine benzer şekilde toplama sonrası aşamasında uygulanır. Boyutlar bu filtrede kullanılamaz. |
limit |
Döndürülecek satır sayısı. Belirtilmemesi durumunda 10.000 satır döndürülür. API, istediğiniz sayıda satırdan bağımsız olarak istek başına maksimum 250.000 satır döndürür. Ayrıca, |
metricAggregations[] |
Metriklerin toplanması. Toplu metrik değerleri, boyutValues değerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir. |
orderBys[] |
Satırların yanıtta nasıl sıralanacağı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 belirler. Kota, ÖzellikQuota içinde döndürülür. |
minuteRanges[] |
Okunacak etkinlik verilerinin dakika aralıkları. Belirtilmezse 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ığı ç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. Boyut Üstbilgilerinin sayısı ve dimensionHeaders sıralaması satırlarda bulunan boyutlarla eşleşir. |
metricHeaders[] |
Metrik sütunlarını açıklar. MetricHeaders sayısı ve MetricHeaders sıralaması, satırlarda bulunan 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
Dakika Aralığı
Bitişik bir dakika grubu: startMinutesAgo
, startMinutesAgo + 1
, ..., endMinutesAgo
. İstekler için 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 andan önceki dakika sayısı olarak sorgunun başlangıç dakikası. Örneğin Belirtilmemesi halinde |
endMinutesAgo |
Sorgu için şu andan önceki dakika sayısını içeren bitiş dakikası. Belirtilmemesi halinde |