از Google Analytics برای دریافت معیارهای گزارش‌های خرابی استفاده کنید

iOS+ Android Flutter

Google Analytics موتور تجزیه و تحلیل Firebase است. وقتی از Analytics و Crashlytics با هم در برنامه خود استفاده می‌کنید، ویژگی‌هایی دریافت می‌کنید که به شما کمک می‌کنند مشکلات را ایجاد کنید و داده‌های خرابی را با جزئیات بیشتر پیگیری کنید، مانند کاربران بدون خرابی، خرده‌های نان که رویدادهای خاص قبل از خرابی را ردیابی می‌کنند، و BigQuery، جایی که می توانید معیارهای کلیدی برنامه خود را تجسم کنید.

این راهنما نحوه افزودن Analytics را به برنامه‌ای که Crashlytics راه‌اندازی کرده است توضیح می‌دهد (اگر قبلاً Crashlytics را تنظیم نکرده‌اید، Crashlytics را به برنامه خود اضافه کنید ).

مرحله 1: یک فایل پیکربندی Firebase اضافه کنید

1. فایل پیکربندی Firebase Android را به برنامه خود اضافه کنید:

   1. تنظیمات پروژه خود را باز کنید. در کارت برنامه های شما ، نام بسته برنامه ای را که برای آن به فایل پیکربندی نیاز دارید، انتخاب کنید.

   2. برای دریافت فایل پیکربندی Android Firebase ( google-services.json ) روی Download google-services.json کلیک کنید.

      • می‌توانید فایل پیکربندی Android Firebase خود را دوباره در هر زمانی دانلود کنید.
      • مطمئن شوید که فایل پیکربندی با کاراکترهای اضافی مانند (2) اضافه نشده باشد.

   3. فایل پیکربندی خود را به دایرکتوری ماژول (سطح برنامه) برنامه خود منتقل کنید.

2. برای فعال کردن محصولات Firebase در برنامه خود، افزونه google-services را به فایل‌های Gradle خود اضافه کنید.

   1. در فایل Gradle سطح ریشه (سطح پروژه) خود ( build.gradle )، قوانینی را اضافه کنید تا افزونه خدمات Google Gradle را نیز شامل شود. بررسی کنید که مخزن Maven Google را نیز دارید.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.15'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      

   2. در فایل Gradle ماژول (سطح برنامه) خود (معمولا app/build.gradle )، افزونه Google Services Gradle را اعمال کنید.

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

مرحله 2: Analytics SDK را به برنامه خود اضافه کنید

1. در فایل Gradle ماژول (سطح برنامه) خود (معمولا <project>/<app-module>/build.gradle )، وابستگی را برای کتابخانه Android Analytics اضافه کنید. توصیه می‌کنیم از Firebase Android BoM برای کنترل نسخه‌سازی کتابخانه استفاده کنید.

   Kotlin+KTX

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:31.2.0')
   
       // Add the dependency for the Analytics library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics-ktx'
   }
   

   با استفاده از Firebase Android BoM ، برنامه شما همیشه از نسخه های سازگار کتابخانه های Firebase Android استفاده می کند.

   (جایگزین) وابستگی های کتابخانه Firebase را بدون استفاده از BoM اضافه کنید

   اگر تصمیم گرفتید از Firebase BoM استفاده نکنید، باید هر نسخه کتابخانه Firebase را در خط وابستگی آن مشخص کنید.

   توجه داشته باشید که اگر از چندین کتابخانه Firebase در برنامه خود استفاده می کنید، ما قویاً توصیه می کنیم از BoM برای مدیریت نسخه های کتابخانه استفاده کنید، که تضمین می کند همه نسخه ها سازگار هستند.

   dependencies {
       // Add the dependency for the Analytics library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0'
   }
   

   Java

   dependencies {
       // Import the BoM for the Firebase platform
       implementation platform('com.google.firebase:firebase-bom:31.2.0')
   
       // Add the dependency for the Analytics library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics'
   }
   

   با استفاده از Firebase Android BoM ، برنامه شما همیشه از نسخه های سازگار کتابخانه های Firebase Android استفاده می کند.

   (جایگزین) وابستگی های کتابخانه Firebase را بدون استفاده از BoM اضافه کنید

   اگر تصمیم گرفتید از Firebase BoM استفاده نکنید، باید هر نسخه کتابخانه Firebase را در خط وابستگی آن مشخص کنید.

   توجه داشته باشید که اگر از چندین کتابخانه Firebase در برنامه خود استفاده می کنید، ما قویاً توصیه می کنیم از BoM برای مدیریت نسخه های کتابخانه استفاده کنید، که تضمین می کند همه نسخه ها سازگار هستند.

   dependencies {
       // Add the dependency for the Analytics library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation 'com.google.firebase:firebase-analytics:21.2.0'
   }
   

2. شی com.google.firebase.analytics.FirebaseAnalytics را در بالای فعالیت خود اعلام کنید:

   Kotlin+KTX

   private lateinit var firebaseAnalytics: FirebaseAnalytics
   MainActivity.kt

   Java

   private FirebaseAnalytics mFirebaseAnalytics;
   MainActivity.java

3. آن را در onCreate() راه اندازی کنید:

   Kotlin+KTX

   // Obtain the FirebaseAnalytics instance.
   firebaseAnalytics = Firebase.analytics
   MainActivity.kt

   Java

   // Obtain the FirebaseAnalytics instance.
   mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
   MainActivity.java

مراحل بعدی

• از DebugView برای تأیید رویدادهای خود استفاده کنید.
• داده های خود را در کنسول Firebase کاوش کنید.
• راهنماهای رویدادها و ویژگی های کاربر را کاوش کنید.
• بیاموزید که چگونه داده های خود را به BigQuery صادر کنید.