Method: properties.runPivotReport

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

string

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 istekte bu özelliğin ya belirtilmemiş olması ya da 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 (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
Alanlar
dimensions[]

object (Dimension)

İstenen boyutlar. Tanımlanmış tüm boyutlar, şunlardan biri tarafından kullanılmalıdır: dimensionExpression,dimensionFilter, pivots, orderBys.

metrics[]

object (Metric)

İ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[]

object (DateRange)

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 dateRanges belirtilmemelidir.

pivots[]

object (Pivot)

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

object (FilterExpression)

Boyutların filtre koşulu. Boyutların bu filtrede kullanılmaları için istenmesi gerekir. Bu filtrede metrikler kullanılamaz.

metricFilter

object (FilterExpression)

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

string

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

object (CohortSpec)

Bu istekle ilişkili grup grubu. "Kohort" isteğinde bir kohort grubu varsa boyutu bulunmalıdır.

keepEmptyRows

boolean

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 keepEmptyRows ayarından bağımsız olarak, raporlarda yalnızca Google Analytics (GA4) mülkü tarafından kaydedilen veriler gösterilebilir.

Örneğin, bir mülk hiçbir zaman purchase etkinliği günlüğe kaydetmediyse eventName boyutu ve eventCount metriği için sorguda eventName: "purchase" satırı bulunmaz. ve eventCount: 0.

returnPropertyQuota

boolean

Bu Analytics Mülküne ait kotanın mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, PropertyQuota bölümünde döndürülür.

comparisons[]

object (Comparison)

İ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