Hướng dẫn bắt đầu nhanh này sẽ 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 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 trong người dùng cơ sở người dùng, chẳng hạn như ngôn ngữ ưu tiên hoặc vị trí địa lý.
Analytics tự động ghi lại một số nhật ký 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 số
để bật tính năng này. > Cài đặt dự án
Khi bạn bật Google Analytics trong dự án của mình, các ứng dụng web Firebase được liên kết với Google Analytics luồng dữ liệu liên kết với một Thuộc tính web và ứng dụng.
Thêm SDK Analytics vào ứng dụng
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ó.
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 Analytics trong dự án Firebase của bạn và đăng ký một ứng dụng web và đó là bắt buộc để sử dụng Analytics.Nếu ứng dụng của bạn sử dụng Firebase Hosting 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" };
Nếu bạn chưa thực hiện, cài đặt Firebase JS SDK và khởi chạy Firebase.
Thêm SDK JS Analytics 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 Google Analytics lệnh gọi 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à Đã gửi dữ liệu Google Analytics đế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ớigtag()
.
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 nên dùng 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');
Web
firebase.analytics().logEvent('notification_received');
Các bước tiếp theo
- Tìm hiểu từng báo cáo Analytics.
- Sử dụng DebugView để xác minh các sự kiện của bạn.
- Khám phá dữ liệu của bạn trong bảng điều khiển Firebase.
- Hãy khám phá hướng dẫn về các sự kiện và thuộc tính người dùng.
- Tìm hiểu cách xuất dữ liệu sang BigQuery.