התחלת השימוש ב-Google Analytics


במדריך למתחילים הזה נסביר איך מוסיפים את Google Analytics לאפליקציה ומתחילים לתעד אירועים.

Google Analytics אוסף נתוני שימוש והתנהגות של האפליקציה. ביומן של ה-SDK מתועדים שני סוגים עיקריים של מידע:

  • אירועים: מה שקורה באפליקציה, כמו פעולות משתמשים, אירועי מערכת או שגיאות.
  • מאפייני משתמשים: מאפיינים שאתם מגדירים כדי לתאר פלחים של בסיס המשתמשים שלכם, כמו העדפת שפה או מיקום גיאוגרפי.

Analytics מתעד באופן אוטומטי חלק מהאירועים ומאפייני המשתמשים. אין צורך להוסיף קוד כדי להפעיל אותם.

לפני שמתחילים

אם עדיין לא עשיתם זאת, מוסיפים את Firebase לפרויקט JavaScript ומוודאים ש-Google Analytics מופעל בפרויקט Firebase:

  • אם אתם יוצרים פרויקט חדש ב-Firebase, צריך להפעיל את Google Analytics במהלך תהליך יצירת הפרויקט.

  • אם אתם משתמשים בפרויקט קיים ב-Firebase שלא מופעל בו Google Analytics, תוכלו להפעיל אותו בכרטיסייה Integrations בקטע > Project settings.

כשמפעילים את Google Analytics בפרויקט, אפליקציות האינטרנט ב-Firebase מקושרות למקורות הנתונים של Google Analytics שמשויכים לנכס מסוג אפליקציה + אתר.

הוספת ה-SDK של Analytics לאפליקציה

בהתאם לאופן שבו אפליקציית האינטרנט מתארחת, יכול להיות שההגדרות יטופלו באופן אוטומטי או שתצטרכו לעדכן את אובייקט ההגדרה של Firebase. אם באפליקציית האינטרנט שלכם כבר נעשה שימוש ב-Google Analytics, יכול להיות שתצטרכו לבצע הגדרות נוספות כפי שמתואר במאמר שימוש ב-Firebase עם תיוג קיים של gtag.js.

  1. בודקים שהאובייקט של הגדרות 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"
};

  2. אם עדיין לא עשיתם זאת, מתקינים את Firebase JS SDK ומפעילים את Firebase.

  3. מוסיפים את ה-SDK של Analytics JS ומפעילים את Analytics:

Web 

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 

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

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

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

Web

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

השלבים הבאים