بدء استخدام "إحصاءات Google"

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

تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك، وتسجِّل نوعين أساسيين من المعلومات:

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

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

قبل البدء

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

إضافة حزمة تطوير البرامج (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'
  );

الخطوات اللاحقة