Google 致力于为黑人社区推动种族平等。查看具体举措。
หน้านี้ได้รับการแปลโดย Cloud Translation API
Switch to English

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

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

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

const analytics = firebase.analytics();
index.js

เว็บ v9.0

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();
analytics_initialize.js

ใช้ 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 ในข้อมูลโค้ดการกำหนด measurementId Firebase ของคุณ หากคุณมีรหัสอื่นสำหรับพร็อพเพอร์ตี้ Analytics อื่น ๆ บนเพจคุณไม่จำเป็นต้องลบบรรทัดการกำหนดค่าออก

  • อย่าลืมโทรหา firebase.analytics() ก่อนที่จะส่งเหตุการณ์ด้วย gtag()

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

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

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

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

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

เว็บ v8.0

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

เว็บ v9.0

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

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

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