بدء استخدام "إحصاءات Google" لنظام Flutter

اختيار المنصة: iOS+ Android Web Flutter Unity C++


يوضّح لك هذا الدليل السريع كيفية إضافة "إحصاءات Google" إلى تطبيقك والبدء في تسجيل الأحداث.

Google Analytics تجمع بيانات الاستخدام والسلوك لتطبيقك. وتسجِّل حزمة تطوير البرامج (SDK) نوعَين أساسيَّين من المعلومات:

  • الأحداث: ما يحدث في تطبيقك، مثل إجراءات المستخدم أو أحداث النظام أو الأخطاء.
  • خصائص المستخدمين: سمات تحدّدها لوصف شرائح من قاعدة المستخدمين لديك، مثل اللغة المفضّلة أو الموقع الجغرافي.

تسجِّل Analytics تلقائيًا بعض الأحداث و خصائص المستخدمين؛ ولا تحتاج إلى إضافة أي رمز لتفعيلها.

قبل البدء

  1. ثبِّت firebase_core وأضِف رمز الإعداد إلى تطبيقك إذا لم يسبق لك إجراء ذلك.

  2. سجِّل تطبيقك في مشروع Firebase باستخدام الـ Firebase وحدة تحكّم.

  3. (ننصحك بذلك) أضِف إطار عمل AdSupport إلى مشروعك لتفعيل ميزات إضافية، مثل شرائح الجمهور وتحديد المصدر في الحملات.

إضافة حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" إلى تطبيقك

  1. من جذر مشروع Flutter، نفِّذ الأمر التالي لتثبيت المكوّن الإضافي:

    flutter pub add firebase_analytics

  2. بعد اكتمال التثبيت، أعِد إنشاء تطبيق Flutter:

    flutter run

  3. بعد التثبيت، يمكنك الوصول إلى المكوّن الإضافي firebase_analytics من خلال استيراده في رمز Dart البرمجي:

    import 'package:firebase_analytics/firebase_analytics.dart';

  4. أنشئ مثيلاً جديدًا من "إحصاءات Firebase" من خلال الوصول إلى السمة instance في FirebaseAnalytics:

    FirebaseAnalytics analytics = FirebaseAnalytics.instance;

بدء تسجيل الأحداث

بعد إنشاء مثيل FirebaseAnalytics، يمكنك البدء في تسجيل الأحداث باستخدام طرق log- في المكتبة.

يُنصح باستخدام أحداث معيّنة لجميع التطبيقات، بينما يُنصح باستخدام أحداث أخرى لأنواع أو قطاعات معيّنة من المؤسسات. يجب إرسال الأحداث المقترَحة مع المَعلمات المخصَّصة لها لضمان توفير أكبر قدر من التفاصيل في تقاريرك والاستفادة من الميزات وعمليات الدمج المستقبلية عند توفّرها. يوضّح هذا القسم كيفية تسجيل حدث محدّد مسبقًا. لمزيد من المعلومات عن تسجيل الأحداث، يُرجى الاطّلاع على مقالة تسجيل الأحداث.

يسجِّل الرمز البرمجي التالي حدث checkout:

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

الخطوات التالية