ارسال رویدادها
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 علامت است. |
* — پارامترهای اجباری.