התחלת השימוש ב-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 שמשויכים לנכס אפליקציה + אתר.

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

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

  1. בודקים שאובייקט ההגדרה של Firebase בקוד מכיל את הערך measurementId. המזהה הזה נוצר באופן אוטומטי כשמפעילים את Analytics בפרויקט Firebase ורושמים אפליקציית אינטרנט, והוא נדרש כדי להשתמש ב-Analytics.

    • אם האפליקציה שלכם משתמשת ב-Firebase Hosting וגם משתמשת בכתובות URL שמורות עבור ערכות ה-SDK של Firebase:

      המערכת של Firebase מטפלת באופן אוטומטי בהגדרת האפליקציה. כדי להשלים את ההגדרה, מוסיפים את הסקריפטים מהכרטיס האפליקציות שלך בהגדרות הפרויקט לתג <body> של האפליקציה, אם עדיין לא עשיתם זאת.

    • אם האפליקציה לא משתמשת בכתובות URL שמורות: אם אתם עובדים עם אפליקציית אינטרנט קיימת, צריך לעדכן את אובייקט ההגדרה של Firebase בקוד כדי לוודא שהשדה measurementId קיים. אובייקט ההגדרה אמור להיראות כמו בדוגמה הבאה:

      // For Firebase JavaScript SDK v7.20.0 and later, `measurementId` is an optional field
const firebaseConfig = {
  apiKey: "API_KEY",
  authDomain: "PROJECT_ID.firebaseapp.com",
  databaseURL: "https://PROJECT_ID.firebaseio.com",
  projectId: "PROJECT_ID",
  storageBucket: "PROJECT_ID.firebasestorage.app",
  messagingSenderId: "SENDER_ID",
  appId: "APP_ID",
  measurementId: "G-GA_MEASUREMENT_ID"
};

  2. אם עדיין לא עשיתם זאת, תצטרכו להתקין את Firebase JS SDK ולהפעיל את Firebase.

  3. מוסיפים את Analytics JS SDK ומאתחלים את 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

השלבים הבאים