Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

התחל לעבוד עם 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, ייתכן שתצטרך לעשות התקנה נוספת המתוארת השתמש Firebase עם gtag.js הקיימים תיוג .

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

    • אם האפליקציה משתמשת Firebase אירוח ושימושים שמורות כתובות עבור Firebase SDKs:

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

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

גרסת אינטרנט 9

import { getAnalytics } from "firebase/analytics";

const analytics = getAnalytics();

גרסת אינטרנט 8

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() שיטה.

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

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

גרסת אינטרנט 9

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

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

גרסת אינטרנט 8

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

הצעדים הבאים