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 ifade gücü yüksek biçimlerdir. Bir pivot raporda, boyutlar yalnızca bir özete dahil olduklarında görünür. Verilerinizi daha ayrıntılı bir şekilde 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ö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 (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
}
Alanlar
dimensions[]

object (Dimension)

İstenen boyutlar. Tanımlanan tüm boyutlar, şunlardan biri tarafından kullanılmalıdır: dimensionExpression,dimensionFilter, pivotlar, orderBys.
metrics[]

object (Metric)

İstenen metrikler, en az bir metriğin belirtilmesi gerekir. 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ığındaki etkinlik verileri kullanılır. Bir Pivot'un alan adlarına"dateRange" alan adına sahip özel bir boyut eklenebilir. Bu boyut eklenirse rapor, tarih aralıkları arasında karşılaştırma yapar. Grup isteğinde bu dateRanges belirtilmemelidir.
pivots[]

object (Pivot)

Rapor boyutlarının sütunlar veya satırlardaki görsel biçimini açıklar. Tüm pivotlardaki alan adlarının (boyut adları) birleşimi, Boyutlar'da tanımlanan boyut adlarının bir alt kümesi olmalıdır. Hiçbir pivot tablo aynı boyutu paylaşamaz. Bir boyut yalnızca bir özette yer alıyorsa görünür.
dimensionFilter

object (FilterExpression)

Boyutların filtre ifadesi. Boyutların bu filtrede kullanılması istenmelidir. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre ifadesi. SQL toplama yan tümcesine benzer şekilde, toplama sonrası aşamasında uygulanır. Metriklerin bu filtrede kullanılması istenmelidir. Boyutlar bu filtrede kullanılamaz.
currencyCode

string

"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

object (CohortSpec)

Bu istekle ilişkili kohort grubu. İstekte bir kohort grubu varsa "kohort" boyutu bulunmalıdır.
keepEmptyRows

boolean

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 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 bir purchase etkinliğini günlüğe kaydetmemişse eventName boyutu ve eventCount metriği için yapılan sorguda eventName adlı satır bulunmaz: "purchase" ve eventCount: 0.
returnPropertyQuota

boolean

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.

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