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

اختيار النظام الأساسي: iOS+ Android الويب Flutter Unity C++‎


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

تجمع حزمة تطوير البرامج (SDK) الخاصة بـ 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 في المكتبة.

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

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

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

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