Catch up on everthing we announced at this year's Firebase Summit. Learn more

Bắt đầu với Google Analytics

Phần khởi động 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 sử dụng và hành vi 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, các sự kiện hệ thống, hoặc sai sót.

  • User Properties: Các thuộc tính bạn xác định để mô tả các phân đoạn của cơ sở người dùng của bạn, chẳng hạn như ngôn ngữ ưu tiên hoặc vị trí địa lý.

Analytics tự động đăng nhập một số sự kiệntính chất sử 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 sẵn sàng, thêm căn cứ hỏa lực cho dự án JavaScript của bạn và chắc chắn rằng Google Analytics được kích hoạt trong dự án căn cứ hỏa lực 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 quá trình tạo dự án.

  • Nếu bạn đang sử dụng một dự án căn cứ hỏa lực hiện có mà không có kích hoạt Google Analytics, đi đến Tích hợp tab của bạn > Cài đặt Project để kích hoạt nó.

Khi bạn bật Google Analytics trong dự án của bạn, ứng dụng web căn cứ hỏa lực của bạn có liên quan đến dữ liệu Google Analytics suối kết hợp với một tài sản App + Web .

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 phải cập nhật của bạn đối tượng cấu hình căn cứ hỏa lực . Nếu ứng dụng web của bạn đã sử dụng Google Analytics, bạn có thể cần phải làm thêm thiết lập được mô tả trong sử dụng căn cứ hỏa lực với gtag.js hiện gắn thẻ .

  1. Hãy kiểm tra xem đối tượng cấu hình căn cứ hỏa lực của bạn 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 và bắt buộc phải sử dụng Analytics.

    • Nếu ứng dụng của bạn sử dụng căn cứ hỏa lực Hosting sử dụng reserved URL cho căn cứ hỏa lực SDK:

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

    • Nếu ứng dụng của bạn không sử dụng các URL bảo lưu: Nếu bạn đang làm việc với một ứng dụng web hiện tại, cập nhật các đối tượng cấu hình căn cứ hỏa lực trong mã của bạn để đảm bảo measurementId lĩnh vực có mặt. Đối tượng cấu hình sẽ trông 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. Khởi tạo Firebase Analytics:

Phiên bản web 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

Phiên bản web 8

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 đó bạn đã có Google Analytics chạy trong ứng dụng của bạn 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 bổ sung nếu bạn có kế hoạch để làm một trong những điều sau đây:

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

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

  • Hủy bỏ các dòng gtag('config', ' GA_MEASUREMENT_ID '); nơi GA_MEASUREMENT_IDmeasurementId của ứng dụng web căn cứ hỏa lực 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 phải xóa dòng cấu hình của chúng.
  • Đảm bảo bạn gọi firebase.analytics() trước khi bạn gửi bất kỳ sự kiện với gtag() .

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

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

Sau khi bạn đã khởi tạo các dịch vụ Analytics , bạn có thể bắt đầu đăng nhập sự kiện với logEvent() phương pháp.

Một số sự kiện được đề 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ố được chỉ định của chúng, để đảm bảo thông tin 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 chứng tỏ một sự kiện đăng nhập được xác định trước, để biết thêm thông tin về các sự kiện đăng nhập, xem Log sự kiện .

Ví dụ sau 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:

Phiên bản web 9

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

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

Phiên bản web 8

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

Bước tiếp theo