ارسال ایونت (سرویس اتریبیوشن و اتومیشن)

هرگونه تعاملی که کاربر با وب‌سایت شما دارد، می‌تواند به‌عنوان یک رویداد(event) در داشبورد متریکس ثبت شود. متریکس این رویدادها را جمع‌آوری کرده و به‌صورت آماری در اختیار شما قرار می‌دهد.

برای ارسال ایونت‌ها به سرورهای متریکس، لازم است متد زیر را فراخوانی کنید.

 
newEvent(slug: string, customAttributes: {[key: string]: string}): void
 

با استفاده از متریکس، می‌توانید هرگونه رویداد یا رخدادی را در وب‌سایت خود ردیابی کنید.
بعنوان مثال فرض کنید قصد دارید کلیک کردن روی یک button در وبسایت خود را ردیابی نمایید. برای این منظور، ابتدا باید ایونت مخصوص به این رخداد را در قسمت مدیریت ایونت‌های داشبورد متریکس ایجاد نمایید. (Settings > Manage Events > Create event) سپس، از slug تولیدشده برای این رویداد، در کد وب‌سایت خود جهت ارسال ایونت استفاده کنید. بنابراین در متد onclick برای button مورد نظر خود باید متد newEvent متریکس را با slug ایونت ساخته شده و همچنین، به صورت دلخواه، همراه با تعدادی customAttribute به صورت زیر فراخوانی کنید:

// Send simple event
import { newEvent } from '@metrixorg/websdk';
newEvent('EVENT_SLUG');
 
// Send an event with custom attribute
const attributes = {};
attributes['first_name'] = 'Ali';
attributes['last_name'] = 'Bagheri';
attributes['manufacturer'] = 'Nike';
attributes['product_name'] = 'shirt';
attributes['type'] = 'sport';
attributes['size'] = 'large';
attributes['purchase_date'] = '2024-11-20T11:24:03.000Z'; // use ISO 8601 to consider this attribute as s a date
 
newEvent('EVENT_SLUG', attributes);

ساختن رویداد درآمدی (مختص سرویس اتریبیوشن)

با استفاده از این تابع می‌توانید یک رویداد درآمدی بسازید.برای این منظور، ابتدا وارد پنل متریکس شوید و از بخش مدیریت رویدادها، رویداد درآمدی موردنظر خود را ثبت نمایید. سپس نامک (slug) تولیدشده را به‌عنوان نام رویداد در اپلیکیشن خود مورد استفاده قرار دهید.

newRevenue('EVENT_SLUG', 12000, 'IRR');

ورودی‌های متد newRevenue بدین شرح هستند: