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


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

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

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

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

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

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

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

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

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

کیت توسعه نرم‌افزار (SDK) Analytics را به برنامه خود اضافه کنید.

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

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.5.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 استفاده خواهد کرد.

    (جایگزین) اضافه کردن وابستگی‌های کتابخانه 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:23.0.0")
}

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

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

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

    Kotlin 

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

    Java 

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

شروع ثبت وقایع

پس از ایجاد یک نمونه 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")
}
MainActivity.kt

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);
MainActivity.java

شما می‌توانید ثبت وقایع به صورت کامل (verbose logging) را فعال کنید تا ثبت وقایع توسط SDK را رصد کنید و از صحت ثبت وقایع اطمینان حاصل کنید. این شامل وقایع ثبت شده به صورت خودکار و دستی می‌شود.

شما می‌توانید با استفاده از یک سری دستورات adb ، قابلیت ثبت وقایع شفاهی (verbose logging) را فعال کنید: 

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

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

مراحل بعدی