يوضّح لك دليل البدء السريع هذا كيفية إضافة Google Analytics إلى تطبيقك و بدء تسجيل الأحداث.
تجمع "إحصاءات Google" بيانات الاستخدام والسلوك لتطبيقك. تسجِّل حزمة تطوير البرامج (SDK) نوعَين أساسيَين من المعلومات:
- الأحداث: ما يحدث في تطبيقك، مثل إجراءات المستخدمين أو أحداث النظام أو الأخطاء
- خصائص المستخدِمين: هي السمات التي تحدّدها لوصف شرائح قاعدة المستخدِمين، مثل اللغة المفضّلة أو الموقع الجغرافي.
تسجِّل "إحصاءات Google" تلقائيًا بعض الأحداث و خصائص المستخدِمين، ولا تحتاج إلى إضافة أيّ رمز لتفعيلها.
قبل البدء
- ثبِّت
firebase_core
وأضِف رمز الإعداد إلى تطبيقك إذا لم يسبق لك إجراء ذلك. - أضِف تطبيقك إلى مشروعك على Firebase في وحدة تحكّم Firebase.
إضافة حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" إلى تطبيقك
من جذر مشروع Flutter، شغِّل الأمر التالي لتثبيت المكوّن الإضافي:
flutter pub add firebase_analytics
بعد الانتهاء، أعِد إنشاء تطبيق Flutter:
flutter run
بعد التثبيت، يمكنك الوصول إلى المكوّن
firebase_analytics
الإضافي من خلال استيراده في رمز Dart:import 'package:firebase_analytics/firebase_analytics.dart';
أنشئ مثيلًا جديدًا من "إحصاءات Firebase" من خلال الوصول إلى موقع
instance
علىFirebaseAnalytics
:FirebaseAnalytics analytics = FirebaseAnalytics.instance;
بدء تسجيل الأحداث
بعد إنشاء مثيل FirebaseAnalytics
، يمكنك البدء في تسجيل
الأحداث باستخدام طرق log
في المكتبة.
هناك أحداث معيّنة ننصح بها لجميع التطبيقات، وأحداث أخرى ننصح بها لأنواع أنشطة تجارية أو قطاعات معيّنة. يجب إرسال الأحداث المُقترَحة مع المَعلمات المخصَّصة لها، لضمان توفير أقصى قدر ممكن من التفاصيل في تقاريرك والاستفادة من الميزات وعمليات الدمج المستقبلية عند توفّرها. يوضّح هذا القسم تسجيل حدث pre-defined (مُحدَّد مسبقًا)، ولمزيد من المعلومات عن تسجيل الأحداث، يُرجى الاطّلاع على تسجيل الأحداث.
تسجِّل التعليمة البرمجية التالية حدث الدفع:
await FirebaseAnalytics.instance
.logBeginCheckout(
value: 10.0,
currency: 'USD',
items: [
AnalyticsEventItem(
itemName: 'Socks',
itemId: 'xjw73ndnw',
price: '10.0'
),
],
coupon: '10PERCENTOFF'
);
الخطوات التالية
- استخدِم DebugView للتحقّق من أحداثك.
- استكشِف بياناتك في وحدة تحكُّم Firebase.
- اطّلِع على الأدلة حول الأحداث وخصائص المستخدِمين.
- تعرَّف على كيفية تصدير بياناتك إلى BigQuery.