- Referensi: ReportTask
- ReportDefinition
- Dimensi
- DimensionExpression
- CaseExpression
- ConcatenateExpression
- Metrik
- DateRange
- FilterExpression
- FilterExpressionList
- Filter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- Operasi
- NumericValue
- BetweenFilter
- MetricAggregation
- OrderBy
- MetricOrderBy
- DimensionOrderBy
- OrderType
- CohortSpec
- Kohor
- CohortsRange
- Perincian
- CohortReportSettings
- SamplingLevel
- ReportMetadata
- Status
- Metode
Resource: ReportTask
Konfigurasi tugas laporan tertentu.
Representasi JSON |
---|
{ "name": string, "reportDefinition": { object ( |
Kolom | |
---|---|
name |
Hanya output. ID. Nama resource tugas laporan yang ditetapkan selama pembuatan. Format: "properties/{property}/reportTasks/{reportTask}" |
report |
Opsional. Definisi laporan untuk mengambil data laporan, yang menjelaskan struktur laporan. Biasanya, laporan ini menyertakan kolom yang akan disertakan dalam laporan dan kriteria yang akan digunakan untuk memfilter data. |
report |
Hanya output. Metadata laporan untuk tugas laporan tertentu, yang memberikan informasi tentang laporan. Biasanya, informasi ini mencakup informasi berikut: nama resource laporan, status laporan, stempel waktu laporan dibuat, dll. |
ReportDefinition
Definisi cara menjalankan laporan.
Representasi JSON |
---|
{ "dimensions": [ { object ( |
Kolom | |
---|---|
dimensions[] |
Opsional. Dimensi yang diminta dan ditampilkan. |
metrics[] |
Opsional. Metrik yang diminta dan ditampilkan. |
date |
Opsional. Rentang tanggal data yang akan dibaca. Jika beberapa rentang tanggal diminta, setiap baris respons akan berisi indeks rentang tanggal berbasis nol. Jika dua rentang tanggal tumpang-tindih, data peristiwa untuk hari yang tumpang-tindih akan disertakan dalam baris respons untuk kedua rentang tanggal tersebut. Dalam permintaan kelompok, |
dimension |
Opsional. Filter dimensi memungkinkan Anda hanya meminta nilai dimensi tertentu dalam laporan. Untuk mempelajari lebih lanjut, lihat Dasar-Dasar Filter Dimensi untuk mengetahui contohnya. Metrik tidak dapat digunakan dalam filter ini. |
metric |
Opsional. Klausa filter metrik. Diterapkan setelah menggabungkan baris laporan, mirip dengan klausa having SQL. Dimensi tidak dapat digunakan dalam filter ini. |
offset |
Opsional. Jumlah baris dari baris awal dari Penyimpanan Google Analytics. Baris pertama dihitung sebagai baris 0. Saat membuat tugas laporan, parameter |
limit |
Opsional. Jumlah baris yang akan ditampilkan dalam Laporan. Jika tidak ditentukan, total 10.000 baris akan ditampilkan. API ini menampilkan maksimum 250.000 baris per permintaan, berapa pun jumlah yang Anda minta. API juga dapat menampilkan lebih sedikit baris daripada |
metric |
Opsional. Agregasi metrik. Nilai metrik gabungan akan ditampilkan di baris dengan dimensionValues ditetapkan ke "RESERVED_(MetricAggregation)". |
order |
Opsional. Menentukan cara baris diurutkan dalam respons. |
currency |
Opsional. Kode mata uang dalam format ISO4217, seperti "AED", "USD", "JPY". Jika kolom kosong, laporan akan menggunakan mata uang default properti. |
cohort |
Opsional. Grup kohor yang terkait dengan permintaan ini. Jika ada grup kelompok dalam permintaan, dimensi 'kelompok' harus ada. |
keep |
Opsional. Jika salah atau tidak ditentukan, setiap baris dengan semua metrik sama dengan 0 tidak akan ditampilkan. Jika true (benar), baris ini akan ditampilkan jika tidak dihapus secara terpisah oleh filter. Terlepas dari setelan Misalnya, jika properti tidak pernah mencatat peristiwa |
sampling |
Opsional. Tingkat pengambilan sampel laporan. |
Dimensi
Dimensi merupakan atribut 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".
Representasi JSON |
---|
{
"name": string,
"dimensionExpression": {
object ( |
Kolom | |
---|---|
name |
Nama dimensi. Lihat Dimensi API untuk mengetahui daftar nama dimensi yang didukung oleh metode pelaporan inti seperti Jika Dimensi dirujuk oleh |
dimension |
Satu dimensi dapat berupa 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) lowerCase(dimension) 2) concatenate(dimension1, symbol, dimension2).
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union one_expression . Tentukan satu jenis ekspresi dimensi untuk DimensionExpression . one_expression hanya dapat berupa salah satu dari hal berikut: |
|
lower |
Digunakan untuk mengonversi nilai dimensi menjadi huruf kecil. |
upper |
Digunakan untuk mengonversi nilai dimensi menjadi huruf besar. |
concatenate |
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 | |
---|---|
dimension |
Nama dimensi. Nama 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 | |
---|---|
dimension |
Nama dimensi. Nama harus merujuk kembali ke nama di kolom dimensi permintaan. |
delimiter |
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". |
Metrik
Pengukuran kuantitatif laporan. Misalnya, metrik eventCount
adalah jumlah total peristiwa. Permintaan diizinkan hingga 10 metrik.
Representasi JSON |
---|
{ "name": string, "expression": string, "invisible": boolean } |
Kolom | |
---|---|
name |
Nama metrik. Lihat Metrik API untuk mengetahui daftar nama metrik yang didukung oleh metode pelaporan inti seperti Jika Metrik direferensikan oleh |
expression |
Ekspresi matematika untuk metrik turunan. Misalnya, jumlah Peristiwa metrik per pengguna adalah |
invisible |
Menunjukkan apakah metrik tidak terlihat dalam respons laporan. Jika tidak terlihat, metrik tidak akan menghasilkan kolom dalam respons, tetapi dapat digunakan di |
DateRange
Kumpulan hari yang berurutan: startDate
, startDate + 1
, ..., endDate
. Permintaan diizinkan hingga 4 rentang tanggal.
Representasi JSON |
---|
{ "startDate": string, "endDate": string, "name": string } |
Kolom | |
---|---|
start |
Tanggal mulai inklusif untuk kueri dalam format |
end |
Tanggal akhir inklusif untuk kueri dalam format |
name |
Menetapkan nama untuk rentang tanggal ini. Dimensi |
FilterExpression
Untuk menyatakan filter dimensi atau metrik. Kolom dalam FilterExpression yang sama harus berupa semua dimensi atau semua metrik.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union expr . Tentukan satu jenis ekspresi filter untuk FilterExpression . expr hanya dapat berupa salah satu dari yang berikut: |
|
and |
FilterExpressions di andGroup memiliki hubungan DAN. |
or |
FilterExpressions di orGroup memiliki hubungan ATAU. |
not |
FilterExpression BUKAN dari notExpression. |
filter |
Filter primitif. Dalam FilterExpression yang sama, semua nama kolom filter harus berupa semua dimensi atau semua metrik. |
FilterExpressionList
Daftar ekspresi filter.
Representasi JSON |
---|
{
"expressions": [
{
object ( |
Kolom | |
---|---|
expressions[] |
Daftar ekspresi filter. |
Filter
Ekspresi untuk memfilter nilai dimensi atau metrik.
Representasi JSON |
---|
{ "fieldName": string, // Union field |
Kolom | |
---|---|
field |
Nama dimensi atau nama metrik. Harus berupa nama yang ditentukan dalam dimensi atau metrik. |
Kolom union one_filter . Tentukan satu jenis filter untuk Filter . one_filter hanya dapat berupa salah satu dari hal berikut: |
|
string |
Filter terkait string. |
in |
Filter untuk nilai dalam daftar. |
numeric |
Filter untuk nilai numerik atau tanggal. |
between |
Filter untuk antara dua nilai. |
StringFilter
Filter untuk string
Representasi JSON |
---|
{
"matchType": enum ( |
Kolom | |
---|---|
match |
Jenis pencocokan untuk filter ini. |
value |
Nilai string yang digunakan untuk pencocokan. |
case |
Jika true (benar), nilai string peka huruf besar/kecil. |
MatchType
Jenis pencocokan filter string
Enum | |
---|---|
MATCH_TYPE_UNSPECIFIED |
Tidak ditentukan |
EXACT |
Pencocokan persis dari nilai string. |
BEGINS_WITH |
Dimulai dengan nilai string. |
ENDS_WITH |
Diakhiri dengan nilai string. |
CONTAINS |
Berisi nilai string. |
FULL_REGEXP |
Pencocokan penuh untuk ekspresi reguler dengan nilai string. |
PARTIAL_REGEXP |
Kecocokan sebagian untuk ekspresi reguler dengan nilai string. |
InListFilter
Hasilnya harus berupa daftar nilai string.
Representasi JSON |
---|
{ "values": [ string ], "caseSensitive": boolean } |
Kolom | |
---|---|
values[] |
Daftar nilai string. Tidak boleh kosong. |
case |
Jika true (benar), nilai string peka huruf besar/kecil. |
NumericFilter
Filter untuk nilai numerik atau tanggal.
Representasi JSON |
---|
{ "operation": enum ( |
Kolom | |
---|---|
operation |
Jenis operasi untuk filter ini. |
value |
Nilai numerik atau nilai tanggal. |
Operasi
Operasi yang diterapkan pada filter numerik
Enum | |
---|---|
OPERATION_UNSPECIFIED |
Tidak ditentukan. |
EQUAL |
Sama dengan |
LESS_THAN |
Kurang dari |
LESS_THAN_OR_EQUAL |
Kurang dari atau sama dengan |
GREATER_THAN |
Lebih dari |
GREATER_THAN_OR_EQUAL |
Lebih dari atau sama dengan |
NumericValue
Untuk mewakili angka.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union one_value . Salah satu nilai numerik one_value hanya dapat berupa salah satu dari hal berikut: |
|
int64 |
Nilai bilangan bulat |
double |
Nilai ganda |
BetweenFilter
Untuk menyatakan bahwa hasilnya harus antara dua angka (inklusif).
Representasi JSON |
---|
{ "fromValue": { object ( |
Kolom | |
---|---|
from |
Dimulai dengan angka ini. |
to |
Diakhiri dengan angka ini. |
MetricAggregation
Merepresentasikan agregasi metrik.
Enum | |
---|---|
METRIC_AGGREGATION_UNSPECIFIED |
Operator tidak ditentukan. |
TOTAL |
Operator SUM. |
MINIMUM |
Operator minimum. |
MAXIMUM |
Operator maksimum. |
COUNT |
Operator jumlah. |
OrderBy
Urutan menurut menentukan cara baris akan diurutkan dalam respons. Misalnya, mengurutkan baris berdasarkan jumlah peristiwa menurun adalah satu pengurutan, dan mengurutkan baris berdasarkan string nama peristiwa adalah pengurutan yang berbeda.
Representasi JSON |
---|
{ "desc": boolean, // Union field |
Kolom | |
---|---|
desc |
Jika benar, urutkan dari atas ke bawah. |
Kolom union one_order_by . Tentukan satu jenis urutan menurut untuk OrderBy . one_order_by hanya dapat berupa salah satu dari hal berikut: |
|
metric |
Mengurutkan hasil menurut nilai metrik. |
dimension |
Mengurutkan hasil menurut nilai dimensi. |
MetricOrderBy
Mengurutkan menurut nilai metrik.
Representasi JSON |
---|
{ "metricName": string } |
Kolom | |
---|---|
metric |
Nama metrik dalam permintaan untuk diurutkan. |
DimensionOrderBy
Mengurutkan menurut nilai dimensi.
Representasi JSON |
---|
{
"dimensionName": string,
"orderType": enum ( |
Kolom | |
---|---|
dimension |
Nama dimensi dalam permintaan untuk diurutkan. |
order |
Mengontrol aturan untuk pengurutan nilai dimensi. |
OrderType
Aturan untuk mengurutkan nilai dimensi string.
Enum | |
---|---|
ORDER_TYPE_UNSPECIFIED |
Tidak ditentukan. |
ALPHANUMERIC |
Pengurutan alfanumerik berdasarkan titik kode Unicode. Misalnya, "2" < "A" < "X" < "b" < "z". |
CASE_INSENSITIVE_ALPHANUMERIC |
Pengurutan alfanumerik yang tidak peka huruf besar/kecil menurut poin kode Unicode huruf kecil. Misalnya, "2" < "A" < "b" < "X" < "z". |
NUMERIC |
Nilai dimensi dikonversi menjadi angka sebelum pengurutan. Misalnya, dalam pengurutan NUMERIC, "25" < "100", dan dalam pengurutan ALPHANUMERIC , "100" < "25". Semua nilai dimensi non-numerik memiliki nilai pengurutan yang sama di bawah semua nilai numerik. |
CohortSpec
Spesifikasi kelompok untuk laporan kelompok.
Laporan kelompok membuat deret waktu retensi pengguna untuk kelompok. Misalnya, Anda dapat memilih kelompok pengguna yang diperoleh pada minggu pertama bulan September dan mengikuti kelompok tersebut selama enam minggu ke depan. Memilih pengguna yang diperoleh dalam kelompok minggu pertama September ditentukan dalam objek cohort
. Mengikuti kohor tersebut selama enam minggu ke depan ditentukan dalam objek cohortsRange
.
Untuk contoh, lihat Contoh Laporan Kelompok.
Respons laporan dapat menunjukkan deret waktu mingguan, di mana aplikasi Anda telah mempertahankan 60% dari kelompok ini setelah tiga minggu dan 25% dari kelompok ini setelah enam minggu. Kedua persentase ini dapat dihitung dengan metrik cohortActiveUsers/cohortTotalUsers
dan akan menjadi baris terpisah dalam laporan.
Representasi JSON |
---|
{ "cohorts": [ { object ( |
Kolom | |
---|---|
cohorts[] |
Menentukan kriteria pemilihan untuk mengelompokkan pengguna ke dalam kelompok. Sebagian besar laporan kelompok hanya menentukan satu kelompok. Jika beberapa kelompok ditentukan, setiap kelompok dapat dikenali dalam laporan berdasarkan namanya. |
cohorts |
Laporan kelompok mengikuti kelompok selama rentang tanggal pelaporan yang diperpanjang. Rentang ini menentukan durasi offset untuk mengikuti kohor. |
cohort |
Setelan opsional untuk laporan kelompok. |
Kelompok
Menentukan kriteria pemilihan kelompok. Kelompok adalah sekelompok pengguna yang memiliki karakteristik yang sama. Misalnya, pengguna dengan firstSessionDate
yang sama termasuk dalam kelompok yang sama.
Representasi JSON |
---|
{
"name": string,
"dimension": string,
"dateRange": {
object ( |
Kolom | |
---|---|
name |
Menetapkan nama ke kelompok ini. Dimensi |
dimension |
Dimensi yang digunakan oleh kelompok. Wajib dan hanya mendukung |
date |
Kohor memilih pengguna yang tanggal kontak pertamanya berada di antara tanggal mulai dan tanggal akhir yang ditentukan dalam Dalam permintaan kelompok,
|
CohortsRange
Mengonfigurasi rentang tanggal pelaporan yang diperpanjang untuk laporan kelompok. Menentukan durasi offset untuk mengikuti kohor.
Representasi JSON |
---|
{
"granularity": enum ( |
Kolom | |
---|---|
granularity |
Wajib. Tingkat perincian yang digunakan untuk menafsirkan |
start |
Jika Jika Jika |
end |
Wajib. Jika Jika Jika |
Perincian
Perincian yang digunakan untuk menafsirkan startOffset
dan endOffset
untuk rentang tanggal pelaporan yang diperluas untuk laporan kelompok.
Enum | |
---|---|
GRANULARITY_UNSPECIFIED |
Tidak boleh ditentukan. |
DAILY |
Perincian harian. Umumnya digunakan jika dateRange kelompok adalah satu hari dan permintaan berisi cohortNthDay . |
WEEKLY |
Perincian mingguan. Biasanya digunakan jika dateRange kelompok memiliki durasi satu minggu (dimulai pada hari Minggu dan berakhir pada hari Sabtu) dan permintaan berisi cohortNthWeek . |
MONTHLY |
Perincian bulanan. Biasanya digunakan jika dateRange kelompok memiliki durasi satu bulan dan permintaan berisi cohortNthMonth . |
CohortReportSettings
Setelan opsional laporan kelompok.
Representasi JSON |
---|
{ "accumulate": boolean } |
Kolom | |
---|---|
accumulate |
Jika benar, akan mengakumulasi hasil dari hari kontak pertama hingga hari akhir. Tidak didukung dalam bahasa |
SamplingLevel
Kategori tingkat sampling untuk permintaan.
Enum | |
---|---|
SAMPLING_LEVEL_UNSPECIFIED |
Jenis tidak ditentukan. |
LOW |
Menerapkan tingkat sampling 10 juta ke properti standar dan 100 juta ke properti Google Analytics 360. |
MEDIUM |
Eksklusif untuk properti Google Analytics 360 dengan tingkat sampling 1 miliar. |
UNSAMPLED |
Eksklusif untuk properti Google Analytics 360. Eksplorasi tanpa sampel lebih akurat dan dapat mengungkapkan insight yang tidak terlihat dalam eksplorasi standar. Untuk mempelajari lebih lanjut, lihat https://support.google.com/analytics/answer/10896953. |
ReportMetadata
Metadata laporan untuk tugas laporan tertentu.
Representasi JSON |
---|
{
"creationQuotaTokensCharged": integer,
"state": enum ( |
Kolom | |
---|---|
creation |
Hanya output. Total token kuota yang ditagih selama pembuatan laporan. Karena jumlah token ini didasarkan pada aktivitas dari status |
state |
Hanya output. Status saat ini untuk tugas laporan ini. |
begin |
Hanya output. Waktu saat Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit pecahan. Contoh: |
task |
Hanya output. Jumlah total baris dalam hasil laporan. Kolom ini akan diisi saat status aktif. Anda dapat menggunakan |
error |
Hanya output. Pesan error akan terisi jika tugas laporan gagal selama pembuatan. |
total |
Hanya output. Jumlah total baris dalam penyimpanan Google Analytics. Jika Anda ingin membuat kueri baris data tambahan di luar laporan saat ini, baris tersebut dapat memulai tugas laporan baru berdasarkan
Misalnya, |
Negara Bagian
Status pemrosesan.
Enum | |
---|---|
STATE_UNSPECIFIED |
Status yang tidak ditentukan tidak akan pernah digunakan. |
CREATING |
Laporan sedang dibuat dan akan tersedia di masa mendatang. Pembuatan terjadi segera setelah panggilan CreateReport. |
ACTIVE |
Laporan telah dibuat sepenuhnya dan siap untuk dikueri. |
FAILED |
Laporan gagal dibuat. |
Metode |
|
---|---|
|
Memulai pembuatan tugas laporan. |
|
Mendapatkan metadata laporan tentang tugas laporan tertentu. |
|
Mencantumkan semua tugas laporan untuk properti. |
|
Mengambil konten tugas laporan. |