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

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


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

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

قبل از شروع

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

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

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

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

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

جزئیات پیاده‌سازی را می‌توانید در مرجع ثابت‌ها برای 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 Export پیدا کنید.

  • پارامتر 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، Product > Scheme > Edit scheme... (محصول > طرح > ویرایش طرح...) را انتخاب کنید.
  2. اجرا را از منوِ سمت راست انتخاب کنید.
  3. برگه استدلال‌ها را انتخاب کنید.
  4. در بخش Arguments Passed On Launch، -FIRAnalyticsVerboseLoggingEnabled را اضافه کنید.

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

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

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

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

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

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