Catch up on everthing we announced at this year's Firebase Summit. Learn more

Memulai Google Analytics

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 > Project settings untuk mengaktifkannya.

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.

  1. 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 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 menggunakan aplikasi web yang sudah ada, perbarui objek konfigurasi Firebase dalam kode Anda untuk memastikan kolom measurementId sudah 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"
      };
      
  2. Inisialisasi Firebase Analytics:

Web versi 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

Web versi 8

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 antar-kedua 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'); yang berisi GA_MEASUREMENT_ID berupa measurementId aplikasi web Firebase Anda. Jika 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 menggunakan gtag().

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.

Memulai mencatat peristiwa ke dalam log

Setelah menginisialisasi layanan Analytics, Anda dapat mulai mencatat peristiwa ke dalam log dengan metode logEvent().

Sebagian peristiwa direkomendasikan untuk semua aplikasi, sedangkan sebagian peristiwa yang lain direkomendasikan hanya 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:

Web versi 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Web versi 8

firebase.analytics().logEvent('notification_received');

Langkah berikutnya