התחלה מהירה זו מראה לך כיצד להוסיף את Google Analytics לאפליקציה שלך ולהתחיל ברישום אירועים.
Google Analytics אוסף נתוני שימוש והתנהגות עבור האפליקציה שלך. ה-SDK רושם שני סוגים עיקריים של מידע:
- אירועים: מה קורה באפליקציה שלך, כגון פעולות משתמש, אירועי מערכת או שגיאות.
- מאפייני משתמש: תכונות שאתה מגדיר לתיאור פלחים של בסיס המשתמשים שלך, כגון העדפת שפה או מיקום גיאוגרפי.
Analytics רושם אוטומטית כמה אירועים ומאפייני משתמש ; אתה לא צריך להוסיף שום קוד כדי להפעיל אותם.
לפני שאתה מתחיל
אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט ה-JavaScript שלך וודא ש-Google Analytics מופעל בפרויקט Firebase שלך:
אם אתה יוצר פרויקט Firebase חדש, הפעל את Google Analytics במהלך תהליך העבודה של יצירת הפרויקט.
אם אתה משתמש בפרויקט Firebase קיים ש-Google Analytics לא מופעל בו, עבור לכרטיסייה אינטגרציות של
הוסף את ה-SDK של Analytics לאפליקציה שלך
בדוק שאובייקט התצורה של Firebase בקוד שלך מכיל measurementId
. מזהה זה נוצר באופן אוטומטי כאשר אתה מפעיל את Analytics בפרויקט Firebase שלך ורושם אפליקציית אינטרנט, והוא נדרש כדי להשתמש ב-Analytics.אם האפליקציה שלך משתמשת ב-Firebase Hosting ומשתמשת בכתובות URL שמורות עבור Firebase SDKs : 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:
API מודולרי אינטרנט
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);
API עם מרחב שמות אינטרנט
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 מ-Firebase, אך תכנן להמשיך להשתמש בקריאות gtag()
ישירות באותו דף.רוצה להשתמש באותו מזהה מדידה בין קריאות ישירות gtag()
ונתוני Google Analytics שנשלחו ל-Firebase.
הסר את השורה gtag('config', ' GA_MEASUREMENT_ID ');
כאשר ה-GA_MEASUREMENT_ID
הואmeasurementId
של אפליקציית האינטרנט שלך Firebase. אם יש לך מזהים אחרים עבור נכסי Analytics אחרים בדף, אינך צריך להסיר את שורת התצורה שלהם.הקפד להתקשר ל- firebase.analytics()
לפני שאתה שולח אירועים עםgtag()
.
gtag()
לא ישויכו ל-Firebase ולא יהיו זמינים למיקוד בשירותי Firebase אחרים.
התחל לרשום אירועים
logEvent()
.
Web modular API
import { getAnalytics, logEvent } from "firebase/analytics"; const analytics = getAnalytics(); logEvent(analytics, 'notification_received');
Web namespaced API
firebase.analytics().logEvent('notification_received');
הצעדים הבאים
הבן כל דוח Analytics . השתמש ב- DebugView כדי לאמת את האירועים שלך. חקור את הנתונים שלך במסוף Firebase . חקור את המדריכים על אירועים ומאפייני משתמשים. למד כיצד לייצא את הנתונים שלך ל- BigQuery.