Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. آن را در onCreate() راه اندازی کنید:

    Kotlin+KTX

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

    Java

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

مراحل بعدی