תחילת העבודה עם Google Analytics ל-Flutter

בחירת פלטפורמה: iOS+‎ Android אינטרנט Flutter Unity C++‎


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

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

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

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

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

  1. אם עדיין לא עשיתם זאת, התקינו את firebase_core והוסיפו את קוד האיניציאליזציה לאפליקציה.

  2. רושמים את האפליקציה בפרויקט ב-Firebase באמצעות מסוף Firebase.

  3. (מומלץ) מוסיפים את AdSupport framework לפרויקט כדי להפעיל תכונות נוספות, כמו קהלים וייבוא נתוני הקמפיין.

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

  1. מהרמה הבסיסית (root) של פרויקט 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'
  );

השלבים הבאים