Google Analytics etkinlik verilerinizin özelleştirilmiş bir pivot raporunu döndürür. Pivot raporlar, normal raporlara göre daha gelişmiş ve anlamlı biçimlerdir. Bir pivot raporunda, boyutlar yalnızca özete dahil edilirse görünür. Verilerinizi daha ayrıntılı olarak incelemek için birden çok özet belirtilebilir.
HTTP isteği
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport
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 edinmek için Mülk Kimliğinizi nerede bulabileceğinizi öğrenin. Toplu istek içinde, bu özelliğin belirtilmemiş olması veya grup düzeyindeki özellikle tutarlı olması gerekir. Örnek: mülkler/1234 |
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{ "dimensions": [ { object ( |
Alanlar | |
---|---|
dimensions[] |
İstenen boyutlar. Tanımlanmış tüm boyutlar, şunlardan biri tarafından kullanılmalıdır: dimensionExpression,dimensionFilter, pivots, orderBys. |
metrics[] |
İstenen metrikler, en az bir metriğin belirtilmesi gerekiyor. Tanımlanan tüm metrikler şunlardan biri tarafından kullanılmalıdır: metric_expression, metricFilter, orderBys. |
dateRanges[] |
Rapordaki etkinlik verilerinin alınacağı tarih aralığı. Birden çok tarih aralığı belirtilirse raporda her bir tarih aralığına ait etkinlik verileri kullanılır. Alan adı "dateRange" olan özel bir boyut Özet'in alan adlarına dahil edilebilir; varsa rapor, tarih aralıkları arasında karşılaştırma yapar. Bir kohort isteğinde bu |
pivots[] |
Rapordaki boyutların görsel biçimini sütun veya satırlar halinde açıklar. Tüm özetlerdeki FieldNames toplamı (boyut adları), Boyutlar'da tanımlanan boyut adlarının bir alt kümesi olmalıdır. Hiçbir özet bir boyutu paylaşamaz. Bir boyut yalnızca özette yer alıyorsa görünür. |
dimensionFilter |
Boyutların filtre koşulu. Boyutların bu filtrede kullanılmaları için istenmesi gerekir. Bu filtrede metrikler kullanılamaz. |
metricFilter |
Metriklerin filtre koşulu. SQL'in sahip tümcesine benzer şekilde, toplama sonrası aşamada uygulanır. Metriklerin bu filtrede kullanılmaları için istenmesi gerekir. Boyutlar bu filtrede kullanılamaz. |
currencyCode |
ISO4217 biçiminde, "AED", "USD", "JPY" gibi bir para birimi kodu. Alan boşsa raporda mülkün varsayılan para birimi kullanılır. |
cohortSpec |
Bu istekle ilişkili grup grubu. "Kohort" isteğinde bir kohort grubu varsa boyutu bulunmalıdır. |
keepEmptyRows |
Yanlış veya belirtilmediyse 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ılmadıklarında döndürülür. Bu Örneğin, bir mülk hiçbir zaman |
returnPropertyQuota |
Bu Analytics Mülküne ait kotanın mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, PropertyQuota özelliğinde döndürülür. |
comparisons[] |
İsteğe bağlı. İstenen ve görüntülenen karşılaştırmaların yapılandırması. İstekte karşılaştırma sütunu alabilmek için hem karşılaştırmalar alanı hem de karşılaştırmalar boyutu gerekir. |
Yanıt gövdesi
Başarılıysa yanıt metni, RunPivotReportResponse
öğ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