איך מתחילים להשתמש ב-Google Analytics לאתרים

בחירת פלטפורמה: iOS+‎ Android אינטרנט Flutter Unity C++‎


במדריך למתחילים הזה מוסבר איך להוסיף את 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, יכול להיות שתצטרכו לבצע הגדרות נוספות, כפי שמתואר במאמר שימוש ב-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"
};
      ‫1. אם עדיין לא עשיתם זאת, התקינו את Firebase JS SDK והפעילו את Firebase. 2. מוסיפים את ה-JS SDK של Analytics ומפעילים את 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, אפשר להתחיל לתעד אירועים באמצעות ה-method‏ logEvent().

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

בדוגמה הבאה אפשר לראות איך מתעדים אירוע מומלץ כדי לציין שמשתמש קיבל התראה באפליקציה:

Web

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

const analytics = getAnalytics();
logEvent(analytics, 'notification_received');

Web

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

השלבים הבאים