Dimension

Dimensi merupakan atribusi data Anda. Misalnya, kota dimensi 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 bisa 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 merupakan hasil dari ekspresi dari beberapa dimensi. Misalnya, dimensi "country, city": concatenate(country, ", ", city).

{i>DimensionExpression<i}

Digunakan untuk menyatakan dimensi yang merupakan hasil dari formula beberapa dimensi. Contoh penggunaan: 1) bottomCase(Dimension) 2) concatenate(dimension1, simbol, dimensions2).

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 berikut:
lowerCase

object (CaseExpression)

Digunakan untuk mengonversi nilai dimensi ke huruf kecil.

upperCase

object (CaseExpression)

Digunakan untuk mengonversi nilai dimensi menjadi huruf besar.

concatenate

object (ConcatenateExpression)

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

Ekspresi Kasus

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 dalam permintaan.

Ekspresi Gabungan

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.

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