Dimension

Dimensi merupakan atribut data Anda. Misalnya, dimensi kota menunjukkan kota asal peristiwa. 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 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 kumpulan 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 di dimensionFilter, orderBys, dimensionExpression, dan pivots.

dimensionExpression

object (DimensionExpression)

Satu dimensi dapat berupa hasil dari ekspresi beberapa dimensi. Misalnya, dimensi "negara, kota": concatenate(negara, ", ", kota).

DimensionExpression

Digunakan untuk menyatakan dimensi yang merupakan hasil dari formula beberapa dimensi. Contoh penggunaan: 1) lowerCase(dimension) 2) concatenate(dimension1, symbol, 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 hal 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 ke dalam satu dimensi. Misalnya, dimensi "negara, kota": concatenate(negara, ", ", kota).

CaseExpression

Digunakan untuk mengonversi nilai dimensi menjadi satu kasus.

Representasi JSON
{
  "dimensionName": string
}
Kolom
dimensionName

string

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

ConcatenateExpression

Digunakan untuk menggabungkan nilai dimensi ke dalam satu dimensi.

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

string

Nama dimensi. Nama 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 ",", tetapi dapat berupa string yang lebih panjang. Jika nilai dimensi berisi pemisah, keduanya akan ada dalam respons tanpa perbedaan. Misalnya, jika nilai dimensi 1 = "US,FR", nilai dimensi 2 = "JP", dan pemisah = ",", respons akan berisi "US,FR,JP".