Bắt đầu sử dụng Google Analytics

Hướng dẫn bắt đầu nhanh này hướng dẫn bạn cách thêm Google Analytics vào ứng dụng và bắt đầu ghi nhật ký sự kiện.

Google Analytics thu thập dữ liệu về mức sử dụng và hành vi cho ứng dụng web của bạn. SDK ghi nhật ký hai loại thông tin chính:

  • Sự kiện: Những gì đang xảy ra trong ứng dụng của bạn, chẳng hạn như hành động của người dùng, hệ thống hoặc lỗi.

  • Thuộc tính người dùng: Những thuộc tính mà bạn xác định để mô tả các phân khúc người dùng cơ sở, chẳng hạn như tuỳ chọn ngôn ngữ hoặc vị trí địa lý.

Analytics tự động ghi lại một số sự kiện và thuộc tính người dùng; bạn không cần thêm bất kỳ mã nào để bật chúng.

Trước khi bắt đầu

Thêm Firebase vào JavaScript của bạn nếu bạn chưa thêm" dự án và đảm bảo rằng bạn đã bật Google Analytics trong dự án Firebase của bạn:

  • Nếu bạn đang tạo một dự án Firebase mới, hãy bật Google Analytics trong quy trình tạo dự án.

  • Nếu bạn đang sử dụng một dự án Firebase hiện không có đã bật Google Analytics, hãy chuyển đến Các công cụ tích hợp trong tab > Cài đặt dự án để bật tính năng này.

Khi bạn bật Google Analytics trong dự án của mình, Firebase cho các ứng dụng web được liên kết với luồng dữ liệu Google Analytics Thuộc tính web và ứng dụng.

Thêm Analytics SDK vào ứng dụng của bạn

Tuỳ thuộc vào cách ứng dụng web được lưu trữ, cấu hình của bạn có thể được xử lý tự động hoặc bạn có thể cần phải cập nhật Đối tượng cấu hình Firebase. Nếu ứng dụng web của bạn đã sử dụng Google Analytics, bạn có thể cần thực hiện các bước bổ sung cách thiết lập được mô tả trong bài viết Sử dụng Firebase với tính năng gắn thẻ gtag.js hiện có.

  1. Kiểm tra để đảm bảo rằng đối tượng cấu hình Firebase trong mã của bạn chứa measurementId. Mã này được tạo tự động khi bạn bật sử dụng Analytics trong dự án Firebase của bạn và đăng ký một ứng dụng web. bắt buộc để sử dụng Analytics.

    • Nếu ứng dụng của bạn sử dụng tính năng Lưu trữ Firebase và sử dụng URL đặt trước cho Firebase SDK:

      Firebase tự động xử lý việc định cấu hình ứng dụng của bạn. Để hoàn tất thiết lập, hãy thêm tập lệnh từ thẻ Ứng dụng của bạn trong Cài đặt dự án với <body> của ứng dụng nếu bạn chưa có.

    • Nếu ứng dụng của bạn không sử dụng URL đặt trước: Nếu bạn đang làm việc với một ứng dụng web hiện có, hãy cập nhật cấu hình Firebase trong mã của bạn để đảm bảo có trường measurementId. Chiến lược phát hành đĩa đơn đối tượng config sẽ tương tự như ví dụ sau:

      // 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. Nếu bạn chưa thực hiện, cài đặt Firebase JS SDK và khởi chạy Firebase.

  3. Thêm Analytics JS SDK và khởi chạy Analytics:

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);

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();

Sử dụng Firebase với tính năng gắn thẻ gtag.js hiện tại

Nếu trước đây bạn đã chạy Google Analytics trong ứng dụng của mình bằng cách sử dụng đoạn mã gtag.js, ứng dụng của bạn có thể yêu cầu thiết lập thêm nếu bạn định thực hiện một trong những việc sau:

  • Thêm lệnh gọi Google Analytics từ Firebase vào trang nhưng cũng dự định thực hiện tiếp tục sử dụng các lệnh gọi gtag() ngay trên cùng một trang.
  • Muốn sử dụng cùng một mã đo lường giữa cả cuộc gọi gtag() trực tiếp và Dữ liệu Google Analytics được gửi đến Firebase.

Để đảm bảo tất cả dịch vụ Firebase đều có thể sử dụng sự kiện của bạn, hãy hoàn tất các bước thiết lập bổ sung sau đây:

  • Xoá dòng gtag('config', 'GA_MEASUREMENT_ID'); trong đó GA_MEASUREMENT_ID là measurementId của Ứng dụng web Firebase. Trường hợp bạn có các mã nhận dạng khác cho các tài sản Analytics khác trên trang này, bạn không cần xoá dòng cấu hình của chúng.
  • Đảm bảo bạn gọi firebase.analytics() trước khi gửi bất kỳ sự kiện nào cùng với gtag().

Nếu không, các sự kiện được gửi đến mã nhận dạng đó với lệnh gọi gtag() sẽ không được liên kết với Firebase và sẽ không thể sử dụng để nhắm mục tiêu trong các nền tảng khác các dịch vụ của Firebase.

Bắt đầu ghi nhật ký sự kiện

Sau khi bạn đã khởi chạy dịch vụ Analytics, bạn có thể ghi lại sự kiện bằng logEvent() .

Một số sự kiện được đề xuất cho tất cả các ứng dụng; các phương pháp khác được đề xuất cho các loại hình kinh doanh hoặc ngành dọc cụ thể. Bạn nên gửi các sự kiện được đề xuất cùng với các thông số quy định của sự kiện đó, để đảm bảo tối đa thông tin chi tiết có sẵn trong báo cáo của bạn, cũng như để hưởng lợi từ các tính năng và khi có thể sử dụng. Phần này minh hoạ việc ghi nhật ký một sự kiện được xác định trước, để biết thêm thông tin về các sự kiện ghi nhật ký, hãy xem Ghi nhật ký sự kiện.

Ví dụ sau minh hoạ cách ghi lại một sự kiện được đề xuất để cho biết người dùng đã nhận được thông báo trong ứng dụng của bạn:

Web

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

Web

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

Các bước tiếp theo