Dokumen ini memberikan ringkasan umum tentang Google Analytics Core Reporting API Versi 3.0. Untuk referensi API 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:
- Membuat dasbor kustom untuk menampilkan data Google Analytics.
- Menghemat waktu dengan mengotomatiskan tugas pelaporan yang kompleks.
- Integrasikan data Google Analytics dengan aplikasi bisnis lainnya.
Memilih Versi
Kami baru-baru ini meluncurkan versi baru Core Reporting API.
- Mem-build aplikasi baru? – Sebaiknya gunakan versi terbaru 3.0.
- Menggunakan versi lama 2.3? – Baca Panduan Migrasi untuk mengetahui detail cara mengupdate aplikasi Anda untuk menggunakan versi baru.
Memulai
Ingin segera memulai? Baca Tutorial Hello Analytics API.
Setiap aplikasi yang menggunakan API harus melalui beberapa langkah untuk mendaftarkan, memberi otorisasi kepada pengguna, dan bekerja dengan API. Tutorial ini akan memandu Anda menyelesaikan setiap langkah dan pada akhirnya Anda akan memiliki aplikasi aktif yang dapat disesuaikan.
Ringkasan Konseptual
Core Reporting API menampilkan data laporan yang terdiri dari 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:
- Bagaimana laporan berkaitan dengan pengguna dan tampilan (profil).
- Struktur laporan dan cara membuat kueri
- Bekerja dengan respons API
Laporan, Pengguna, dan Tampilan (Profil)
Untuk meminta data laporan bagi pengguna, aplikasi Anda harus mengidentifikasi pengguna dan menentukan tampilan (profil) yang akan mengambil data tersebut. 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).
- Aplikasi Anda dapat menggunakan Management API untuk melintasi hierarki konfigurasi Pengelolaan untuk mendapatkan ID tampilan (profil).
- Di URL setiap laporan dalam Google Analytics.
gambar layar
- Di Google Analytics, klik
Admin pada panel menu. Pilih akun dan properti yang
mencakup tampilan. Di kolom TAMPILAN, klik Setelan Tampilan untuk mendapatkan ID tampilan.
gambar layar
Membuat Kueri untuk Dimensi dan Metrik
Anda mengkueri API untuk data laporan Google Analytics, yang terdiri dari dimensi dan metrik. Metrik adalah pengukuran individual dari aktivitas pengguna di properti Anda, seperti sesi dan kunjungan halaman. Dimensi mengelompokkan metrik menurut 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.
Bekerja dengan Laporan
Data yang ditampilkan dalam bentuk API dapat dianggap sebagai tabel dengan header dan daftar baris. Setiap respons API terdiri dari header yang menjelaskan nama dan jenis data setiap kolom. Responsnya juga berisi daftar baris, dengan setiap baris berupa daftar sel dengan data dalam urutan yang sama seperti headernya. Gunakan informasi dalam header untuk menentukan jenis data dalam setiap sel.
Baca Panduan Referensi Core Reporting API untuk mengetahui informasi selengkapnya tentang respons API.
Kebijakan Kuota dan Penghentian Layanan
Google Analytics API menangani jutaan operasi. Untuk melindungi sistem agar tidak menerima lebih banyak operasi daripada yang dapat ditangani, dan untuk memastikan distribusi resource sistem yang setara, Anda perlu menggunakan sistem kuota. Baca panduan Batas dan Kuota untuk mengetahui batas spesifik.
Untuk mengetahui detail tentang cara penanganan perubahan pada kolom Core Reporting API (yaitu dimensi dan metrik), baca Kebijakan Penghentian Layanan Data. Untuk mempelajari cara Metadata API dapat digunakan 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 ini.
- Gunakan alat Query Explorer interaktif untuk membuat kueri secara visual dan melihat respons melalui API.
- Baca artikel Kueri Umum yang mencantumkan beberapa kueri yang paling umum untuk Core Reporting API.
- Lihat referensi Dimensi &Metrik untuk mengetahui daftar semua data yang tersedia melalui API.
- Periksa halaman Library &Sampel untuk melihat daftar semua library klien yang tersedia yang dapat digunakan dengan API ini.