Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

התחל עם 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:

Web version 9

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 version 8

import firebase from "firebase/app";
import "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
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 version 9

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

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

Web version 8

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

הצעדים הבאים