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

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


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

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

قبل از شروع

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

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

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

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

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

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

  • پارامتر 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 Studio نمایش می‌دهد و به شما کمک می‌کند فوراً تأیید کنید که رویدادها ارسال می‌شوند.

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

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

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

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

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