رویدادهای گزارش

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


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

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

قبل از شروع

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

رویدادهای گزارش

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

برای کمک به شما در شروع کار، «کیت توسعه نرم‌افزار» 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")
}

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 گزارش استفاده شوند. می‌توانید از ابعاد سفارشی برای داده‌های پارامتر رویداد غیرعددی و از سنجه‌های سفارشی برای داده‌های پارامتر که بهتر به‌صورت عددی نشان داده می‌شوند استفاده کنید. پس‌از اینکه پارامتر سفارشی را بااستفاده از کیت توسعه نرم‌افزار ثبت کردید، بُعد یا سنجه را ثبت کنید تا مطمئن شوید آن پارامترهای سفارشی در گزارش‌های Analytics ظاهر می‌شوند. برای انجام این کار، در کنسول Firebase، به Analytics > تعریف‌های سفارشی بروید.

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

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

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

Kotlin 

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 

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 فراخوانی کنید.

مشاهده رویدادها در گزارش اشکال‌زدایی «استودیو Android»

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

می‌توانید گزارش‌گیری مفصل را با مجموعه‌ای از فرمان‌های 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» نمایش می‌دهد و به شما کمک می‌کند فوراً تأیید کنید که رویدادها ارسال می‌شوند.

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

در کنسول Firebase، می‌توانید آمار تجمیعی رویدادهایتان را در داشبورد Analytics > رویدادها مشاهده کنید.

درباره این داشبورد به موارد زیر توجه کنید:

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

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