התחלת השימוש ב-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'
  );

השלבים הבאים