- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt gövdesi
- Yetkilendirme Kapsamları
- Dakika Aralığı
- Deneyin.
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 |
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 ( |
Alanlar | |
---|---|
dimensions[] |
İstenen boyutlar gösteriliyor. |
metrics[] |
İstenen ve görüntülenen metrikler. |
dimensionFilter |
Boyutların filtre koşulu. Metrikler bu filtrede kullanılamaz. |
metricFilter |
Metriklerin filtre koşulu. SQL derlemesi adımına benzer şekilde, toplama sonrası aşamada 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, istediğiniz istek sayısı ne olursa olsun istek başına maksimum 100.000 satır döndürür.
|
metricAggregations[] |
Metriklerin toplamı. Toplu metrik değerleri,SizeValues'un "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir. |
orderBys[] |
Yanıtta satırların nasıl sıralanacağını belirtir. |
returnPropertyQuota |
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[] |
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 ( |
Alanlar | |
---|---|
dimensionHeaders[] |
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[] |
Metrik sütunlarını açıklar. MetricHeaders sayısı ve MetricHeaders sıralamaları, satırlardaki metriklerle eşleşir. |
rows[] |
Rapordaki boyut değeri kombinasyonları ve metrik değeri 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ığı
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 |
Bu dakika aralığına bir ad atar. |
startMinutesAgo |
Sorgunun kaç dakika önce başlayacağı dahil kapsayıcı başlangıç dakikası. Örneğin, Belirtilmezse |
endMinutesAgo |
Sorgunun kaç dakika önce gerçekleşeceğine dair bitiş tarihi. Bir değer belirtilmezse |