شروع به کار با Google Analytics برای Flutter

انتخاب پلاتفرم: iOS+ Android وب Flutter Unity C++


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

Google Analytics داده‌های استفاده و رفتار را برای برنامه‌تان جمع‌آوری می‌کند. کیت توسعه نرم‌افزار دو نوع اصلی اطلاعات را ثبت می‌کند:

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

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

قبل از شروع

  1. firebase_core را نصب کنید و کد مقداردهی اولیه را به برنامه‌تان اضافه کنید (اگر قبلاً این کار را نکرده‌اید).

  2. برنامه‌تان را بااستفاده از کنسول Firebase در پروژه Firebase خود ثبت کنید.

  3. (توصیه‌شده) چارچوب AdSupport را به پروژه‌تان اضافه کنید تا ویژگی‌های بیشتری مثل مخاطبان و اسناددهی پویش فعال شود.

افزودن کیت توسعه نرم‌افزار 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'
  );

مراحل بعدی

  • از DebugView برای درستی‌سنجی رویدادهایتان استفاده کنید.
  • داده‌هایتان را در کنسول Firebase کاوش کنید.
  • راهنماهای مربوط به رویدادها و ویژگی‌های کاربر را کاوش کنید.
  • با نحوه صادر کردن داده‌ها به BigQuery آشنا شوید.