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

انتخاب پلاتفرم: iOS+ Android وب 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 SDK تعدادی رویداد توصیه‌شده را تعریف می‌کند که در انواع مختلف برنامه‌ها، ازجمله برنامه‌های خرده‌فروشی و تجارت الکترونیک، سفر، و بازی، رایج هستند. برای کسب اطلاعات بیشتر درباره این رویدادها و زمان استفاده از آن‌ها، مقاله‌های رویدادهای توصیه‌شده را در «مرکز راهنمایی 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 Studio نمایش می‌دهد و به شما کمک می‌کند فوراً تأیید کنید که رویدادها ارسال می‌شوند.

مشاهده رویدادهای Analytics در داشبورد

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

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

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

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

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