ثبت رویدادها

انتخاب پلتفرم:

iOS+ اندروید وب فلاتر یونیتی سی پلاس پلاس

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

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

مطمئن شوید که پروژه خود را راه‌اندازی کرده‌اید و می‌توانید طبق توضیحات «شروع به کار با Analytics» به Analytics دسترسی داشته باشید.

اگر می‌خواهید داده‌های مربوط به انتساب کمپین‌ها را برای برنامه‌های پلتفرم اپل جمع‌آوری کنید، حتماً چارچوب AdSupport را به پروژه خود اضافه کنید .

ثبت رویدادها

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

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

برای کمک به شما در شروع کار، 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 : یک پارامتر عمومی که برای جمع‌آوری یک معیار کلیدی مربوط به یک رویداد مفید است. مثال‌ها شامل درآمد، مسافت، زمان و امتیازها می‌شوند.

• نام پارامترها می‌تواند تا ۴۰ کاراکتر طول داشته باشد و باید با یک کاراکتر الفبایی شروع شود و فقط شامل کاراکترهای الفبایی-عددی و زیرخط باشد. انواع رشته و عدد پشتیبانی می‌شوند. مقادیر پارامترهای رشته‌ای می‌توانند تا ۱۰۰ کاراکتر طول داشته باشند. پیشوندهای "firebase "، "google " و "ga_" رزرو شده هستند و نباید برای نام پارامترها استفاده شوند.

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

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

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

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

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

همانند پارامترهای سفارشی، پارامترهای رویداد پیش‌فرض را ثبت کنید تا از نمایش آنها در گزارش‌های آنالیتیکس اطمینان حاصل شود.

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

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

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

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