ثبت رویدادها


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

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

قبل از شروع

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

ثبت رویدادها

پس از ایجاد یک نمونه FirebaseAnalytics ، می توانید از آن برای ثبت رویدادها با متدهای log کتابخانه استفاده کنید.

رویدادهای از پیش تعریف شده

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

می‌توانید روش‌های گزارش برای انواع رویدادهای توصیه‌شده را در مرجع API پیدا کنید.

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

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

همچنین، می‌توانید همان رویداد را با استفاده از logEvent() ثبت کنید:

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

اگر بخواهید پارامترهای دیگری غیر از پارامترهای تجویز شده (الزامی) را مشخص کنید، می تواند مفید باشد. شما می توانید پارامترهای زیر را به هر رویداد اضافه کنید:

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

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

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

  • نام پارامترها می تواند حداکثر 40 کاراکتر باشد و باید با یک نویسه الفبایی شروع شود و فقط شامل نویسه های حروف عددی و زیرخط باشد. انواع رشته و num پشتیبانی می شوند. مقادیر پارامتر رشته می تواند تا 100 کاراکتر طول داشته باشد. پیشوندهای "firebase "، "google " و "ga_" رزرو شده اند و نباید برای نام پارامترها استفاده شوند.

رویدادهای سفارشی

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

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

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

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

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

مقادیر پارامتر معتبر String و num هستند. با تنظیم مقدار یک کلید به null ، آن پارامتر پاک می شود. ارسال یک مقدار تهی همه پارامترها را پاک می کند.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

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

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

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

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

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