ثبت رویدادها


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

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

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

قبل از شروع

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

ثبت رویدادها

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

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

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

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

سویفت 

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

هدف-C

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

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

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

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

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

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

سویفت 

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

هدف-C 

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

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

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

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

سویفت 

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

هدف-C

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

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

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

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

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

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

  1. در Xcode، Product > Scheme > Edit scheme را انتخاب کنید...
  2. از منوی سمت چپ Run را انتخاب کنید.
  3. تب Arguments را انتخاب کنید.
  4. در بخش Arguments Passed On Launch ، -FIRAnalyticsVerboseLoggingEnabled را اضافه کنید.

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

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

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

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