Google Analytics etkinlik verilerinizin özelleştirilmiş bir raporunu döndürür. Raporlar, Google Analytics izleme kodu tarafından toplanan verilerden türetilen istatistikleri içerir. API'den döndürülen veriler, istenen boyutlar ve metrikler için sütunlar içeren bir tablo gibidir. Metrikler, mülkünüzdeki kullanıcı etkinliklerinin (ör. etkin kullanıcı sayısı veya etkinlik sayısı) bağımsız ölçümleridir. Boyutlar, metrikleri ülke veya etkinlik adı gibi bazı yaygın ölçütlere göre ayırır.
İstek oluşturma ve yanıtları anlama ile ilgili kılavuz için Rapor Oluşturma'ya bakın.
HTTP isteği
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runReport
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. Bir toplu istekte, bu özellik belirtilmemiş veya toplu düzeydeki özellikle tutarlı olmalıdır. Ö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. |
dateRanges[] |
Okunacak verilerin tarih aralıkları. Birden fazla tarih aralığı istenirse her yanıt satırı sıfır tabanlı bir tarih aralığı dizini içerir. İki tarih aralığı çakışırsa çakışan günlere ait etkinlik verileri her iki tarih aralığının yanıt satırlarına eklenir. Grup isteğinde bu |
dimensionFilter |
Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi edinmek için Boyut Filtreleriyle İlgili Temel Bilgiler başlıklı makaleyi inceleyin. Metrikler bu filtrede kullanılamaz. |
metricFilter |
Metriklerin filtre ifadesi. SQL'in yan tümcesine benzer şekilde, raporun satırları toplandıktan sonra uygulanır. Boyutlar bu filtrede kullanılamaz. |
offset |
Başlangıç satırının satır sayısıdır. İlk satır, 0. satır olarak sayılır. Sayfalara ayırma sırasında, ilk istek ofseti belirtmez veya eşdeğer olarak ofseti 0 değerine ayarlar; ilk istek satırların ilk Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın. |
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, Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın. |
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. |
currencyCode |
"AED", "USD", "JPY" gibi ISO4217 biçiminde bir para birimi kodu. Alan boşsa rapor mülkün varsayılan para birimini kullanır. |
cohortSpec |
Bu istekle ilişkili kohort grubu. İstekte bir kohort grubu varsa "kohort" boyutu bulunmalıdır. |
keepEmptyRows |
Yanlış veya belirtilmemişse tüm metriklerin 0'a eşit olduğu her bir satır döndürülmez. Doğru değerine ayarlanırsa bu satırlar bir filtre tarafından ayrı olarak kaldırılmazsa döndürülür. Bu Örneğin, bir mülk hiçbir zaman bir |
returnPropertyQuota |
Bu Analytics Mülkü'nün 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. |
comparisons[] |
İsteğe bağlı. İstenen ve görüntülenen karşılaştırmaların yapılandırılması. İstek, yanıtta karşılaştırma sütunu alabilmek için yalnızca karşılaştırmalar alanına ihtiyaç duyar. |
Yanıt gövdesi
Başarılıysa yanıt metni, RunReportResponse
öğesinin bir örneğini içerir.
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics