תחילת העבודה עם 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. אחרי ההתקנה, אפשר לגשת לתוסף על ידי ייבוא שלו לקוד Dart:firebase_analytics

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

השלבים הבאים