بدء استخدام "إحصاءات 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. بعد تثبيت المكوّن الإضافي، يمكنك الوصول إليه من خلال استيراده في رمز Dart:firebase_analytics

    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'
  );

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