شروع به کار با Google Analytics ویژه Unity

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


‫Google Analytics داده‌های استفاده و عملکرد را برای برنامه‌تان جمع‌آوری می‌کند. «کیت توسعه نرم‌افزار» دو نوع اصلی اطلاعات را ثبت می‌کند:

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

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

می‌توانید در صفحات Analytics کنسول Firebase به این داده‌ها دسترسی داشته باشید.

صفحه Analytics > رویدادها گزارش‌های رویدادی را نشان می‌دهد که به‌طور خودکار برای هر نوع متمایز از رویداد Analytics ثبت‌شده توسط برنامه شما ایجاد می‌شود. درباره داشبورد بیشتر بخوانید.

برای کمک به شما در شروع کار، «کیت توسعه نرم‌افزار» Analytics تعدادی رویداد توصیه‌شده را که در انواع مختلف برنامه‌ها، ازجمله برنامه‌های خرده‌فروشی و تجارت الکترونیک، سفر، و بازی، رایج هستند تعریف می‌کند. برای کسب اطلاعات بیشتر درباره این رویدادها و زمان استفاده از آن‌ها، رویدادهای توصیه‌شده را ببینید. برای دریافت حداکثر جزئیات در گزارش‌ها، رویدادهای پیشنهادی Analytics را که برای برنامه شما منطقی است و پارامترهای تجویز‌شده آن‌ها را ثبت کنید. این کار همچنین تضمین می‌کند که از جدیدترین Google Analytics ویژگی‌ها به‌محض دردسترس قرار گرفتن بهره‌مند شوید.

قبل از شروع

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

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

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

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

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

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

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

می‌توانید بلافاصله با روش LogEvent() شروع به ثبت گزارش رویدادها کنید.

مثال زیر رویدادهایی را با انواع مختلف آرگومان‌ها ثبت می‌کند:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

مراحل بعدی