- Permintaan HTTP
- Isi permintaan
- Isi respons
- Cakupan Otorisasi
- Pengguna
- UserIdType
- JenisAktivitas
- UserActivitySession
- Aktivitas
- Dimensi Kustom
- Kunjungan Halaman
- ScreenviewData
- E-commerceData
- E-Commerce
- TransactionData
- DataProduk
- Jenis E-commerce
- SasaranSetData
- SasaranData
- DataPeristiwa
- Cobalah
Menampilkan data Aktivitas Pengguna.
Permintaan HTTP
POST https://analyticsreporting.googleapis.com/v4/userActivity:search
URL menggunakan sintaksis gRPC Transcoding.
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON | |
---|---|
{ "dateRange": { object( |
Kolom | |
---|---|
dateRange |
Rentang tanggal untuk mengambil aktivitas pengguna. Jika rentang tanggal tidak ditentukan, rentang tanggal default adalah (startDate: tanggal saat ini - 7 hari, endDate: tanggal saat ini - 1 hari). |
viewId |
Wajib diisi. ID tampilan Analytics untuk mengambil data. Setiap SearchUserActivityRequest harus berisi |
user |
Wajib diisi. ID pengguna unik untuk kueri. Setiap SearchUserActivityRequest harus berisi kolom ini. |
activityTypes[] |
Kumpulan semua jenis aktivitas yang diminta. Hanya aktivitas yang cocok dengan jenis ini yang akan ditampilkan dalam respons. Jika kosong, semua aktivitas akan ditampilkan. |
pageSize |
Ukuran halaman adalah untuk paging dan menentukan jumlah maksimum baris yang ditampilkan. Ukuran halaman harus > 0. Jika nilainya 0 atau jika kolom tidak ditentukan, permintaan akan menampilkan default 1.000 baris per halaman. |
pageToken |
Token lanjutan untuk mendapatkan halaman hasil berikutnya. Menambahkan ini ke permintaan akan menampilkan baris setelah pageToken. pageToken harus berupa nilai yang ditampilkan di parameter nextPageToken sebagai respons terhadap permintaan SearchUserActivityRequest. |
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Respons dari panggilan userActivity:get
.
Representasi JSON | |
---|---|
{
"sessions": [
{
object( |
Kolom | |
---|---|
sessions[] |
Setiap catatan mewakili sesi (detail perangkat, durasi, dll.). |
totalRows |
Total baris yang ditampilkan oleh kueri ini (di berbagai halaman). |
nextPageToken |
Token ini harus diteruskan ke SearchUserActivityRequest untuk mengambil halaman berikutnya. |
sampleRate |
Kolom ini menunjukkan rasio pengambilan sampel untuk permintaan tertentu dan berupa angka antara 0,0 hingga 1,0. Lihat panduan developer untuk mengetahui detailnya. |
Cakupan Otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
Pengguna
Berisi informasi untuk mengidentifikasi pengguna tertentu secara unik.
Representasi JSON | |
---|---|
{
"type": enum( |
Kolom | |
---|---|
type |
Jenis pengguna dalam permintaan. Kolom |
userId |
ID unik pengguna yang datanya diminta. |
IdPenggunaJenis
Mewakili berbagai jenis identifikasi pengguna yang tersedia.
Enumerasi | |
---|---|
USER_ID_TYPE_UNSPECIFIED |
Jika Jenis ID Pengguna tidak ditentukan, jenis default yang digunakan adalah CLIENT_ID. |
USER_ID |
Pengguna tunggal, seperti akun pengguna yang login, yang mungkin berinteraksi dengan konten di 1 atau beberapa perangkat dan/atau instance browser. |
CLIENT_ID |
Analytics menetapkan clientId. |
JenisAktivitas
Enumerasi | |
---|---|
ACTIVITY_TYPE_UNSPECIFIED |
ActivityType tidak akan pernah memiliki nilai ini dalam respons. Menggunakan jenis ini dalam permintaan akan menghasilkan error. |
PAGEVIEW |
Digunakan saat aktivitas berasal dari pengunjung yang melihat halaman. |
SCREENVIEW |
Digunakan saat aktivitas berasal dari pengunjung yang menggunakan aplikasi di perangkat seluler. |
GOAL |
Digunakan untuk menunjukkan bahwa aktivitas jenis sasaran. |
ECOMMERCE |
Transaksi e-commerce dilakukan oleh pengunjung pada halaman. |
EVENT |
Digunakan saat aktivitas berupa peristiwa. |
SesiAktivitasPengguna
Ini mewakili sesi pengguna yang dilakukan pada perangkat tertentu pada waktu tertentu selama jangka waktu tertentu.
Representasi JSON | |
---|---|
{
"sessionId": string,
"deviceCategory": string,
"platform": string,
"dataSource": string,
"activities": [
{
object( |
Kolom | |
---|---|
sessionId |
ID unik sesi. |
deviceCategory |
Jenis perangkat yang digunakan: "seluler", "tablet" dll. |
platform |
Platform tempat aktivitas terjadi: "android", "ios" dll. |
dataSource |
Sumber data sebuah klik. Secara default, klik yang dikirim dari analytics.js dilaporkan sebagai "web" dan klik yang dikirim dari SDK seluler dilaporkan sebagai "app". Nilai ini dapat diganti di Measurement Protocol. |
activities[] |
Menyatakan tampilan detail tentang setiap aktivitas dalam sesi ini. |
sessionDate |
Tanggal sesi ini dalam format ISO-8601. |
Aktivitas
Aktivitas merepresentasikan data untuk aktivitas pengguna. Perhatikan bahwa Aktivitas berbeda dari hit. Hit dapat mengakibatkan beberapa Aktivitas. Misalnya, jika klik mencakup transaksi dan sasaran tercapai, akan ada dua proto Aktivitas untuk klik ini, satu untuk ECOMMERCE dan satu untuk GOAL. Sebaliknya, beberapa hit juga dapat membuat satu Aktivitas. Dalam e-commerce klasik, data untuk satu transaksi mungkin dikirim melalui beberapa hit. Klik ini akan digabungkan ke satu Aktivitas ECOMMERCE.
Representasi JSON | |
---|---|
{ "activityTime": string, "source": string, "medium": string, "channelGrouping": string, "campaign": string, "keyword": string, "hostname": string, "landingPagePath": string, "activityType": enum( |
Kolom | ||
---|---|---|
activityTime |
Stempel waktu aktivitas. Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: |
|
source |
Sumber rujukan. Untuk pelacakan kampanye manual, ini adalah nilai parameter pelacakan kampanye utm_source. Untuk pemberian tag otomatis AdWords, atribut ini adalah Google. Jika Anda tidak menggunakan keduanya, domain tersebut adalah domain sumber (misalnya, document.referrer) yang merujuk pengguna. File ini mungkin juga berisi alamat port. Jika pengguna datang tanpa perujuk, nilainya adalah (direct). |
|
medium |
Jenis rujukan. Untuk pelacakan kampanye manual, ini adalah nilai parameter pelacakan kampanye utm_medium. Untuk pemberian tag otomatis AdWords, formatnya adalah cpc. Jika pengguna berasal dari mesin telusur yang terdeteksi oleh Google Analytics, ini adalah organik. Jika perujuk bukan mesin telusur, perujuknya adalah rujukan. Jika pengguna datang langsung ke properti dan document.referrer kosong, nilainya adalah (none). |
|
channelGrouping |
Grup Saluran yang dikaitkan dengan sesi pengguna akhir untuk Tampilan ini (ditentukan oleh Pengelompokan Saluran Tampilan). |
|
campaign |
Untuk pelacakan kampanye manual, ini adalah nilai parameter pelacakan kampanye utm_campaign. Untuk pemberian tag otomatis AdWords, nama kampanye iklan online adalah yang Anda gunakan untuk properti. Jika Anda tidak menggunakan keduanya, nilainya tidak (belum ditetapkan). |
|
keyword |
Untuk pelacakan kampanye manual, ini adalah nilai parameter pelacakan kampanye utm_term. Untuk traffic AdWords, kolom ini berisi kriteria penargetan yang paling cocok. Untuk jaringan display, tempat beberapa kriteria penargetan dapat menyebabkan iklan tampil, jaringan tersebut menampilkan kriteria penargetan yang paling cocok seperti yang dipilih oleh Iklan. Ini dapat berupa display_keyword, penempatan situs, boomuserlist, user_interest, usia, atau gender. Jika tidak, nilainya adalah (belum ditetapkan). |
|
hostname |
Nama host tempat permintaan pelacakan dibuat. |
|
landingPagePath |
Halaman pertama di pengguna' sesi, atau halaman landing. |
|
activityType |
Jenis aktivitas ini. |
|
customDimension[] |
Daftar semua dimensi kustom yang terkait dengan aktivitas ini. |
|
Kolom union activity_details . Bergantung pada activity_type , salah satu kolom berikut akan ditetapkan. activity_details hanya dapat berupa salah satu dari berikut: |
||
pageview |
Ini akan ditetapkan jika |
|
appview |
Ini akan ditetapkan jika |
|
ecommerce |
Ini akan ditetapkan jika |
|
goals |
Kolom ini berisi daftar semua sasaran yang dicapai dalam aktivitas ini jika |
|
event |
Kolom ini berisi semua detail yang terkait dengan suatu peristiwa dan akan ditetapkan jika |
Dimensi Kustom
Dimensi kustom.
Representasi JSON | |
---|---|
{ "index": number, "value": string } |
Kolom | |
---|---|
index |
Nomor slot dimensi kustom. |
value |
Nilai dimensi kustom. Nilai default (yaitu string kosong) menunjukkan penghapusan nilai dimensi kustom sesi/pengunjung. |
DataKunjungan Halaman
Mewakili detail yang dikumpulkan saat pengunjung melihat halaman.
Representasi JSON | |
---|---|
{ "pagePath": string, "pageTitle": string } |
Kolom | |
---|---|
pagePath |
URL halaman yang dilihat oleh pengunjung. |
pageTitle |
Judul halaman yang dilihat pengunjung. |
DataTampilanLayar
Representasi JSON | |
---|---|
{ "screenName": string, "mobileDeviceBranding": string, "mobileDeviceModel": string, "appName": string } |
Kolom | |
---|---|
screenName |
Nama layar. |
mobileDeviceBranding |
Produsen seluler atau nama bermerek. Mis.: "Google", "Apple" dll. |
mobileDeviceModel |
Model perangkat seluler. Mis.: "Pixel", "iPhone" dll. |
appName |
Nama aplikasi. |
Data E-commerce
Detail e-commerce yang terkait dengan aktivitas pengguna.
Representasi JSON | |
---|---|
{ "actionType": enum( |
Kolom | |
---|---|
actionType |
Tindakan yang terkait dengan tindakan e-commerce ini. |
transaction |
Detail transaksi dari tindakan e-commerce ini. |
products[] |
Detail produk dalam transaksi ini. |
ecommerceType |
Jenis aktivitas e-commerce ini. |
E-commerce
Kumpulan semua tindakan yang terkait dengan tindakan e-commerce.
Enumerasi | |
---|---|
UNKNOWN |
Jenis tindakan tidak diketahui. |
CLICK |
Klik-tayang daftar produk. |
DETAILS_VIEW |
Tampilan detail produk. |
ADD_TO_CART |
Tambahkan produk ke keranjang. |
REMOVE_FROM_CART |
Hapus produk dari keranjang. |
CHECKOUT |
Check out. |
PAYMENT |
Pembelian selesai. |
REFUND |
Pengembalian dana pembelian. |
CHECKOUT_OPTION |
Opsi checkout. |
DataTransaksi
Mewakili detail yang dikumpulkan saat pengunjung melakukan transaksi di halaman.
Representasi JSON | |
---|---|
{ "transactionId": string, "transactionRevenue": number, "transactionTax": number, "transactionShipping": number } |
Kolom | |
---|---|
transactionId |
ID transaksi, yang diberikan oleh metode pelacakan e-commerce, untuk pembelian di keranjang belanja. |
transactionRevenue |
Total pendapatan penjualan (tidak termasuk pengiriman dan pajak) transaksi. |
transactionTax |
Total pajak untuk transaksi. |
transactionShipping |
Biaya pengiriman total. |
DataProduk
Detail produk dalam transaksi e-commerce.
Representasi JSON | |
---|---|
{ "productSku": string, "productName": string, "itemRevenue": number, "productQuantity": string } |
Kolom | |
---|---|
productSku |
Kode unik yang mewakili produk. |
productName |
Nama produk, yang diberikan oleh aplikasi pelacakan e-commerce, untuk item yang dibeli. |
itemRevenue |
Total pendapatan dari item produk yang dibeli. |
productQuantity |
Jumlah total unit produk ini dalam transaksi. |
Jenis E-commerce
Ini menunjukkan jenis data e-commerce yang ditampilkan.
Enumerasi | |
---|---|
ECOMMERCE_TYPE_UNSPECIFIED |
Digunakan saat jenis aktivitas e-commerce tidak ditentukan. |
CLASSIC |
Digunakan saat aktivitas memiliki informasi e-commerce klasik (yang tidak disempurnakan). |
ENHANCED |
Digunakan saat aktivitas telah meningkatkan informasi e-commerce. |
SasaranSetData
Menyatakan kumpulan sasaran yang telah dicapai dalam suatu aktivitas.
Representasi JSON | |
---|---|
{
"goals": [
{
object( |
Kolom | |
---|---|
goals[] |
Semua sasaran yang dicapai dalam aktivitas saat ini. |
DataSasaran
Mewakili semua detail yang terkait dengan sasaran.
Representasi JSON | |
---|---|
{ "goalIndex": number, "goalCompletions": string, "goalValue": number, "goalCompletionLocation": string, "goalPreviousStep1": string, "goalPreviousStep2": string, "goalPreviousStep3": string, "goalName": string } |
Kolom | |
---|---|
goalIndex |
Atribut ini mengidentifikasi sasaran seperti yang dikonfigurasi untuk profil. |
goalCompletions |
Jumlah total sasaran tercapai dalam aktivitas ini. |
goalValue |
Nilai di sasaran ini. |
goalCompletionLocation |
URL halaman tempat sasaran ini diselesaikan. |
goalPreviousStep1 |
URL halaman satu langkah sebelum sasaran tercapai. |
goalPreviousStep2 |
URL halaman dua langkah sebelum sasaran tercapai. |
goalPreviousStep3 |
URL halaman tiga langkah sebelum sasaran tercapai. |
goalName |
Nama sasaran. |
DataPeristiwa
Mewakili semua detail yang terkait dengan peristiwa.
Representasi JSON | |
---|---|
{ "eventCategory": string, "eventAction": string, "eventLabel": string, "eventValue": string, "eventCount": string } |
Kolom | |
---|---|
eventCategory |
Objek di halaman yang berinteraksi. Contoh: 'Video'. |
eventAction |
Jenis interaksi dengan objek. Contoh: 'play'. |
eventLabel |
Label yang dilampirkan dengan peristiwa. |
eventValue |
Nilai numerik yang terkait dengan peristiwa. |
eventCount |
Jumlah peristiwa semacam ini dalam aktivitas ini. |