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


במדריך למתחילים הזה נסביר איך מוסיפים את Google Analytics לאפליקציה ומתחילים לתעד אירועים.

מערכת Google Analytics אוספת נתוני שימוש והתנהגות עבור האפליקציה. ה-SDK מתעד שני סוגים עיקריים של מידע:

  • אירועים: מה שקורה באפליקציה, כמו פעולות משתמשים, אירועי מערכת או שגיאות.
  • מאפייני משתמשים: מאפיינים שאתם מגדירים כדי לתאר פלחים של בסיס המשתמשים שלכם, כמו העדפות שפה או מיקום גיאוגרפי.

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

לפני שמתחילים

  1. מתקינים את firebase_core ומוסיפים את קוד האיפוס לאפליקציה, אם עדיין לא עשיתם זאת.
  2. מוסיפים את האפליקציה לפרויקט Firebase במסוף Firebase.

מוסיפים את Analytics SDK לאפליקציה

  1. כדי להתקין את הפלאגין, מריצים את הפקודה הבאה מהשורש של פרויקט Flutter:

    flutter pub add firebase_analytics

  2. בסיום, יוצרים מחדש את אפליקציית Flutter:

    flutter run

  3. אחרי ההתקנה, אפשר לגשת לפלאגין firebase_analytics על ידי ייבוא שלו לקוד Dart:

    import 'package:firebase_analytics/firebase_analytics.dart';

  4. כדי ליצור מכונה חדשה של Firebase Analytics, נכנסים לנכס instance ב-FirebaseAnalytics:

    FirebaseAnalytics analytics = FirebaseAnalytics.instance;

התחלת הרישום של אירועים ביומן

אחרי שיוצרים מופע של FirebaseAnalytics, אפשר להתחיל לתעד אירועים באמצעות השיטות מסוג log בספרייה.

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

הקוד הבא מתעד ביומן אירוע של תשלום בקופה:

await FirebaseAnalytics.instance
  .logBeginCheckout(
    value: 10.0,
    currency: 'USD',
    items: [
      AnalyticsEventItem(
        itemName: 'Socks',
        itemId: 'xjw73ndnw',
        price: '10.0'
      ),
    ],
    coupon: '10PERCENTOFF'
  );

השלבים הבאים