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 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"
      };
      
  2. Jika Anda belum melakukannya, instal Firebase JS SDK dan lakukan inisialisasi Firebase.

  3. 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 mana GA_MEASUREMENT_ID merupakan measurementId 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 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.

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