Method: properties.runPivotReport

Google Analytics etkinlik verilerinizin özelleştirilmiş bir pivot raporunu döndürür. Pivot raporlar, normal raporlardan daha gelişmiş ve etkileyici biçimlerdir. Pivot raporlarda boyutlar yalnızca bir pivot'a dahil edilmişse görünür. Verilerinizi daha ayrıntılı incelemek için birden fazla pivot 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 mülkü kimliği. Gövdede değil, URL yolunda belirtilir. Daha fazla bilgi için mülk kimliğinizi nerede bulabileceğinize bakın. Bu özellik, toplu istek içinde belirtilmemiş veya toplu düzeydeki mülkle tutarlı olmalıdır.

Örnek: mülkler/1234

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte 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 aşağıdakilerden biri tarafından kullanılmalıdır: dimensionExpression, dimensionFilter, pivots, orderBys.
metrics[]

object (Metric)

İstenen metrikler. En az bir metrik belirtilmelidir. Tanımlanmış tüm metrikler aşağıdakilerden biri tarafından kullanılmalıdır: metric_expression, metricFilter, orderBys.
dateRanges[]

object (DateRange)

Raporun etkinlik verilerinin alınacağı tarih aralığı. Birden fazla tarih aralığı belirtilirse raporda her tarih aralığındaki etkinlik verileri kullanılır. "dateRange" alan adına sahip özel bir boyut, pivot tablonun alan adlarına dahil edilebilir. Bu boyut dahil edildiğinde rapor, tarih aralıklarını karşılaştırır. Bir kohort isteğinde bu dateRanges belirtilmemelidir.
pivots[]

object (Pivot)

Raporun sütun veya satırlardaki boyutlarının görsel biçimini açıklar. Tüm pivotlardaki fieldNames'ların (boyut adları) birleşimi, Boyutlar'da tanımlanan boyut adlarının alt kümesi olmalıdır. Hiçbir pivot bir boyutu paylaşamaz. Boyutlar yalnızca bir pivot'ta göründüğünde görünür.
dimensionFilter

object (FilterExpression)

Boyutların filtre ifadesi. Boyutların bu filtrede kullanılması için istenmesi gerekir. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre ifadesi. SQL having-clause'a benzer şekilde, toplama sonrası aşamada uygulanır. Metriklerin bu filtrede kullanılması istenmelidir. Boyutlar bu filtrede kullanılamaz.
currencyCode

string

ISO4217 biçiminde bir para birimi kodu ("AED", "USD", "JPY" gibi). Alan boşsa raporda mülkün varsayılan para birimi kullanılır.
cohortSpec

object (CohortSpec)

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

boolean

Yanlış veya belirtilmemişse tüm metrikleri 0 olan her satır döndürülmez. Doğru ise bir filtre tarafından ayrı olarak kaldırılmazlarsa bu satırlar döndürülür.

Bu keepEmptyRows ayarından bağımsız olarak, raporlarda yalnızca Google Analytics mülkü tarafından kaydedilen veriler gösterilebilir.

Örneğin, bir mülk hiçbir zaman purchase etkinliği günlüğe kaydetmezse eventName boyutu ve eventCount metriği için bir sorgu, eventName: "purchase" ve eventCount: 0 satırına sahip olmaz.
returnPropertyQuota

boolean

Bu Google 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.
comparisons[]

object (Comparison)

İsteğe bağlı. İstenen ve görüntülenen karşılaştırmaların yapılandırması. İstekte, yanıtta bir karşılaştırma sütunu almak 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