Method: properties.runPivotReport

Google Analytics etkinlik verilerinizin özelleştirilmiş bir pivot raporunu döndürür. Pivot raporlar, normal raporlardan daha gelişmiş ve ifade biçimleridir. Bir pivot raporda boyutlar yalnızca bir özete dahil edildiğinde görünür olur. Verilerinizi daha ayrıntılı bir şekilde incelemek için birden çok 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 GA4 mülk tanımlayıcısı. Gövdede değil, URL yolunda belirtilir. Daha fazla bilgi için Mülk kimliğinizi nerede bulacağınızı öğrenin. Toplu istekte, bu özellik belirtilmemiş veya grup düzeyindeki mülkle tutarlı olmalıdır.

Örnek: mülkler/1234

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla 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 gerekiyor. Tanımlanan tüm metrikler şunlardan biri tarafından kullanılmalıdır: parameter_expression, metricFilter, orderBys.
dateRanges[]

object (DateRange)

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. 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ütun veya satırlardaki 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 bir boyutu paylaşamaz. Boyutlar yalnızca bir özette görünüyorsa görünür olur.
dimensionFilter

object (FilterExpression)

Boyutların filtre koşulu. Boyutların bu filtrede kullanılması istenmelidir. Metrikler bu filtrede kullanılamaz.
metricFilter

object (FilterExpression)

Metriklerin filtre koşulu. SQL'in tüm maddesine benzer şekilde toplama sonrası aşamasında uygulanır. Metriklerin bu filtrede kullanılması istenmelidir. Boyutlar bu filtrede kullanılamaz.
currencyCode

string

ISO4217 biçiminde bir para birimi kodu (ör. "AED", "USD", "JPY"). 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 "grup" boyutu bulunmalıdır.
keepEmptyRows

boolean

Yanlış veya ayarlanmadan bırakılırsa tüm metriklerin 0'a eşit olduğu her 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, raporda yalnızca Google Analytics (GA4) mülkü tarafından kaydedilen veriler görüntülenebilir.

Örneğin bir mülk hiçbir zaman bir purchase etkinliğini günlüğe kaydetmezse eventName boyutu ve eventCount metriği için yapılan sorguda satır eventName ("purchase" ve eventCount: 0) bulunmaz.
returnPropertyQuota

boolean

Bu Analytics Mülkü'nün kotasının mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, ÖzellikQuota 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