Dokumen ini menjelaskan fitur lanjutan Google Analytics Reporting API v4. Untuk referensi API yang mendetail, lihat Panduan Referensi.
Pengantar
Setelah membuat laporan sederhana, gunakan fitur berikut untuk membuat laporan lanjutan:
Pivot
Google Analytics Reporting API v4 memungkinkan Anda membuat Tabel Pivot.
Untuk membuat permintaan dengan tabel pivot, tentukan kolom Pivot di
ReportRequest.
Objek Pivot memiliki kumpulan dimensi dan metriknya sendiri, serta startGroup
dan maxGroupCount
opsional untuk menentukan jumlah dimensi yang akan disertakan dalam tabel pivot.
Permintaan
Sesi permintaan panggilan API berikut menurut negara dan mengubah hasilnya di browser:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dateRanges":
[
{
"startDate": "2014-11-01",
"endDate": "2014-11-30"
}
],
"metrics":
[
{
"expression": "ga:sessions"
}
],
"dimensions":
[
{
"name": "ga:country"
}
],
"pivots":
[
{
"dimensions":
[
{
"name": "ga:browser"
}
],
"maxGroupCount": 3,
"startGroup": 3,
"metrics":
[
{
"expression": "ga:sessions"
}
]
}
]
}
]
}
Header kolom respons
Dalam objek laporan yang ditampilkan untuk permintaan pivot, metricHeader
memiliki daftar objek pivotHeaders yang kolom pivotHeaderEntries
-nya menentukan urutan nilai dimensi pivot dan nilai metrik yang sesuai, misalnya:
"columnHeader": {
"dimensions": [
"ga:country"
],
"metricHeader": {
"metricHeaderEntries": [
{
"name": "ga:sessions",
"type": "INTEGER"
}
],
"pivotHeaders": [
{
"pivotHeaderEntries": [
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Internet Explorer"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Firefox"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
},
{
"dimensionNames": [
"ga:browser"
],
"dimensionValues": [
"Android Browser"
],
"metric": {
"name": "ga:sessions",
"type": "INTEGER"
}
}
],
"totalPivotGroupsCount": 7
}
]
}
},
Baris respons
Setiap baris objek reportData menentukan array objek dateRangeValue, yang masing-masing berisi kumpulan objek pivotValue; urutan nilai sesuai dengan urutan metrik yang tercantum dalam header pivot di header kolom respons.
"rows": [
...
{
"dimensions": [
"United States"
],
"metrics": [
{
"pivotValues": [
{
"values": [
"21",
"18",
"1"
]
}
],
"values": [
"192"
]
}
]
}
],
Perhatikan bahwa hanya ada tiga nilai pivot dalam laporan
karena dalam permintaan asli, maxGroupCount
adalah 3. Mungkin ada
hingga tujuh nilai karena "totalPivotGroupsCount": 7
.
Contoh baris tabel pivot
Dalam contoh respons di atas, baris yang terkait dengan negara Amerika Serikat diwakili dalam tabel pivot berikut:
Negara | Total Sesi |
Sesi Internet Explorer |
Sesi FireFox |
Sesi Browser Android |
---|---|---|---|---|
India | 12 | 3 | 2 | 4 |
Amerika Serikat | 192 | 21 | 18 | 1 |
Inggris Raya | 35 | 12 | 2 | 0 |
Kelompok
Kelompok adalah sekelompok pengguna yang memiliki karakteristik yang sama. Misalnya, semua pengguna dengan Tanggal Akuisisi yang sama termasuk dalam kelompok yang sama. Dengan laporan Analisis Kelompok, Anda dapat memisahkan dan menganalisis perilaku kelompok. Untuk daftar dimensi dan metrik khusus Kelompok, lihat Dimensi dan metrik kelompok dan nilai umur (LTV).
Untuk menentukan permintaan kelompok, Anda harus menentukan
objek kohor
dengan name
, type
, dan dateRange
:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthDay"
}
],
"metrics":
[
{
"expression": "ga:cohortActiveUsers"
},
{
"expression": "ga:cohortTotalUsers"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-08-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-07-01"
}
}
]
}
}
]
}
Lihat contoh di atas di API Explorer.
Pembatasan kelompok
Permintaan kelompok yang valid harus memenuhi batasan berikut:
- Dimensi
ga:cohort
disertakan jika dan hanya jika permintaan memiliki satu atau beberapa definisi kelompok. - Nama kelompok harus unik.
- Jumlah maksimum kelompok dalam permintaan adalah 12.
- Jika
ga:cohortNthWeek
ditentukan, tanggal mulai harus hari Minggu dan tanggal akhir harus hari Sabtu. Jikaga:cohortNthMonth
ditentukan, tanggal mulai harus merupakan hari pertama dalam sebulan dan tanggal akhir harus merupakan hari terakhir dalam bulan tersebut. Jikaga:cohortNthDay
ditentukan, rentang tanggal harus tepat satu hari. - Permintaan kelompok dengan tanggal hari ini tidak diizinkan.
- Permintaan kelompok dan non-kohor tidak boleh berada dalam permintaan
batchGet
yang sama. - Rentang tanggal dalam kelompok harus setelah 1 Februari 2015.
Nilai umur (LTV)
Laporan Nilai Umur menunjukkan pertumbuhan nilai pengguna (Pendapatan) dan engagement (Tampilan Aplikasi, Sasaran Tercapai, Sesi, dan Durasi Sesi) selama 90 hari setelah pengguna diperoleh. Lihat dimensi dan metrik khusus LTV.
Permintaan LTV ditentukan sebagai kohor
dengan kolom lifetimeValue
ditetapkan ke true
, misalnya:
POST https://analyticsreporting.googleapis.com/v4/reports:batchGet
{
"reportRequests":
[
{
"viewId": "XXXX",
"dimensions":
[
{
"name": "ga:cohort"
},
{
"name": "ga:cohortNthWeek"
}
],
"metrics":
[
{
"expression": "ga:cohortTotalUsersWithLifetimeCriteria"
},
{
"expression": "ga:cohortRevenuePerUser"
}
],
"cohortGroup":
{
"cohorts":
[
{
"name": "cohort 1",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-08-01",
"endDate": "2015-09-01"
}
},
{
"name": "cohort 2",
"type": "FIRST_VISIT_DATE",
"dateRange":
{
"startDate": "2015-07-01",
"endDate": "2015-08-01"
}
}
],
"lifetimeValue": true
}
}
]
}
Lihat contoh di atas di API Explorer.
Dimensi dan metrik kelompok dan nilai umur (LTV)
Dimensi
Nama Dimensi | Definisi |
---|---|
ga:cohort |
Nama kelompok tempat pengguna berada. Bergantung pada cara penentuan kelompok, pengguna dapat masuk ke dalam beberapa kelompok, mirip dengan cara pengguna dapat masuk ke dalam beberapa segmen. |
ga:cohortNthDay |
Offset hari berbasis 0 relatif terhadap tanggal definisi kelompok. Misalnya, jika kelompok ditentukan dengan tanggal kunjungan pertama sebagai 2015-09-01 , maka untuk tanggal 2015-09-04 , ga:cohortNthDay adalah 3. |
ga:cohortNthMonth |
Offset bulan berbasis 0 relatif terhadap tanggal definisi kelompok. |
ga:cohortNthWeek |
Offset minggu berbasis 0 relatif terhadap tanggal definisi kelompok. |
ga:acquisitionTrafficChannel |
Saluran traffic yang digunakan untuk mengakuisisi pengguna. Ini diekstrak dari sesi pertama pengguna. Saluran traffic dihitung berdasarkan aturan pengelompokan saluran default (di tingkat tampilan jika tersedia) pada saat akuisisi pengguna. |
ga:acquisitionSource |
Sumber tempat pengguna diperoleh. Diambil dari sesi pertama pengguna. |
ga:acquisitionMedium |
Media yang digunakan untuk mengakuisisi pengguna. Diambil dari sesi pertama pengguna. |
ga:acquisitionSourceMedium |
Nilai gabungan ga:userAcquisitionSource dan ga:acquisitionMedium . |
ga:acquisitionCampaign |
Kampanye yang digunakan untuk mengakuisisi pengguna. Diambil dari sesi pertama pengguna. |
Metrik
Nama Metrik | Definisi |
---|---|
ga:cohortActiveUsers |
Metrik ini relevan dalam konteks dimensi offset berbasis 0 (ga:cohortNthDay , ga:cohortNthWeek , atau ga:cohortNthMonth ). Metrik ini menunjukkan jumlah pengguna dalam kelompok yang aktif selama jangka waktu yang sesuai dengan hari/minggu/bulan ke-n untuk kelompok tersebut. Misalnya, untuk ga:cohortNthWeek = 1 , jumlah pengguna (dalam kelompok) yang aktif di minggu kedua. Jika sebuah permintaan tidak memiliki ga:cohortNthDay , ga:cohortNthWeek , atau ga:cohortNthMonth , metrik ini akan memiliki nilai yang sama dengan ga:cohortTotalUsers . |
ga:cohortTotalUsers |
Jumlah pengguna yang termasuk dalam kelompok, juga dikenal sebagai ukuran kelompok. |
ga:cohortAppviewsPerUser |
Tampilan aplikasi per pengguna untuk sebuah kelompok. |
ga:cohortGoalCompletionsPerUser |
Sasaran tercapai per pengguna untuk kelompok. |
ga:cohortPageviewsPerUser |
Kunjungan halaman per pengguna untuk kelompok. |
ga:cohortRetentionRate |
Rasio retensi kelompok. |
ga:cohortRevenuePerUser |
Pendapatan per pengguna untuk sebuah kelompok. |
ga:cohortVisitDurationPerUser |
Durasi sesi per pengguna untuk kelompok. |
ga:cohortSessionsPerUser |
Sesi per pengguna untuk kelompok. |
Metrik nilai umur (LTV)
Nama Metrik | Definisi |
---|---|
ga:cohortTotalUsersWithLifetimeCriteria |
Nilai ini relevan dalam konteks permintaan yang memiliki dimensi ga:acquisitionTrafficChannel , ga:acquisitionSource , ga:acquisitionMedium , atau ga:acquisitionCampaign . Ini menunjukkan jumlah pengguna dalam kelompok yang diperoleh melalui saluran, sumber, media, atau kampanye saat ini. Misalnya, ga:acquisitionTrafficChannel=Direct mewakili jumlah pengguna dalam kelompok, yang diperoleh secara langsung. Jika tidak ada dimensi yang disebutkan, nilainya sama dengan ga:cohortTotalUsers (khusus tampilan aplikasi). |
ga:cohortAppviewsPerUserWithLifetimeCriteria |
Tampilan aplikasi per pengguna untuk dimensi akuisisi untuk kelompok (khusus tampilan aplikasi). |
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria |
Sasaran tercapai per pengguna untuk dimensi akuisisi bagi kelompok (khusus tampilan aplikasi). |
ga:cohortPageviewsPerUserWithLifetimeCriteria |
Kunjungan halaman per pengguna untuk dimensi akuisisi untuk kelompok (khusus tampilan aplikasi). |
ga:cohortRevenuePerUserWithLifetimeCriteria |
Pendapatan per pengguna untuk dimensi akuisisi untuk kelompok (khusus tampilan aplikasi). |
ga:cohortSessionsPerUserWithLifetimeCriteria |
Durasi sesi per pengguna untuk dimensi akuisisi untuk kelompok (khusus tampilan aplikasi). |