Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

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 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 menggambarkan 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 Anda 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 Integrasi di bagian > Setelan project untuk mengaktifkannya.

Saat mengaktifkan Google Analytics di project, aplikasi web Firebase Anda akan ditautkan ke aliran data Google Analytics yang terkait dengan Properti Aplikasi + Web.

Menambahkan SDK Analytics ke aplikasi Anda

Tergantung 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. Periksa apakah 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 Aplikasi Anda di Setelan project 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. Inisialisasikan Firebase Analytics:

Web v8

const analytics = firebase.analytics();

Web v9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

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 [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) di URL. Cuplikan gtag Anda harus serupa dengan

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • Hapus baris gtag('config', 'GA_MEASUREMENT_ID'); dengan GA_MEASUREMENT_ID sama dengan measurementId dalam cuplikan konfigurasi Firebase Anda. Jika Anda memiliki ID lain untuk properti Analytics yang lain di halaman, 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 dengan 'firebase.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 harus 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 menunjukkan bahwa pengguna telah menerima notifikasi di aplikasi Anda:

Web v8

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

Web v9

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

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

Langkah berikutnya