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


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

تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك. حزمة SDK لتسجيل نوعين أساسيين من المعلومات وهما:

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

تسجِّل "إحصاءات 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'
  );

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