การเริ่มต้นอย่างรวดเร็วนี้จะแสดงวิธีเพิ่ม 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 ที่มีอยู่
ตรวจสอบว่าออบเจ็กต์การกำหนดค่า 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" };
ติดตั้ง Firebase JS SDK และเริ่มต้น Firebase หากยังไม่ได้ทำ
เพิ่ม 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');
Web
firebase.analytics().logEvent('notification_received');
ขั้นตอนถัดไป
- ทำความเข้าใจรายงาน Analytics แต่ละรายการ
- ใช้ DebugView เพื่อยืนยันเหตุการณ์
- สำรวจข้อมูลในคอนโซล Firebase
- สํารวจคำแนะนำเกี่ยวกับเหตุการณ์และพร็อพเพอร์ตี้ผู้ใช้
- ดูวิธีส่งออกข้อมูลไปยัง BigQuery