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


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

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

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

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

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

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

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

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

    flutter pub add firebase_analytics

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

    flutter run

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

    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'
  );

השלבים הבאים