Google Analytics etkinlik verilerinizin özelleştirilmiş bir pivot raporunu döndürür. Pivot raporlar, normal raporlara göre daha gelişmiş ve etkileyici biçimlerdir. Bir pivot raporda boyutlar yalnızca bir pivota dahil olduklarında görünür. Verilerinizi daha ayrıntılı analiz etmek 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 için Mülk Kimliğinizi nerede bulabileceğinize bakın. Toplu istekte, bu özellik belirtilmemiş veya toplu düzeyindeki özellikle tutarlı olmalıdır. Ö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 boyutlar. Tanımlanan tüm boyutlar şunlardan biri tarafından kullanılmalıdır: boyutExpression, boyutFiltresi, pivotlar, siparişBys. |
metrics[] |
İstenen metrikler. En az bir metrik belirtilmelidir. Tanımlanan tüm metrikler şunlardan biri tarafından kullanılmalıdır: metrik_ifadesi, metrikFiltresi, siparişBys. |
dateRanges[] |
Rapor için etkinlik verilerinin alınacağı tarih aralığı. Birden fazla tarih aralığı belirtilirse raporda her bir tarih aralığındaki etkinlik verileri kullanılır. "dateRange" alan adına sahip özel bir boyut, Pivot Pivot'un alan adlarına dahil edilebilir. Eklenmesi durumunda, rapor tarih aralıkları arasında karşılaştırma yapar. Grup isteğinde bu |
pivots[] |
Rapor boyutlarının sütun veya satırlarda görsel biçimini açıklar. Tüm pivotlardaki fieldName'lerin (boyut adları) birleşimi, Boyutlar'da tanımlanan boyut adlarının bir alt kümesi olmalıdır. Hiçbir pivot tablo bir boyutu paylaşamaz. Bir boyut yalnızca bir özette yer alıyorsa görünür. |
dimensionFilter |
Boyutların filtre ifadesi. Boyutların bu filtrede kullanılması istenmelidir. Metrikler bu filtrede kullanılamaz. |
metricFilter |
Metriklerin filtre ifadesi. SQL'in yan tümcesine benzer şekilde toplama sonrası aşamasında uygulanır. Metriklerin bu filtrede kullanılması istenmelidir. Boyutlar bu filtrede kullanılamaz. |
currencyCode |
"AED", "USD", "JPY" gibi ISO4217 biçimindeki 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. İstekte bir kohort grubu varsa "kohort" boyutu bulunmalıdır. |
keepEmptyRows |
Yanlış değerine ayarlanırsa veya belirtilmemişse tüm metriklerin 0'a eşit olduğu her satır döndürülmez. True (doğru) değerine ayarlanırsa bu satırlar bir filtre tarafından ayrıca kaldırılmazsa döndürülür. Bu Örneğin, bir mülk hiçbir zaman |
returnPropertyQuota |
Bu Analytics Mülkü'nün 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. |
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