Skip to Content
مستندات متریکس همواره در حال بهبود است! 🚀 آخرین به‌روزرسانی‌ها را از اینجا دنبال کنید.
قابلیت هاردیابی رویدادها و Taxonomy

ردیابی رویدادها و Taxonomy

رویدادها ستون فقرات متریکس هستند. آن‌ها به ما می‌گویند کاربران شما در اپلیکیشن یا وب‌سایت چه کارهایی انجام می‌دهند و کسب‌وکار شما چگونه در حال پیشرفت است. درک و پیاده‌سازی صحیح رویدادها، کلید دستیابی به تحلیل‌های دقیق، سگمنت‌بندی‌های هوشمند و اتوماسیون‌های مؤثر است. یادتان باشد: “داده‌ی بد، نتیجه‌ی بد” (Garbage In, Garbage Out). کیفیت گزارش‌ها و کمپین‌های شما مستقیماً به کیفیت رویدادهایی که ارسال می‌کنید، بستگی دارد.


۱. انواع رویدادها در متریکس

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

  • رویدادهای سفارشی (Custom Events): این‌ها اقداماتی هستند که کاربران شما در اپلیکیشن یا وب‌سایت انجام می‌دهند. نمونه‌هایی از این رویدادها عبارتند از: product_viewed (مشاهده محصول)، item_added_to_cart (افزودن کالا به سبد خرید)، button_clicked (کلیک روی دکمه) یا level_completed (تکمیل مرحله در بازی). شما این رویدادها را با SDKهای متریکس ثبت و ارسال می‌کنید.

  • رویدادهای درآمد (Revenue Events): این نوع، یک زیرمجموعه از رویدادهای سفارشی است که به طور خاص برای ردیابی تراکنش‌های مالی استفاده می‌شود. رویدادهای درآمدی برای اندازه‌گیری دقیق درآمد و محاسبه ROI کمپین‌های بازاریابی شما حیاتی هستند. برای ثبت این رویدادها، اجباری است که ویژگی‌های amount (مبلغ) و currency (واحد پول) را به همراه آن‌ها ارسال کنید، مثلاً: purchase_completed با amount=150000 و currency=IRR.

  • رویدادهای کسب‌وکار (Business Events): برخلاف رویدادهای سفارشی که توسط کاربر تریگر می‌شوند، رویدادهای کسب‌وکار رخدادهایی هستند که از سمت سیستم بک‌اند شما اتفاق می‌افتند و نه از سمت تعامل مستقیم کاربر. این رویدادها معمولاً بر روی تعداد زیادی از کاربران یا کل سیستم تأثیر می‌گذارند و به یک کاربر خاص محدود نمی‌شوند. مثال‌ها: product_discounted (محصول تخفیف خورد و همه کاربرانی که آن محصول را مشاهده کرده‌اند، تحت تأثیر قرار می‌گیرند) یا stock_updated (موجودی انبار به‌روز شد که می‌تواند بر روی دسترسی محصولات برای همه کاربران تأثیر بگذارد). این رویدادها برای غنی‌سازی داده‌های عمومی کسب‌وکار شما استفاده می‌شوند و تنها از طریق REST API متریکس قابل ارسال هستند.

    توجه: رویدادهایی مانند “سفارش ارسال شد” (order_shipped) که با وجود تریگر شدن از سمت بک‌اند، مستقیماً به یک کاربر خاص و اقدامات او مرتبط هستند، بهتر است به عنوان Custom Event (در صورت امکان از طریق SDK/API مرتبط با کاربر) و با اتصال به Custom User ID در متریکس ارسال شوند تا به پروفایل همان کاربر مربوطه پیوند داده شوند. رویدادهای کسب‌وکار صرفاً برای رخدادهای سیستمی با تأثیر عمومی طراحی شده‌اند.


۲. ویژگی‌های رویداد (Event Attributes): جزئیات مهم

ویژگی‌های رویداد (Event Attributes) اطلاعات اضافی و متنی هستند که به یک رویداد خاص پیوست می‌شوند. آن‌ها به متریکس می‌گویند “چه چیزی” در مورد آن رویداد خاص است. بدون ویژگی‌ها، یک رویداد “خرید” فقط می‌گوید که خریدی انجام شده است، اما با ویژگی‌ها می‌توانید جزئیاتی مانند “چه محصولی”، “با چه قیمتی”، “در کدام دسته” و “چند عدد” خریداری شده است را ردیابی کنید.

  • اهمیت: ویژگی‌ها، داده‌های خام شما را قابل استفاده و تحلیل‌پذیر می‌کنند.
  • انواع داده: متریکس از انواع داده‌های مختلفی برای ویژگی‌ها پشتیبانی می‌کند، شامل String (متن)، Number (عدد صحیح یا اعشاری)، Boolean (درست/غلط) و Date (تاریخ).
  • بهترین شیوه‌ها برای Event Attributes:
    • نام‌گذاری سازگار: همیشه از نام‌های ثابت و معنی‌دار برای ویژگی‌های خود استفاده کنید (مثلاً product_name, category, price, quantity). نام‌گذاری ناسازگار، تحلیل داده‌ها را دشوار می‌کند.
    • حفظ حریم خصوصی: هرگز اطلاعات شناسایی‌کننده شخصی (PII) حساس مانند شماره کارت اعتباری، رمز عبور یا کدهای امنیتی را در ویژگی‌های رویداد ارسال نکنید.
    • فقط ضروریات: فقط اطلاعاتی را که واقعاً برای تحلیل یا فعال‌سازی نیاز دارید، ارسال کنید. ارسال بیش از حد ویژگی‌ها می‌تواند به پیچیدگی و افزایش حجم داده‌ها منجر شود.

۳. Taxonomy رویدادها: نقشه‌ی راه داده‌های شما

Taxonomy رویدادها در واقع نقشه راه شما برای جمع‌آآوری داده‌هاست. این یک سیستم استاندارد و سازمان‌یافته برای تعریف و نام‌گذاری تمام رویدادها و ویژگی‌های مرتبط با آن‌هاست که قصد دارید در متریکس ردیابی کنید. تدوین یک Taxonomy خوب، یک گام حیاتی قبل از شروع کدنویسی است.

  • چرا به Taxonomy نیاز دارید؟

    • سازگاری داده‌ها: اطمینان حاصل می‌کند که تمام تیم‌های شما (توسعه، محصول، بازاریابی) از یک زبان و تعریف واحد برای رویدادها استفاده می‌کنند.
    • تحلیل‌پذیری: داده‌های شما منظم و قابل درک خواهند بود، که تحلیل‌ها را بسیار ساده‌تر و دقیق‌تر می‌کند.
    • کاهش خطا: توسعه‌دهندگان دقیقاً می‌دانند چه رویدادهایی را با چه نام و چه ویژگی‌هایی باید ارسال کنند.
    • جلوگیری از آشفتگی: از ایجاد رویدادهای تکراری، نامنظم یا بی‌معنی که داشبورد شما را شلوغ می‌کنند، جلوگیری می‌کند.
  • عناصر یک Taxonomy خوب:

    • نام‌گذاری رویدادها: از یک الگوی ثابت برای نام‌گذاری استفاده کنید، مثلاً object_verb (user_signed_up, product_viewed).
    • تعریف ویژگی‌ها: برای هر رویداد، تمام ویژگی‌های مرتبط را همراه با نام، نوع داده، توضیح و یک مثال روشن مشخص کنید.
    • هدف و کاربرد: برای هر رویداد، هدف از ردیابی آن و اینکه کدام تیم‌ها یا بخش‌ها از آن استفاده خواهند کرد را مستند کنید.
  • همکاری: ایجاد یک Taxonomy مؤثر معمولاً نتیجه همکاری نزدیک بین تیم‌های محصول، بازاریابی، تحلیل و توسعه است.


۴. پیاده‌سازی و اعتبارسنجی

پس از برنامه‌ریزی دقیق Taxonomy خود، مرحله بعدی پیاده‌سازی رویدادها در کد شماست.

  • پیاده‌سازی: برای راهنمای دقیق نحوه ارسال رویدادها با استفاده از SDKها یا APIهای متریکس، به بخش راهنماهای فنی SDKs & APIs مراجعه کنید و دستورالعمل‌های مربوط به پلتفرم خود را دنبال نمایید.
  • اعتبارسنجی (Validation): پس از پیاده‌سازی، تست و اعتبارسنجی دقیق رویدادهای ارسالی بسیار مهم است. متریکس ابزارهایی را در پنل خود در بخش Onboarding فراهم می‌کند که به شما امکان می‌دهد داده‌های ورودی را مشاهده کرده و از صحت آن‌ها اطمینان حاصل کنید.

با درک این مفاهیم و برنامه‌ریزی دقیق Taxonomy رویدادهای خود، شما آماده‌اید تا با دقت و اثربخشی، داده‌های ارزشمندی را به متریکس ارسال کنید.

آخرین به روزرسانی در