Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Bắt đầu với Google Analytics

Phần khởi động nhanh này cho bạn biết cách thêm Google Analytics vào ứng dụng của mình 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 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 của cơ sở người dùng của bạn, 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 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 có dự án Firebase hiện tại chưa bật Google Analytics, bạn có thể bật Google Analytics từ tab Tích hợp trong > 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ủa bạn được liên kết với các 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 để đảm bảo rằng đố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ý ứ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 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 thiết lập, hãy thêm các 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 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:

     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 định thực hiện một trong những điều 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 gtag() gọi gtag() trực tiếp trên cùng một trang.
  • Muốn sử dụng cùng một ID đo lường giữa cả lệnh gọi gtag() trực tiếp và dữ liệu Google Analytics được gửi đến Firebase.

Để đả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:

  • Xóa [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) trong url. Đoạn mã gtag của bạn phải tương tự như

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • Xóa gtag('config', ' GA_MEASUREMENT_ID '); dòng gtag('config', ' GA_MEASUREMENT_ID '); nơi GA_MEASUREMENT_ID là giống như measurementId tại của bạn căn cứ hỏa lực cấu hình đoạ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 rằng 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 gtag() 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 nhật ký sự kiện

Sau khi bạn đã khởi chạy dịch vụ Analytics với 'firebase.analytics ()' , bạn có thể bắt đầu ghi lại các sự kiện bằng phương pháp 'logEvent ()' .

Các sự kiện nhất định đượ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ố đượ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 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ề ghi nhật ký sự kiện, hãy xem Ghi nhật ký 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:

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

Bước tiếp theo