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

התחלה מהירה זו מראה לך כיצד להוסיף את 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 קיים .

  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. הוסף את 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');

הצעדים הבאים