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

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


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

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

قبل از شروع

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

اگر می‌خواهید داده‌های اسنادی پویش را جمع‌آوری کنید، حتماً چارچوب AdSupport را به پروژه‌تان اضافه کنید.

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

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

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

جزئیات پیاده‌سازی را می‌توانید در مرجع ثابت‌های Swift و Objective-C پیدا کنید.

مثال زیر نحوه ثبت رویداد توصیه‌شده kFIRSelectContent را نشان می‌دهد:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

  • پارامترهای سفارشی: پارامترهای سفارشی می‌توانند به‌عنوان ابعاد یا سنجه‌ها در Analytics گزارش استفاده شوند. می‌توانید از ابعاد سفارشی برای داده‌های پارامتر رویداد غیرعددی و از سنجه‌های سفارشی برای داده‌های پارامتر که بهتر به‌صورت عددی نشان داده می‌شوند استفاده کنید. پس‌از اینکه پارامتر سفارشی را بااستفاده از کیت توسعه نرم‌افزار ثبت کردید، بُعد یا سنجه را ثبت کنید تا مطمئن شوید آن پارامترهای سفارشی در گزارش‌های Analytics نمایان می‌شوند. برای انجام این کار، در کنسول Firebase، به Analytics > تعریف‌های سفارشی بروید.

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

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

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

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name,
  "full_text": text,
])

Objective-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

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

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

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

Swift 

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Objective-C 

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

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

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

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

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

می‌توانید گزارش‌گیری مفصل را به این صورت فعال کنید:

  1. در Xcode، محصول > طرح > ویرایش طرح... را انتخاب کنید.
  2. اجرا را از منوِ سمت راست انتخاب کنید.
  3. برگه استدلال‌ها را انتخاب کنید.
  4. در بخش استدلال‌های منتقل‌شده در زمان راه‌اندازی، -FIRAnalyticsVerboseLoggingEnabled را اضافه کنید.

دفعه بعد که برنامه‌تان را اجرا می‌کنید، رویدادهایتان در کنسول اشکال‌زدایی Xcode نمایش داده می‌شود و به شما کمک می‌کند بلافاصله تأیید کنید که رویدادها ارسال می‌شوند.

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

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

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

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

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