با Google Analytics شروع کنید


این آموزش سریع به شما نشان می‌دهد که چگونه Google Analytics به برنامه خود اضافه کنید و شروع به ثبت رویدادها کنید.

گوگل آنالیتیکس داده‌های مربوط به استفاده و رفتار برنامه شما را جمع‌آوری می‌کند. SDK دو نوع اطلاعات اصلی را ثبت می‌کند:

  • رویدادها: آنچه در برنامه شما اتفاق می‌افتد، مانند اقدامات کاربر، رویدادهای سیستم یا خطاها.
  • ویژگی‌های کاربر: ویژگی‌هایی که شما برای توصیف بخش‌هایی از پایگاه کاربری خود تعریف می‌کنید، مانند ترجیح زبان یا موقعیت جغرافیایی.

آنالیتیکس به طور خودکار برخی رویدادها و ویژگی‌های کاربر را ثبت می‌کند؛ برای فعال کردن آنها نیازی به اضافه کردن هیچ کدی ندارید.

قبل از اینکه شروع کنی

  1. اگر قبلاً firebase_core را نصب نکرده‌اید، آن را نصب کنید و کد راه‌اندازی اولیه را به برنامه خود اضافه کنید.
  2. برنامه خود را به پروژه Firebase خود در کنسول Firebase اضافه کنید.

کیت توسعه نرم‌افزار (SDK) تجزیه و تحلیل (Analytics) را به برنامه خود اضافه کنید.

  1. از ریشه پروژه Flutter خود، دستور زیر را برای نصب افزونه اجرا کنید:

    flutter pub add firebase_analytics

  2. پس از اتمام، برنامه Flutter خود را بازسازی کنید:

    flutter run

  3. پس از نصب، می‌توانید با وارد کردن افزونه firebase_analytics در کد Dart خود، به آن دسترسی پیدا کنید:

    import 'package:firebase_analytics/firebase_analytics.dart';

  4. با دسترسی به ویژگی instance در FirebaseAnalytics یک نمونه جدید Firebase Analytics ایجاد کنید:

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

مراحل بعدی