Kasus Penggunaan Lanjutan

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

Pengantar

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

• Pivot
• Kelompok
• Nilai umur

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 berdasarkan negara dan mengubah hasil 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 United States diwakili dalam tabel pivot berikut:

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 mengetahui daftar dimensi dan metrik khusus Kelompok, lihat Dimensi dan metrik nilai umur (LTV) 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 berakhir harus hari Sabtu. Jika ga:cohortNthMonth ditentukan, tanggal mulai harus hari pertama dalam sebulan dan tanggal akhir harus merupakan hari terakhir dalam sebulan. 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 diakuisisi. 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

Metrik

Metrik nilai umur (LTV)