การเริ่มต้นอย่างรวดเร็วนี้จะแสดงวิธีเพิ่ม 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