ثبت وقایع

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

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

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

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

اطمینان حاصل کنید که شما در راه اندازی پروژه خود را و همان طور که در می توانید تجزیه و تحلیل ترافیک دسترسی به کار با تجزیه و تحلیل ترافیک آغاز شده .

ثبت رویدادها

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

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

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

در مثال زیر، چگونه برای ورود پیشنهاد kFIRSelectContent رویداد:

سریع

نکته: این محصول فایربیس در دسترس بر روی هدف از MacOS است.
Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

هدف-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

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

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

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

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

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

سریع

نکته: این محصول فایربیس در دسترس بر روی هدف از MacOS است.
Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

هدف-C

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

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

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

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

سریع

نکته: این محصول فایربیس در دسترس بر روی هدف از MacOS است.
Analytics.setDefaultEventParameters([ "level_name": "Caverns01"، "level_difficulty": 4 ])

هدف-C

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

اگر یک پارامتر در تعیین کرده logEvent() روش، که ارزش، به جای به طور پیش فرض استفاده می شود.

برای پاک کردن یک پارامتر پیش فرض، با setDefaultEventParameters روش با مجموعه پارامتر به nil .

رویدادها را در کنسول رفع اشکال Xcode مشاهده کنید

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

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

  1. در Xcode متعلق به، را انتخاب کنید طرح محصولات> طرح> ویرایش ...
  2. انتخاب کنید Run را از منوی سمت چپ.
  3. تب استدلال را انتخاب کنید.
  4. در آرگومان در بخش راه اندازی، افزودنی -FIRAnalyticsDebugEnabled .

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

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

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

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