ثبت وقایع

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

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

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

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

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

ثبت رویدادها

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

برای شروع به کار ، SDK Analytics تعدادی از رویدادهای پیشنهادی را تعریف می کند که در بین انواع مختلف برنامه ها رایج است ، از جمله برنامه های خرده فروشی و تجارت الکترونیک ، برنامه های سفر و بازی. برای کسب اطلاعات بیشتر در مورد این رویدادها و زمان استفاده از آنها ، مقالات [Events and properties] [پیشنهاد-رویدادها-hc] را در مرکز راهنمای Firebase مرور کنید.

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

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

سریع

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

هدف-ج

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

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

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

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

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

سریع

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

هدف-ج

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

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

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

سریع

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

هدف-ج

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

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

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

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

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

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

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

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

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

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

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