Dimension

Dimensi merupakan atribut data Anda. Misalnya, dimensi kota menunjukkan kota tempat peristiwa berasal. Nilai dimensi dalam respons laporan adalah string; misalnya, kota dapat 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 Realtime untuk mengetahui daftar nama dimensi yang didukung oleh metode runRealtimeReport. Lihat Dimensi Funnel untuk 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 menyambungkan country dan city, Anda dapat memanggil dimensi tersebut countryAndCity. Nama dimensi yang Anda pilih harus cocok dengan ekspresi reguler ^[a-zA-Z0-9_]$.

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

dimensionExpression

object (DimensionExpression)

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

DimensionExpression

Digunakan untuk menyatakan dimensi yang merupakan hasil dari formula beberapa dimensi. Contoh penggunaan: 1) {i>lowerCase<i} (dimensi) 2) {i>concatenate<i} (dimensi1, simbol, dimensi2).

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 menjadi huruf kecil.

upperCase

object (CaseExpression)

Digunakan untuk mengonversi nilai dimensi menjadi huruf besar.

concatenate

object (ConcatenateExpression)

Digunakan untuk menggabungkan nilai dimensi menjadi 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 menjadi 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 ditempatkan di antara nama dimensi.

Pembatas sering kali berupa karakter tunggal seperti "|" atau "," tetapi bisa berupa string yang lebih panjang. Jika nilai dimensi berisi pemisah, keduanya akan ditampilkan dalam respons tanpa perbedaan. Misalnya, jika nilai dimensi 1 = "US,FR", nilai dimensi 2 = "JP", dan pembatas = ",", responsnya akan berisi "US,FR,JP".