เริ่มต้นใช้งาน Google Analytics

การเริ่มต้นอย่างรวดเร็วนี้จะแสดงวิธีเพิ่ม Google Analytics ลงในแอปของคุณและเริ่มบันทึกเหตุการณ์

Google Analytics รวบรวมข้อมูลการใช้งานและพฤติกรรมสำหรับเว็บแอปของคุณ SDK บันทึกข้อมูลหลักสองประเภท:

  • เหตุการณ์ : สิ่งที่เกิดขึ้นในแอปของคุณ เช่น การกระทำของผู้ใช้ กิจกรรมของระบบ หรือข้อผิดพลาด

  • คุณสมบัติผู้ใช้ : แอตทริบิวต์ที่คุณกำหนดเพื่ออธิบายกลุ่มฐานผู้ใช้ของคุณ เช่น การตั้งค่าภาษาหรือที่ตั้งทางภูมิศาสตร์

Analytics จะบันทึก เหตุการณ์ และ คุณสมบัติผู้ใช้ บางอย่างโดยอัตโนมัติ คุณไม่จำเป็นต้องเพิ่มรหัสใดๆ เพื่อเปิดใช้งาน

ก่อนที่คุณจะเริ่ม

หากคุณยังไม่ได้ เพิ่ม Firebase ลงในโปรเจ็กต์ JavaScript ของคุณ และตรวจสอบให้แน่ใจว่าได้เปิดใช้งาน Google Analytics ในโปรเจ็กต์ Firebase ของคุณแล้ว:

  • หากคุณกำลังสร้างโปรเจ็กต์ Firebase ใหม่ ให้เปิดใช้งาน Google Analytics ในระหว่างขั้นตอนการสร้างโปรเจ็กต์

  • หากคุณใช้โปรเจ็กต์ Firebase ที่มีอยู่ซึ่งไม่ได้เปิดใช้งาน Google Analytics ให้ไปที่แท็บ การรวมระบบ ของคุณ > การตั้งค่าโครงการ เพื่อเปิดใช้งาน

เมื่อคุณเปิดใช้ Google Analytics ในโปรเจ็กต์ เว็บแอป Firebase ของคุณจะลิงก์กับสตรีมข้อมูล Google Analytics ที่เชื่อมโยงกับ พร็อพเพอร์ตี้แอป + เว็บ

เพิ่ม Analytics SDK ลงในแอปของคุณ

ขึ้นอยู่กับวิธีการโฮสต์เว็บแอปพลิเคชันของคุณ การกำหนดค่าของคุณอาจได้รับการจัดการโดยอัตโนมัติหรือคุณอาจต้องอัปเดตอ อบเจ็กต์การกำหนดค่า Firebase ของคุณ หากเว็บแอปของคุณใช้ Google Analytics อยู่แล้ว คุณอาจต้องตั้งค่าเพิ่มเติมตามที่อธิบายไว้ใน ใช้ Firebase ด้วยการติดแท็ก gtag.js ที่มีอยู่

  1. ตรวจสอบว่าออบเจ็กต์การกำหนดค่า Firebase ในโค้ดของคุณมี measurementId รหัสนี้จะสร้างขึ้นโดยอัตโนมัติเมื่อคุณเปิดใช้ Analytics ในโปรเจ็กต์ Firebase และลงทะเบียนเว็บแอป และจำเป็นต้องใช้ Analytics

    • หากแอปของคุณใช้โฮสติ้งของ Firebase และ ใช้ URL ที่สงวนไว้ สำหรับ Firebase SDK ให้ทำดังนี้

      Firebase จะจัดการการกำหนดค่าแอปพลิเคชันของคุณโดยอัตโนมัติ หากต้องการตั้งค่าให้เสร็จสมบูรณ์ ให้เพิ่มสคริปต์จากการ์ด แอปของคุณ ใน การตั้งค่าโปรเจ็กต์ ของคุณลงในแท็ก <body> ของแอปของคุณ หากคุณยังไม่ได้ดำเนินการ

    • หากแอปของคุณไม่ได้ใช้ URL ที่สงวนไว้ : หากคุณกำลังทำงานกับเว็บแอปที่มีอยู่ ให้อัปเดตออบเจ็กต์การกำหนดค่า Firebase ในโค้ดของคุณเพื่อให้แน่ใจว่ามีช่อง measurementId ปรากฏอยู่ วัตถุการกำหนดค่าควรมีลักษณะคล้ายกับตัวอย่างต่อไปนี้:

      // 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. หากคุณยังไม่ได้ ดำเนินการ ให้ติดตั้ง Firebase JS SDK และเริ่มต้น Firebase

  3. เพิ่ม Analytics JS SDK และเริ่มต้น Analytics:

API แบบโมดูลาร์ของเว็บ

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 เนมสเปซของเว็บ

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();

ใช้ Firebase กับการติดแท็ก gtag.js ที่มีอยู่

หากก่อนหน้านี้คุณเคยใช้ Google Analytics ในแอปโดยใช้ ข้อมูลโค้ด gtag.js แอปของคุณอาจต้องตั้งค่าเพิ่มเติมหากคุณวางแผนที่จะดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้

  • เพิ่มการโทร Google Analytics จาก Firebase ลงในหน้า แต่ยังวางแผนที่จะใช้การเรียก gtag() โดยตรงในหน้าเดียวกันต่อไป
  • ต้องการใช้รหัสการวัดเดียวกันระหว่างการเรียก gtag() โดยตรงและข้อมูล Google Analytics ที่ส่งไปยัง Firebase

เพื่อให้แน่ใจว่ากิจกรรมของคุณพร้อมใช้งานโดยบริการ Firebase ทั้งหมด ให้ทำตามขั้นตอนการตั้งค่าเพิ่มเติมต่อไปนี้:

  • ลบบรรทัด gtag('config', ' GA_MEASUREMENT_ID '); โดยที่ GA_MEASUREMENT_ID คือ measurementId ของเว็บแอป Firebase ของคุณ หากคุณมีรหัสอื่นสำหรับพร็อพเพอร์ตี้ Analytics อื่นๆ บนหน้าเว็บ คุณไม่จำเป็นต้องลบบรรทัดการกำหนดค่าออก
  • ตรวจสอบให้แน่ใจว่าคุณเรียก firebase.analytics() ก่อนที่จะส่งเหตุการณ์ใดๆ ด้วย gtag()

มิฉะนั้น เหตุการณ์ที่ส่งไปยังรหัสนั้นด้วยการเรียก gtag() จะไม่เชื่อมโยงกับ Firebase และจะไม่สามารถกำหนดเป้าหมายในบริการ Firebase อื่นๆ ได้

เริ่มบันทึกเหตุการณ์

หลังจากที่คุณเริ่มต้น บริการ Analytics แล้ว คุณสามารถเริ่มบันทึกเหตุการณ์ด้วยวิธี logEvent()

แนะนำให้ใช้กิจกรรมบางอย่างสำหรับแอปทั้งหมด ส่วนอื่นๆ ได้รับการแนะนำสำหรับประเภทธุรกิจหรือประเภทธุรกิจที่เฉพาะเจาะจง คุณควรส่งเหตุการณ์ที่แนะนำพร้อมกับพารามิเตอร์ที่กำหนดไว้ เพื่อให้รายงานมีรายละเอียดสูงสุด และเพื่อให้ได้รับประโยชน์จากคุณลักษณะและการผสานรวมในอนาคตเมื่อพร้อมใช้งาน ส่วนนี้สาธิตการบันทึกเหตุการณ์ที่กำหนดไว้ล่วงหน้า สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการบันทึกเหตุการณ์ โปรดดูที่ บันทึกเหตุการณ์

ตัวอย่างต่อไปนี้สาธิตวิธีบันทึกเหตุการณ์ที่แนะนำเพื่อระบุว่าผู้ใช้ได้รับการแจ้งเตือนในแอปของคุณ

Web modular API

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

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

Web namespaced API

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

ขั้นตอนถัดไป