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 bạn và bắt đầu ghi nhật ký các sự kiện.
Google Analytics thu thập dữ liệu hành vi và sử dụng cho ứng dụng web 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 : Các thuộc tính bạn xác định để mô tả các phân đoạn trong 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 nhật ký 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 để 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 tại chưa bật Google Analytics, hãy chuyển đến tab Tích hợp trong của bạn > Cài đặt dự án để bật dự á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ó .
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. 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 và sử dụng URL dành riêng cho SDK Firebase :
Firebase tự động xử lý 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ào thẻ <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 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 cấu hình sẽ 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" };
Nếu bạn chưa cài đặt, hãy cài đặt SDK Firebase JS và khởi tạo Firebase .
Thêm SDK JS của Analytics và khởi tạo 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 cách sử dụ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 định thực hiện một trong các 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 các sự kiện của bạn, hãy hoàn tất các bước thiết lập bổ sung sau:
- Bỏ dòng
gtag('config', ' GA_MEASUREMENT_ID ');
trong đóGA_MEASUREMENT_ID
làmeasurementId
của ứng dụng web Firebase của bạn. Nếu bạn có ID khác cho các thuộc tính Analytics khác trên trang, thì 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ằnggtag()
.
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 khả dụng để nhắm mục tiêu trong các dịch vụ Firebase khác.
Bắt đầu ghi sự kiện
Sau khi bạn đã 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 được khuyến nghị cho tất cả các ứng dụng ; những ngườ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ố đã quy định của chúng để đảm bảo báo cáo của bạn có chi tiết tối đa và hưởng lợi từ các tính năng và tích hợp trong tương lai khi chúng khả dụng. Phần này minh họa việc ghi nhật ký sự kiện được xác định trước, để biết thêm thông tin về việc ghi nhật ký sự kiện, hãy xem Nhật ký sự kiện .
Ví dụ sau minh họa cách ghi nhật ký 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
- Sử dụng DebugView để xác minh 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 .
- Khám phá các hướng dẫn về sự kiện và thuộc tính người dùng.
- Tìm hiểu cách xuất dữ liệu của bạn sang BigQuery.