ثبت رویدادها


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

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

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

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

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

ثبت رویدادها

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

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

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

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

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

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

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

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

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

Kotlin 

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

Java 

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

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

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

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

Kotlin 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

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

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

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

مشاهده رویدادها در گزارش اشکال‌زدایی اندروید استودیو

شما می‌توانید ثبت وقایع به صورت کامل (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

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

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

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

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