Kasus Penggunaan Lanjutan

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. Jika ga:cohortNthMonth ditentukan, tanggal mulai harus merupakan hari pertama dalam sebulan dan tanggal akhir harus merupakan hari terakhir dalam bulan tersebut. Jika ga: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).