رویدادهای گزارش

انتخاب پلاتفرم: iOS+ Android Web Flutter Unity C++‎


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

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

قبل از شروع

پیش‌از اینکه بتوانید از Google Analytics استفاده کنید، باید:

  • پروژه Unity خود را ثبت کنید و آن را برای استفاده از Firebase پیکربندی کنید.

    • اگر پروژه Unity شما ازقبل از Firebase استفاده می‌کند، پس ازقبل برای Firebase ثبت و پیکربندی شده است.

    • اگر پروژه Unity ندارید، می‌توانید برنامه نمونه‌ای را بارگیری کنید.

  • Firebase Unity SDK (به‌طور دقیق، FirebaseAnalytics.unitypackage) را به پروژه Unity خود اضافه کنید.

توجه داشته باشید که افزودن Firebase به پروژه Unity شما شامل وظایفی در هر دو Firebase کنسول و پروژه Unity باز شما است (برای مثال، فایل‌های پیکربندی Firebase را از کنسول بارگیری می‌کنید، سپس آن‌ها را به پروژه Unity خود منتقل می‌کنید).

رویدادهای گزارش

پس‌از مقداردهی اولیه کردن واحد Firebase.Analytics.FirebaseAnalytics، می‌توانید از آن برای ثبت گزارش رویدادها با روش LogEvent() استفاده کنید.

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

جزئیات پیاده‌سازی رویدادهای توصیه‌شده را می‌توانید در مکان‌های زیر پیدا کنید:

  • رویدادهای پیشنهادی: فهرست ثابت‌های Event را ببینید.
  • پارامترهای تجویز‌شده: فهرست ثابت‌های Parameters را ببینید.

مثال زیر نشان می‌دهد که چگونه یک رویداد پیشنهادی SELECT_CONTENT را ثبت کنید:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

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

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

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

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

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

مشاهده رویدادها در برونداد گزارش

‫iOS+‎

رویدادها در کنسول ثبت می‌شوند و می‌توان آن‌ها را هنگام اجرای برنامه ازطریق XCode مشاهده کرد.

Android

می‌توانید گزارش‌گیری مفصل را در «گزارش اشکال‌زدایی Android Studio» فعال کنید تا به تأیید اینکه رویدادها به‌درستی توسط کیت توسعه نرم‌افزار ثبت می‌شوند کمک کند. این شامل رویدادهای ثبت‌شده به‌صورت خودکار و دستی می‌شود.

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

adb shell setprop log.tag.FA VERBOSE
 
adb shell setprop log.tag.FA-SVC VERBOSE
 
adb logcat -v time -s FA FA-SVC

این فرمان رویدادهای شما را در logcat «استودیوِ Android» نمایش می‌دهد و به شما کمک می‌کند فوراً تأیید کنید که رویدادها ارسال می‌شوند.

مشاهده رویدادهای تجزیه‌وتحلیل در داشبورد

در کنسول Firebase، می‌توانید آمار تجمیعی رویدادهایتان را در داشبورد Analytics > رویدادها مشاهده کنید.

درباره این داشبورد به موارد زیر توجه کنید:

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

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

درباره داشبورد بیشتر بخوانید.