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

ردیابی ایونت ها و 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 ایونت های خود، شما آماده‌اید تا با دقت و اثربخشی، داده‌های ارزشمندی را به متریکس ارسال کنید.

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