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

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


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

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

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

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

قبل از شروع

اگر قبلاً این کار را نکرده‌اید، Firebase را به پروژه Android خود اضافه کنید و مطمئن شوید که Google Analytics در پروژه Firebase شما فعال است:

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

  • اگر از پروژه Firebase موجودی استفاده می‌کنید که Google Analytics در آن فعال نیست، می‌توانید آن را در تنظیمات > برگه ادغام‌ها فعال کنید.

وقتی Google Analytics را در پروژه‌تان فعال می‌کنید، برنامه‌های Firebase شما به جاری‌سازی‌های داده Google Analytics پیوند داده می‌شوند.

کیت توسعه نرم‌افزار Analytics را به برنامه‌تان اضافه کنید

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

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:35.0.2"))

    // 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:24.0.0")
}

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

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;

  3. آن را در روش onCreate() مقداردهی اولیه کنید:

    Kotlin 

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

    Java 

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

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

پس‌از ایجاد نمونه FirebaseAnalytics، می‌توانید بااستفاده از روش logEvent()، رویدادها را ثبت کنید.

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

کد زیر رویداد SELECT_CONTENT را زمانی ثبت می‌کند که کاربر روی عنصر خاصی در برنامه‌تان کلیک کند.

Kotlin 

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

Java 

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

می‌توانید ثبت گزارش پرجزئیات را فعال کنید تا ثبت گزارش رویدادها توسط کیت توسعه نرم‌افزار را پایش کنید و به درستی ثبت شدن رویدادها کمک کنید. این شامل رویدادهای ثبت‌شده به‌صورت خودکار و دستی می‌شود.

می‌توانید گزارش‌گیری مفصل را با مجموعه‌ای از فرمان‌های adb فعال کنید:

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

این فرمان رویدادهایتان را در logcat مربوط به Android Studio نمایش می‌دهد و به شما کمک می‌کند فوراً تأیید کنید که رویدادها ارسال می‌شوند.

مراحل بعدی