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

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

ตัวยึดตำแหน่ง113

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 JS SDK และเริ่มต้น Firebase

  3. เพิ่ม Analytics JS SDK และเริ่มต้น Analytics:

Web version 9

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 version 8

import firebase from "firebase/app";
import "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
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()

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

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

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

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

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

Web version 9

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

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

Web version 8

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

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

ตัวยึดตำแหน่ง132