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


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

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

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

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

قبل از شروع

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

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

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

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

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

  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:33.6.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:22.1.2")
}
     به دنبال یک ماژول کتابخانه خاص کاتلین هستید؟ از اکتبر 2023 ( Firebase BoM 32.5.0) ، توسعه دهندگان Kotlin و Java می توانند به ماژول کتابخانه اصلی وابسته باشند (برای جزئیات، به سؤالات متداول در مورد این ابتکار مراجعه کنید).

  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

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

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

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

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

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")
}
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

می‌توانید گزارش‌دهی دقیق را برای نظارت بر ثبت رویدادها توسط 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

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

مراحل بعدی