Panduan memulai ini menunjukkan cara menambahkan Google Analytics ke aplikasi Anda dan mulai mencatat peristiwa ke dalam log.
Google Analytics mengumpulkan data penggunaan dan perilaku untuk aplikasi web Anda. SDK ini mencatat dua jenis informasi utama ke dalam log:
Peristiwa: Hal-hal yang terjadi dalam aplikasi Anda, seperti tindakan pengguna, peristiwa sistem, atau error.
Properti pengguna: Atribut yang Anda tentukan untuk mendeskripsikan segmen basis pengguna, seperti preferensi bahasa atau lokasi geografis.
Analytics secara otomatis mencatat beberapa peristiwa dan properti pengguna ke dalam log. Anda tidak perlu menambahkan kode apa pun untuk mengaktifkannya.
Sebelum memulai
Jika belum melakukannya, tambahkan Firebase ke project JavaScript Anda dan pastikan Google Analytics sudah diaktifkan di project Firebase Anda:
Jika Anda membuat project Firebase baru, aktifkan Google Analytics selama alur kerja pembuatan project.
Jika Anda menggunakan project Firebase yang sudah ada dan belum mengaktifkan Google Analytics, buka tab Integrations di bagian
untuk mengaktifkannya. > Project settings
Saat Anda mengaktifkan Google Analytics di project, aplikasi web Firebase Anda akan ditautkan ke aliran data Google Analytics yang terkait dengan Properti Aplikasi + Web.
Menambahkan Analytics SDK ke aplikasi
Bergantung pada cara aplikasi web Anda dihosting, konfigurasi Anda dapat ditangani secara otomatis atau Anda mungkin perlu memperbarui objek konfigurasi Firebase. Jika aplikasi web Anda sudah menggunakan Google Analytics, Anda mungkin perlu melakukan penyiapan tambahan seperti yang dijelaskan di bagian Menggunakan Firebase dengan pemberian tag gtag.js yang ada.
Pastikan objek konfigurasi Firebase di kode Anda berisi
measurementId
. ID ini otomatis dibuat saat Anda mengaktifkan Analytics di project Firebase dan mendaftarkan aplikasi web. ID ini diperlukan untuk menggunakan Analytics.Jika aplikasi Anda menggunakan Firebase Hosting dan menggunakan URL yang dicadangkan untuk Firebase SDK:
Firebase menangani konfigurasi aplikasi Anda secara otomatis. Jika Anda belum melakukannya, tambahkan skrip dari kartu Your apps di Project settings ke tag <body> aplikasi Anda untuk menyelesaikan penyiapan.
Jika aplikasi Anda tidak menggunakan URL yang dicadangkan: Jika Anda menangani aplikasi web yang sudah ada, update objek konfigurasi Firebase dalam kode Anda untuk memastikan kolom
measurementId
ada. Objek konfigurasi ini akan terlihat seperti contoh berikut:// For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field const firebaseConfig = { apiKey: "AIzaSyCGQ0tYppWFJkuSxBhOpkH0xVDmX245Vdc", authDomain: "project-id.firebaseapp.com", databaseURL: "https://project-id.firebaseio.com", projectId: "project-id", storageBucket: "project-id.appspot.com", messagingSenderId: "637908496727", appId: "2:637908496727:web:a4284b4c99e329d5", measurementId: "G-9VP01NDSXJ" };
Jika Anda belum melakukannya, instal Firebase JS SDK dan lakukan inisialisasi Firebase.
Tambahkan Analytics JS SDK dan lakukan inisialisasi Analytics:
API modular web
import { initializeApp } from "firebase/app"; import { getAnalytics } from "firebase/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase const app = initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = getAnalytics(app);
API dengan namespace web
import firebase from "firebase/compat/app"; import "firebase/compat/analytics"; // TODO: Replace the following with your app's Firebase project configuration // See: https://firebase.google.com/docs/web/learn-more#config-object const firebaseConfig = { // ... }; // Initialize Firebase firebase.initializeApp(firebaseConfig); // Initialize Analytics and get a reference to the service const analytics = firebase.analytics();
Menggunakan Firebase dengan pemberian tag gtag.js yang ada
Jika sebelumnya Anda menjalankan Google Analytics di aplikasi menggunakan cuplikan gtag.js, aplikasi Anda mungkin memerlukan penyiapan tambahan jika Anda berencana melakukan salah satu dari hal berikut:
- Menambahkan panggilan Google Analytics dari Firebase ke halaman, tetapi juga berencana untuk
terus menggunakan panggilan
gtag()
langsung di halaman yang sama. - Ingin menggunakan ID pengukuran yang sama antara panggilan
gtag()
langsung dan data Google Analytics yang dikirim ke Firebase.
Guna memastikan peristiwa Anda tersedia untuk digunakan oleh semua layanan Firebase, selesaikan langkah-langkah penyiapan tambahan berikut:
- Hapus baris
gtag('config', 'GA_MEASUREMENT_ID');
di manaGA_MEASUREMENT_ID
merupakanmeasurementId
aplikasi web Firebase Anda. Jika Anda memiliki ID lain untuk properti Analytics lainnya di halaman tersebut, Anda tidak perlu menghapus baris konfigurasinya. - Pastikan untuk memanggil
firebase.analytics()
sebelum mengirimkan peristiwa apa pun menggunakangtag()
.
Jika tidak, peristiwa yang dikirim ke ID tersebut dengan panggilan gtag()
tidak akan dikaitkan
dengan Firebase, dan tidak akan tersedia untuk penargetan di
layanan Firebase yang lain.
Mulai mencatat peristiwa ke dalam log
Setelah melakukan inisialisasi layanan Analytics, Anda dapat mulai mencatat peristiwa ke dalam log dengan metode logEvent()
.
Peristiwa tertentu direkomendasikan untuk semua aplikasi, sedangkan peristiwa yang lain direkomendasikan untuk jenis atau vertical bisnis tertentu. Anda sebaiknya mengirimkan peristiwa yang disarankan beserta parameternya yang telah ditetapkan agar laporan Anda memiliki detail maksimum, serta agar fitur dan integrasi di masa mendatang dapat dimanfaatkan begitu tersedia. Bagian ini menunjukkan cara mencatat peristiwa yang telah ditentukan ke dalam log. Untuk mengetahui informasi lebih lanjut tentang cara mencatat peristiwa ke dalam log, baca artikel Mencatat peristiwa ke dalam log.
Contoh berikut menunjukkan cara mencatat peristiwa yang direkomendasikan ke dalam log untuk menandakan bahwa pengguna telah menerima notifikasi di aplikasi Anda:
API modular web
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
API dengan namespace web
firebase.analytics().logEvent('notification_received');
Langkah berikutnya
- Gunakan DebugView untuk memverifikasi peristiwa Anda.
- Pelajari data Anda di Firebase console.
- Pelajari panduan mengenai peristiwa dan properti pengguna.
- Pelajari cara mengekspor data Anda ke BigQuery.