เริ่มต้นใช้งาน 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 รายการที่เชื่อมโยงกับ พร็อพเพอร์ตี้แอป + เว็บ

เพิ่ม SDK Analytics ลงในแอป

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

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

    • หากแอปของคุณใช้ Firebase Hosting และใช้ 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 

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

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

ใช้ 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

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');
analytics_log_event.js

Web

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

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