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

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

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

  • Sự kiện: Điều 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, sự kiện hệ thống hoặc lỗi.
  • Thuộc tính người dùng: Thuộc tính bạn xác định để mô tả các phân đoạn cơ sở người dùng của mình, chẳng hạn như tùy chọn ngôn ngữ hoặc vị trí địa lý.

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

Trước khi bắt đầu

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

  • Nếu bạn đang tạo 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 dự án Firebase hiện chưa bật Google Analytics, hãy chuyển tới tab Tích hợp của > Project settings để bật nó.

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

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

Tùy thuộc vào cách ứng dụng web của bạn đượ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 cập nhật đối tượng cấu hình Firebase của mình. 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 thiết lập bổ sung được mô tả trong Sử dụng Firebase với gắn thẻ gtag.js hiện có .

  1. Kiểm tra xem đối tượng cấu hình Firebase trong mã của bạn có chứa measurementId . ID này được tạo tự động khi bạn bật Analytics trong dự án Firebase của mình và đăng ký một ứng dụng web. Đồng thời, ID này là bắt buộc để sử dụng Analytics.

    • Nếu ứng dụng của bạn sử dụng Dịch vụ lưu trữ Firebase sử dụng URL dành riêng cho SDK Firebase :

      Firebase tự động xử lý việc định cấu hình ứng dụng của bạn. Để hoàn tất quá trình 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ào thẻ <body> của ứng dụng nếu bạn chưa thêm.

    • Nếu ứng dụng của bạn không sử dụng URL dành riêng : 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 đối tượng cấu hình Firebase trong mã của bạn để đảm bảo có trường measurementId . Đối tượng config sẽ trông giống 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 có, hãy cài đặt SDK Firebase JS và khởi chạy Firebase .

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

API mô-đun 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 không gian tên 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 có

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

  • Thêm lệnh gọi Google Analytics từ Firebase vào trang nhưng cũng có kế hoạch tiếp tục sử dụng lệnh gọi gtag() trực tiếp trên cùng một trang.
  • Muốn sử dụng cùng một mã đo lường giữa cả lệnh gọi gtag() trực tiếp và dữ liệu Google Analytics được gửi tới Firebase.

Để đảm bảo tất cả cá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:

  • Xóa dòng gtag('config', ' GA_MEASUREMENT_ID '); trong đó GA_MEASUREMENT_IDmeasurementId của ứng dụng web Firebase của bạn. Nếu bạn có các ID khác cho các thuộc tính Analytics khác trên trang, bạn không cần xóa 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 bằng gtag() .

Nếu không, các sự kiện được gửi tới ID đó bằng lệnh gọi gtag() sẽ không được liên kết với Firebase và sẽ không có sẵn để nhắm mục tiêu trong các dịch vụ Firebase khác.

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

Sau khi khởi chạy dịch vụ Analytics , bạn có thể bắt đầu ghi nhật ký các sự kiện bằng phương thức logEvent() .

Một số sự kiện nhất định được đề xuất cho tất cả ứng dụng ; những cái 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ố được quy định của chúng để đảm bảo chi tiết có sẵn tối đa trong báo cáo của bạn và để hưởng lợi từ các tính năng và tích hợp trong tương lai khi chúng có sẵn. Phần này trình bày cách ghi nhật ký một sự kiện được xác định trước, để biết thêm thông tin về ghi nhật ký sự kiện, hãy xem Nhật ký sự kiện .

Ví dụ sau đây minh họa cách ghi lại 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 modular API

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

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

Web namespaced API

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

Bước tiếp theo