ثبت رویدادها

این راهنما به شما نشان می دهد که چگونه رویدادها را در برنامه خود ثبت کنید.

رویدادها بینشی در مورد آنچه در برنامه شما اتفاق می‌افتد، مانند اقدامات کاربر، رویدادهای سیستم یا خطاها ارائه می‌دهند.

تجزیه و تحلیل به طور خودکار برخی از رویدادها را برای شما ثبت می کند. برای دریافت آنها نیازی به افزودن کد ندارید. اگر برنامه شما نیاز به جمع آوری داده های اضافی دارد، می توانید تا 500 نوع مختلف رویداد Analytics را در برنامه خود ثبت کنید. هیچ محدودیتی در حجم کل رویدادهایی که برنامه شما ثبت می کند وجود ندارد. توجه داشته باشید که نام رویدادها به حروف کوچک و بزرگ حساس هستند و ثبت دو رویداد که نام آنها فقط در حروف بزرگ متفاوت است منجر به دو رویداد مجزا می شود.

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

مطمئن شوید که پروژه خود را راه‌اندازی کرده‌اید و می‌توانید به Analytics همانطور که در Get Started with Analytics توضیح داده شده است دسترسی داشته باشید.

ثبت رویدادها

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

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

می‌توانید جزئیات پیاده‌سازی انواع رویدادهای پیشنهادی را در مکان‌های زیر بیابید:

مثال زیر نحوه ثبت یک رویداد 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")
}

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

علاوه بر پارامترهای تعیین شده، می توانید پارامترهای زیر را به هر رویداد اضافه کنید:

  • پارامترهای سفارشی: پارامترهای سفارشی را می توان به عنوان ابعاد یا معیارها در گزارش های Analytics استفاده کرد. می‌توانید از ابعاد سفارشی برای داده‌های پارامتر رویداد غیر عددی و معیارهای سفارشی برای هر داده پارامتری که بهتر به صورت عددی نمایش داده می‌شود، استفاده کنید. پس از اینکه یک پارامتر سفارشی را با استفاده از SDK ثبت کردید، بعد یا متریک را ثبت کنید تا مطمئن شوید که آن پارامترهای سفارشی در گزارش‌های Analytics ظاهر می‌شوند. این کار را با استفاده از Analytics > Events > Manage Custom Definitions > Create Custom Dimensions انجام دهید

    پارامترهای سفارشی را می توان در تعاریف مخاطب استفاده کرد که ممکن است برای هر گزارش اعمال شود. اگر برنامه شما به پروژه BigQuery مرتبط باشد، پارامترهای سفارشی نیز در داده‌های صادر شده به BigQuery گنجانده می‌شوند. جستجوهای نمونه و موارد دیگر را در Google Analytics 4 BigQuery Export بیابید.

  • پارامتر VALUE : VALUE یک پارامتر هدف کلی است که برای جمع آوری یک معیار کلیدی مربوط به یک رویداد مفید است. به عنوان مثال می توان به درآمد، مسافت، زمان و امتیاز اشاره کرد.

اگر برنامه شما نیازهای خاصی دارد که توسط یک نوع رویداد توصیه شده پوشش داده نمی شود، می توانید رویدادهای سفارشی خود را همانطور که در این مثال نشان داده شده است ثبت کنید:

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

پارامترهای رویداد پیش فرض را تنظیم کنید

با استفاده از setDefaultEventParameters می توانید پارامترها را در رویدادها ثبت کنید. پارامترهای پیش‌فرض با تمام رویدادهای آینده که ثبت می‌شوند مرتبط هستند.

همانند پارامترهای سفارشی، پارامترهای رویداد پیش‌فرض را ثبت کنید تا مطمئن شوید در گزارش‌های Analytics ظاهر می‌شوند.

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

اگر پارامتری در متد logEvent() مشخص شده باشد، آن مقدار به جای پیش فرض استفاده می شود.

برای پاک کردن یک پارامتر پیش فرض، متد setDefaultEventParameters را با پارامتر تنظیم شده روی null فراخوانی کنید.

رویدادها را در گزارش اشکال‌زدایی Android Studio مشاهده کنید

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

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

رویدادها را در داشبورد مشاهده کنید

در داشبوردهای کنسول Firebase می‌توانید آمار انبوه رویدادهای خود را مشاهده کنید. این داشبوردها به صورت دوره ای در طول روز به روز می شوند. برای آزمایش فوری، از خروجی logcat همانطور که در بخش قبل توضیح داده شد استفاده کنید.

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