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

בחירת פלטפורמה: ‫iOS+‎ Android Web 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, אפשר להתחיל לתעד אירועים באמצעות ה-methods‏ log של הספרייה.

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

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

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

השלבים הבאים