Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

يوضح لك هذا Quickstart كيفية إضافة 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'
  );

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