Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

เริ่มต้นใช้งาน 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 อยู่แล้ว คุณอาจต้องตั้งค่าเพิ่มเติมตามที่อธิบายไว้ใน Use Firebase ด้วยการติดแท็ก gtag.js ที่มีอยู่

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

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

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

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

      // 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 Analytics:

เว็บ v8

const analytics = firebase.analytics();

เว็บ v9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

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

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

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

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

  • ลบ [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) ใน URL ข้อมูลโค้ด gtag ของคุณควรคล้ายกับ

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • ลบบรรทัด gtag('config', ' GA_MEASUREMENT_ID '); โดยที่ GA_MEASUREMENT_ID ในข้อมูลโค้ดการกำหนด measurementId Firebase ของคุณ หากคุณมีรหัสอื่นสำหรับพร็อพเพอร์ตี้ Analytics อื่นๆ บนหน้า คุณไม่จำเป็นต้องลบบรรทัดการกำหนดค่า

  • ตรวจสอบให้แน่ใจว่าคุณเรียก firebase.analytics() ก่อนส่งเหตุการณ์ด้วย gtag()

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

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

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

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

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

เว็บ v8

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

เว็บ v9

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

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

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