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

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


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

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

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

تسجّل "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- في المكتبة.

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

يسجّل الرمز التالي حدث دفع:

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

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