Dimension

Dimensi merupakan atribut data Anda. Misalnya, kota dimensi menunjukkan kota tempat peristiwa berasal. Nilai dimensi dalam respons laporan adalah string; misalnya, kota bisa berupa "Paris" atau "New York". Permintaan diizinkan hingga 9 dimensi.

Representasi JSON
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Kolom
name

string

Nama dimensi. Lihat Dimensi API untuk mengetahui daftar nama dimensi yang didukung oleh metode pelaporan inti seperti runReport dan batchRunReports. Lihat Dimensi Real-Time untuk mengetahui daftar nama dimensi yang didukung oleh metode runRealtimeReport. Lihat Dimensi Funnel untuk mengetahui daftar nama dimensi yang didukung oleh metode runFunnelReport.

Jika dimensionExpression ditentukan, name dapat berupa string apa pun yang Anda inginkan dalam himpunan karakter yang diizinkan. Misalnya jika dimensionExpression menggabungkan country dan city, Anda dapat memanggil dimensi tersebut countryAndCity. Nama dimensi yang Anda pilih harus cocok dengan ekspresi reguler ^[a-zA-Z0-9_]$.

Dimensi dirujuk oleh name dalam dimensionFilter, orderBys, dimensionExpression, dan pivots.

dimensionExpression

object (DimensionExpression)

Satu dimensi dapat menjadi hasil dari ekspresi beberapa dimensi. Misalnya, dimensi "country, city": concatenate(country, ", ", city).

DimensionExpression

Digunakan untuk menyatakan dimensi yang merupakan hasil rumus beberapa dimensi. Contoh penggunaan: 1) lowerCase(dimensi) 2) concatenate(dimension1, simbol, dimension2).

Representasi JSON
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Kolom
Kolom union one_expression. Tentukan satu jenis ekspresi dimensi untuk DimensionExpression. one_expression hanya dapat berupa salah satu dari yang berikut:
lowerCase

object (CaseExpression)

Digunakan untuk mengonversi nilai dimensi ke huruf kecil.

upperCase

object (CaseExpression)

Digunakan untuk mengonversi nilai dimensi ke huruf besar.

concatenate

object (ConcatenateExpression)

Digunakan untuk menggabungkan nilai dimensi ke satu dimensi. Misalnya, dimensi "country, city": concatenate(country, ", ", city).

CaseExpression

Digunakan untuk mengonversi nilai dimensi menjadi satu kasus.

Representasi JSON
{
  "dimensionName": string
}
Kolom
dimensionName

string

Nama dimensi. Nama tersebut harus merujuk kembali ke nama di kolom dimensi permintaan.

ConcatenateExpression

Digunakan untuk menggabungkan nilai dimensi ke satu dimensi.

Representasi JSON
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Kolom
dimensionNames[]

string

Nama dimensi. Nama tersebut harus merujuk kembali ke nama di kolom dimensi permintaan.

delimiter

string

Pemisah yang ditempatkan di antara nama dimensi.

Pemisah sering kali berupa karakter tunggal seperti "|" atau "," tapi bisa juga berupa string yang lebih panjang. Jika nilai dimensi berisi pembatas, keduanya akan ada sebagai respons tanpa perbedaan. Misalnya, jika nilai dimensi 1 = "US,FR", nilai dimensi 2 = "JP", dan pembatas = ",", responsnya akan berisi "US,FR,JP".