Mülkünüz için gerçek zamanlı etkinlik verilerinden oluşan ö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, geçerli andan 30 dakika öncesine kadar (Google Analytics 360 mülkleri için 60 dakikaya kadar) zaman aralıklarına ait etkinlik 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 bulabileceğinize bakın. Örnek: mülkler/1234 |
İstek içeriği
İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:
JSON gösterimi |
---|
{ "dimensions": [ { object ( |
Alanlar | |
---|---|
dimensions[] |
İstenen ve görüntülenen boyutlar. |
metrics[] |
İstenen ve görüntülenen metrikler. |
dimensionFilter |
Boyutların filtre ifadesi. Metrikler bu filtrede kullanılamaz. |
metricFilter |
Metriklerin filtre ifadesi. SQL'in 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ı. Belirtilmemişse 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ı. Birleştirilmiş 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, PropertyQuota içinde döndürülür. |
minuteRanges[] |
Okunacak etkinlik verilerinin dakika aralıkları. Belirtilmezse son 30 dakika için bir dakikalık aralık 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'ın sayısı ve MetricHeaders'ın 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 minimum metrik 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 2 dakikalık aralıklara kadar izin verilir.
JSON gösterimi |
---|
{ "name": string, "startMinutesAgo": integer, "endMinutesAgo": integer } |
Alanlar | |
---|---|
name |
Bu dakika aralığına bir ad atar. Bir rapor yanıtında |
startMinutesAgo |
Şu andan itibaren dakika öncesi şeklinde sorgu için dahil başlangıç dakikası. Örneğin Belirtilmemişse varsayılan olarak |
endMinutesAgo |
Şu andan önceki dakika sayısı şeklinde sorgu için dahil olan bitiş dakikası. Belirtilmemişse |