Apa itu Core Reporting API - Ringkasan

Dokumen ini memberikan ringkasan umum tentang Google Analytics Core Reporting API Versi 3.0. Untuk referensi API yang mendetail, lihat Panduan Referensi.

Pengantar

Google Analytics Core Reporting API memberi Anda akses ke sebagian besar data laporan di Google Analytics. Dengan Core Reporting API, Anda dapat:

  • Buat dasbor kustom untuk menampilkan data Google Analytics.
  • Hemat waktu dengan mengotomatiskan tugas pelaporan yang kompleks.
  • Integrasikan data Google Analytics Anda dengan aplikasi bisnis lain.

Memilih Versi

Baru-baru ini kami meluncurkan versi baru Core Reporting API.

  • Membuat aplikasi baru? – Sebaiknya gunakan versi terbaru 3.0.
  • Menggunakan versi lama 2.3? – Baca Panduan Migrasi untuk mengetahui detail tentang cara mengupdate aplikasi agar dapat menggunakan versi baru.

Memulai

Ingin langsung memulai? Baca Tutorial Hello Analytics API.

Setiap aplikasi yang menggunakan API harus melalui beberapa langkah untuk mendaftar, memberi otorisasi kepada pengguna, dan bekerja dengan API. Tutorial ini akan memandu Anda melalui setiap langkah dan pada akhirnya, Anda akan memiliki aplikasi berfungsi yang dapat disesuaikan.

Ringkasan Konseptual

Core Reporting API menampilkan data laporan yang berisi statistik yang berasal dari data yang dikumpulkan oleh kode pelacakan Google Analytics. Setiap laporan diatur sebagai dimensi dan metrik. Anda menggunakan Core Reporting API untuk membuat kueri dimensi dan metrik agar dapat membuat laporan yang disesuaikan.

Ada 3 konsep dasar yang mendasari Core Reporting API:

  1. Bagaimana laporan berkaitan dengan pengguna dan tampilan (profil).
  2. Struktur laporan dan cara membuat kueri
  3. Menangani respons API

Laporan, Pengguna, dan Tampilan (Profil)

Untuk meminta data laporan bagi pengguna, aplikasi Anda harus mengidentifikasi pengguna dan menentukan tampilan (profil) yang datanya akan diambil. Pengguna diidentifikasi dengan mendapatkan kredensial otorisasi dan meneruskannya dalam setiap permintaan API. Tampilan (profil) adalah bagian dari hierarki konfigurasi Google Analytics dan diidentifikasi oleh ID tampilan (profil).

Ada beberapa cara untuk menemukan ID tampilan (profil) Anda.

  • Aplikasi Anda dapat menggunakan Management API untuk menjelajahi hierarki konfigurasi Pengelolaan untuk mendapatkan ID tampilan (profil).
  • Di URL setiap laporan di Google Analytics.
  • Di Google Analytics, klik Admin di panel menu. Pilih akun dan properti yang memiliki tampilan tersebut. Di kolom TAMPILAN, klik Setelan Tampilan untuk mendapatkan ID tampilan.

Membuat Kueri untuk Dimensi dan Metrik

Anda membuat kueri ke data laporan API untuk Google Analytics, yang terdiri dari dimensi dan metrik. Metrik adalah pengukuran individual dari aktivitas pengguna di properti Anda, seperti sesi dan kunjungan halaman. Dimensi menguraikan metrik dalam beberapa kriteria umum, seperti negara atau browser. Saat membuat kueri, Anda menentukan dimensi dan metrik yang diinginkan dalam data laporan.

Gunakan Panduan Referensi Dimensi & Metrik interaktif untuk mempelajari semua dimensi dan metrik yang diekspos melalui API. Baca juga Panduan Referensi Core Reporting API untuk mempelajari cara menentukan dimensi dan metrik dalam kueri API.

Menangani Laporan

Data yang ditampilkan dari API dapat dianggap sebagai tabel dengan header dan daftar baris. Setiap respons API terdiri dari header yang menjelaskan nama dan jenis data dari setiap kolom. Responsnya juga berisi daftar baris, dengan setiap baris berisi daftar sel dengan data dalam urutan yang sama seperti header. Anda menggunakan informasi di header untuk menentukan jenis data di setiap sel.

Baca Panduan Referensi Core Reporting API untuk mengetahui informasi selengkapnya tentang respons API.

Kembali ke Atas

Kebijakan Kuota dan Penghentian

Google Analytics API menangani jutaan operasi. Untuk melindungi sistem agar tidak menerima operasi lebih banyak daripada yang dapat ditanganinya, dan untuk memastikan distribusi resource sistem yang setara, sistem perlu menggunakan sistem kuota. Baca panduan Batas dan Kuota untuk mengetahui batas tertentu.

Untuk mengetahui detail tentang cara penanganan perubahan pada kolom Core Reporting API (yaitu dimensi dan metrik), baca Kebijakan Penghentian Layanan Data. Untuk mempelajari cara menggunakan Metadata API untuk memeriksa kolom yang tidak digunakan lagi, lihat Panduan Developer Metadata API.

Langkah Berikutnya

Setelah Anda memahami cara kerja API, kami memiliki banyak referensi untuk membantu Anda memulai:

  • Baca Panduan Developer untuk mempelajari cara menggunakan API.
  • Gunakan alat Penjelajah Kueri interaktif untuk membuat kueri secara visual dan melihat responsnya melalui API.
  • Baca artikel Kueri Umum yang mencantumkan beberapa kueri paling umum ke Core Reporting API.
  • Lihat referensi Dimensi & Metrik untuk mengetahui daftar semua data yang tersedia melalui API.
  • Lihat halaman Library & Contoh untuk melihat daftar semua library klien yang tersedia yang dapat digunakan dengan API ini.

Kembali ke Atas