התחלה מהירה זו מראה לך כיצד להוסיף את Google Analytics לאפליקציה שלך ולהתחיל ברישום אירועים.
Google Analytics אוסף נתוני שימוש והתנהגות עבור אפליקציית האינטרנט שלך. ה-SDK רושם שני סוגים עיקריים של מידע:
אירועים : מה קורה באפליקציה שלך, כגון פעולות משתמש, אירועי מערכת או שגיאות.
מאפייני משתמש : תכונות שאתה מגדיר לתיאור פלחים של בסיס המשתמשים שלך, כגון העדפת שפה או מיקום גיאוגרפי.
Analytics רושם אוטומטית כמה אירועים ומאפייני משתמש ; אתה לא צריך להוסיף שום קוד כדי להפעיל אותם.
לפני שאתה מתחיל
אם עדיין לא עשית זאת, הוסף את Firebase לפרויקט ה-JavaScript שלך וודא ש-Google Analytics מופעל בפרויקט Firebase שלך:
אם אתה יוצר פרויקט Firebase חדש, הפעל את Google Analytics במהלך תהליך העבודה של יצירת הפרויקט.
אם אתה משתמש בפרויקט Firebase קיים ש-Google Analytics לא מופעל בו, עבור לכרטיסייה אינטגרציות של
כאשר אתה מפעיל את Google Analytics בפרויקט שלך, יישומי האינטרנט של Firebase מקושרים לזרמי נתונים של Google Analytics המשויכים לנכס אפליקציה + אינטרנט .
הוסף את ה-SDK של Analytics לאפליקציה שלך
בהתאם לאופן האחסון של יישום האינטרנט שלך, ייתכן שהתצורה שלך תטופל אוטומטית או שתצטרך לעדכן את אובייקט התצורה של Firebase . אם אפליקציית האינטרנט שלך כבר משתמשת ב-Google Analytics, ייתכן שתצטרך לבצע הגדרות נוספות המתוארות ב- Use Firebase עם תיוג gtag.js קיים .
בדוק שאובייקט התצורה של 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 פעל בעבר באפליקציה שלך באמצעות קטע הקוד 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 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.