بدء استخدام "إحصاءات 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'
  );

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