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

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

Google Analytics จะรวบรวมข้อมูลการใช้งานและพฤติกรรมของแอป โดย SDK จะบันทึกข้อมูล 2 ประเภทหลักดังนี้

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

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 โดยทำดังนี้

Web Modular 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');
analytics_log_event.js

API ที่ใช้เนมสเปซในเว็บ

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

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