ارسال رویدادها

SDK اجازه می دهد هر رویدادی را از قسمت سرور وب سایت خود به Finteza ارسال کنید ، از جمله داده های عملکرد کاربر ، وضعیت پایگاه داده ، شاخص های عملکرد و غیره. دستور Finteza.Tracker.SendEvent برای این موضوع فراهم شده است.

Finteza.Tracker.SendEvent("{EVENT}""REFERER");

با استفاده از این روش می توانید وقایع را ثبت کرده و اطلاعات اضافی را به عنوان پارامتر ، به عنوان مثال ، نوعی کالای خریداری شده ، قیمت ، ارز و غیره منتقل کنید. پارامترهای زیر پشتیبانی می شوند:

پارامتر

نوع

توصیف

name *

string

نام رویداد. حداکثر طول 128 کارکتر است.

referer *

string

آدرس صفحه ای که رویداد از آن ارسال می شود. همه رویدادها به پیشخوان ها (وب سایت ها) در سمت Finteza با استفاده از websiteIdوصل می شوند. سیستم این اطمینان را حاصل میکند که رویداد دریافت شده از میزبان موردنظر با پیشخوان میزبانی که در تنظیمات سایت در پنل Finteza) مشخص شده تطابق دارد. این از ترافیک تورمی جلوگیری میکند.

backReferer

string

آدرس یک صفحه وب که بازدید کننده قبل از اقدام پیگیری شده در آن قرار داشته است.

userIp

string

آدرس IP بازدید کننده ای که اقدام پیگیری شده ای را انجام داده است.

userAgent

string

نماینده کاربر بازدید کننده که اقدام پیگیری شده ای را انجام داده است.

unit

string

واحدهای اندازه گیری پارامتر ، به عنوان مثال ، USD ، اقلام و غیره حداکثر طول 32 حرف است.

value

string

مقدار پارامتر حداکثر طول 64 علامت است.

* — پارامترهای اجباری.

مثال:

Finteza.Tracker.SendEvent("Server Track Purchase""https://www.mysite.com""USD""100");

نیازی به تعیین پارامتر referer هر زمان رویداد ارسال میشود، نیست، اگر شما مقدار پیش فرض برای آن در بارگذاری اولیهتعیین کرده باشید. در خلال فراخوانی Finteza.RegisterAnalytics پارامتر اضافی defaultRefererرا مشخص نمائید:

Finteza.RegisterAnalytics(websiteId: "{WEBSITE_ID}", defaultReferer: "{DEFAULT_REFERER}");

توجه: اگر شما از defaultReferer,  استفاده نمیکنید، مقدار referer را هربار دستور SendEvent را فراخوانی میکنید، مشخص کنید. در غیر اینصورت رویداد ارسال نخواهد شد.


نحوه متفاوتی برای تابع Finteza.Tracker.SendEvent وجود دارد:

Finteza.Tracker.SendEvent({CONTEXT}"{EVENT}");

به جای مشخص کردن ضمنی پارامترهای referer, backReferer, userIp, userAgent, در اینجا محتوای اجرای درخواست از محلی که آنها به Finteza ارسال و یا از آن دریافت میشوند، مشخص می شود .

پارامتر

نوع

توصیف

httpContext *

System.Web.HttpContextBase or System.Web.HttpContext

محتوای اجرای درخواست HTTP فعلی که پارامترهای referer, backReferer, userIp and userAgent آن به صورت اتوماتیک تشکیل شده اند.

name *

string

نام رویداد. حداکثر طول 128 کارکتر است.

unit

string

واحدهای اندازه گیری پارامتر ، به عنوان مثال ، USD ، اقلام و غیره حداکثر طول 32 حرف است.

value

string

مقدار پارامتر حداکثر طول 64 علامت است.

* — پارامترهای اجباری.