Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. 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 אירוח ושימושים שמורות כתובות עבור Firebase SDKs:

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

    • אם האפליקציה שלך לא משתמשת בכתובות אתרים שמורות : אם אתה עובד עם אפליקציית אינטרנט קיימת , עדכן את אובייקט התצורה של 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 Analytics:

אינטרנט v8

const analytics = firebase.analytics();

אינטרנט v9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

השתמש ב- Firebase עם תיוג קיים gtag.js

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

  • הוסף שיחות של Google Analytics מדף Firebase אך גם מתכנן להמשיך להשתמש gtag() ישירות באותו דף.
  • רוצה להשתמש באותו מזהה מדידה בין שיחות gtag() ישירות gtag() Google Analytics שנשלחו ל- Firebase.

כדי להבטיח שהאירועים שלך יהיו זמינים לשימוש כל שירותי Firebase, השלם את שלבי ההתקנה הנוספים הבאים:

  • הסר את [?id=GA_MEASUREMENT_ID](https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID) האתר. קטע ה- gtag שלך צריך להיות דומה ל-

    <script async src="https://www.googletagmanager.com/gtag/js"></script>
    
  • הסר את השורה gtag('config', ' GA_MEASUREMENT_ID '); כאשר GA_MEASUREMENT_ID זהה measurementId ID בקטע התצורה של Firebase. אם יש לך מזהים אחרים עבור נכסי Analytics אחרים בדף, אינך צריך להסיר את שורת התצורה שלהם.

  • הקפד להתקשר ל- firebase.analytics() לפני שתשלח אירועים עם gtag() .

אחרת, אירועים שנשלחו למזהה זה באמצעות שיחות gtag() לא ישויכו ל- Firebase ולא יהיו זמינים למיקוד בשירותי Firebase אחרים.

התחל לרשום אירועים

לאחר שאותחל את שירות Analytics עם 'firebase.analytics ()' , תוכל להתחיל לרשום אירועים בשיטת 'logEvent ()' .

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

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

אינטרנט v8

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

אינטרנט v9

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

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

הצעדים הבאים