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

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

يجمع Google Analytics بيانات الاستخدام والسلوك لتطبيقك. تسجل SDK نوعين أساسيين من المعلومات:

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

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

قبل ان تبدأ

  1. قم بتثبيت firebase_core وأضف رمز التهيئة إلى تطبيقك إذا لم تقم بذلك بالفعل.
  2. أضف تطبيقك إلى مشروع Firebase الخاص بك في وحدة تحكم Firebase .

أضف Analytics SDK إلى تطبيقك

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

    flutter pub add firebase_analytics
    
  2. بمجرد الانتهاء، قم بإعادة إنشاء تطبيق Flutter الخاص بك:

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

    import 'package:firebase_analytics/firebase_analytics.dart';
    
  4. قم بإنشاء مثيل Firebase Analytics جديد عن طريق الوصول إلى خاصية 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'
  );

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