Check out what’s new from Firebase at Google I/O 2022. Learn more

ثبت رویدادها

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

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

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

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

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

ثبت رویدادها

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

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

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

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

سریع

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"
                                 }];

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

  • پارامترهای سفارشی: پارامترهای سفارشی را می توان به عنوان ابعاد یا معیارها در گزارش های 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,
])

هدف-C

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

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

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

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

سریع

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، Product > Scheme > Edit scheme را انتخاب کنید...
  2. از منوی سمت چپ Run را انتخاب کنید.
  3. تب Arguments را انتخاب کنید.
  4. در بخش Arguments Passed On Launch ، -FIRAnalyticsDebugEnabled را اضافه کنید.

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

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

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

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