Kasus Penggunaan Lanjutan

Dokumen ini menjelaskan fitur lanjutan Google Analytics Reporting API v4. Untuk referensi API yang mendetail, lihat Panduan Referensi.

Catatan: API ini tidak mendukung properti Google Analytics 4 (GA4). Gunakan Google Analytics Data API guna mengakses fitur pelaporan baru untuk properti GA4.

Pengantar

Setelah membuat laporan sederhana, gunakan fitur berikut untuk membuat laporan lanjutan:

• Pivot
• Kelompok
• Nilai umur

Catatan: Lihat Request Composer untuk aplikasi demo yang memanfaatkan beberapa fitur ini.

Pivot

Google Analytics Reporting API v4 memungkinkan Anda membuat Tabel Pivot. Untuk membuat permintaan dengan tabel pivot, tentukan kolom Pivot dalam 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

Panggilan API meminta sesi berdasarkan 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"
            }
          ]
        }
      ]
    }
  ]
}

Catatan: Kolom orderBys tidak memengaruhi dimensi atau metrik pivot.

Header kolom respons

Dalam objek report 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 di header pivot pada 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 di 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 sekumpulan pengguna berkarakteristik sama. Misalnya, semua pengguna dengan Tanggal Akuisisi yang sama disertakan ke 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.

Catatan: Saat menentukan permintaan kelompok, Anda tidak perlu menyediakan kolom ReportRequest.dateRanges.

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 bulan tersebut dan tanggal akhir harus berupa 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-kelompok tidak boleh berada dalam permintaan batchGet yang sama.
• Rentang tanggal dalam kelompok harus setelah 1 Februari 2015.

Nilai umur (LTV)

Laporan Nilai Umur menunjukkan bagaimana 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 didefinisikan sebagai kohor dengan kolom lifetimeValue yang 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.

Catatan: Saat menentukan permintaan nilai umur, Anda tidak perlu memberikan kolom ReportRequest.dateRanges.

Dimensi dan metrik kelompok dan nilai umur (LTV)

Dimensi

Nama Dimensi	Definisi
ga:cohort	Nama kelompok yang berisi pengguna. 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 akan menjadi 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 yang digunakan untuk mengakuisisi pengguna. 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). Ini menunjukkan jumlah pengguna dalam kelompok yang aktif dalam jangka waktu yang sesuai dengan hari/minggu/bulan kelompok. Misalnya, untuk ga:cohortNthWeek = 1, jumlah pengguna (dalam kelompok) yang aktif pada minggu kedua. Jika 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 masuk ke dalam kelompok, juga dikenal sebagai ukuran kelompok.
ga:cohortAppviewsPerUser	Tampilan aplikasi per pengguna untuk 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 kelompok.
ga:cohortVisitDurationPerUser	Durasi sesi per pengguna untuk kelompok.
ga:cohortSessionsPerUser	Sesi per pengguna untuk kelompok.

Metrik nilai umur (LTV)

Catatan: Permintaan nilai umur (LTV) saat ini hanya tersedia untuk tampilan aplikasi.

Nama Metrik	Definisi
ga:cohortTotalUsersWithLifetimeCriteria	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 (hanya tampilan aplikasi).
ga:cohortAppviewsPerUserWithLifetimeCriteria	Tampilan aplikasi per pengguna untuk dimensi akuisisi untuk kelompok (tampilan aplikasi saja).
ga:cohortGoalCompletionsPerUserWithLifetimeCriteria	Sasaran tercapai per pengguna untuk dimensi akuisisi untuk 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).