Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

تجزیه و تحلیل ترافیک به طور خودکار سیاهههای مربوط به برخی حوادث و خواص کاربران ؛ برای فعال کردن آنها نیازی به افزودن کدی ندارید.

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

اگر شما در حال حاضر نیست، اضافه فایربیس به پروژه آندروید خود را و مطمئن شوید که گوگل آنالیز در پروژه Firebase خود را فعال کنید:

  • اگر در حال ایجاد یک پروژه Firebase هستید، Google Analytics را در جریان کار ایجاد پروژه فعال کنید.

  • اگر شما با استفاده از پروژه های موجود فایربیس که لازم نیست گوگل آنالیز را فعال کنید، رفتن به یکپارچگی تب از خود > تنظیمات پروژه به آن را فعال کنید.

هنگامی که Google Analytics را در پروژه خود فعال می کنید، برنامه های Firebase شما به جریان داده های Google Analytics مرتبط می شوند.

Analytics SDK را به برنامه خود اضافه کنید

  1. با استفاده از فایربیس آندروید BOM ، اعلام وابستگی برای کتابخانه تجزیه و تحلیل آندروید در ماژول خود را (در سطح برنامه) فایل Gradle (معمولا app/build.gradle ).

    جاوا

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.1')
    
        // Declare 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'
    }
    

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

    (جایگزین) اعلام فایربیس وابستگی کتابخانه بدون استفاده از BOM

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

    توجه داشته باشید که در صورت استفاده از کتابخانه فایربیس های متعدد در برنامه شما، ما به شدت توصیه با استفاده از BOM به مدیریت نسخه های کتابخانه، که تضمین می کند که تمام نسخه های سازگار است.

    dependencies {
        // Declare 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:20.0.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.1')
    
        // Declare 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'
    }
    

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

    (جایگزین) اعلام فایربیس وابستگی کتابخانه بدون استفاده از BOM

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

    توجه داشته باشید که در صورت استفاده از کتابخانه فایربیس های متعدد در برنامه شما، ما به شدت توصیه با استفاده از BOM به مدیریت نسخه های کتابخانه، که تضمین می کند که تمام نسخه های سازگار است.

    dependencies {
        // Declare 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:20.0.0'
    }
    

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

    جاوا

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. مقداردهی اولیه آن را در onCreate() روش:

    جاوا

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

    Kotlin+KTX

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

ثبت رویدادها را شروع کنید

بعد از اینکه یک ایجاد کرده اند FirebaseAnalytics به عنوان مثال، شما می توانید شروع به ورود به سیستم حوادث با logEvent() روش.

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

کد زیر را سیاهههای مربوط به SELECT_CONTENT رویداد هنگامی که یک کلیک کاربر بر روی یک عنصر خاص در برنامه شما.

جاوا

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

Kotlin+KTX

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

می‌توانید گزارش‌دهی دقیق را برای نظارت بر ثبت رویدادها توسط SDK فعال کنید تا به تأیید اینکه رویدادها به درستی ثبت می‌شوند کمک کند. این شامل رویدادهای ثبت شده به صورت خودکار و دستی می شود.

شما می توانید ورود به سیستم طولانی با یک سری از فعال adb دستورات:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

این دستور رویدادهای شما را در لاگ‌ت اندروید استودیو نمایش می‌دهد و به شما کمک می‌کند فوراً تأیید کنید که رویدادها ارسال می‌شوند.

مراحل بعدی