Gửi sự kiện

Thu viện SDK cho phep gửi bất kỳ sự kiện nao từ phần may chủ của website tới Finteza, bao gồm dữ liệu về hanh động của nguời dung, trạng thai co sở dữ liệu, chỉ bao hiệu suất, v.v.

Hãy gọi phuong thức ITracker.SendEvent . Dể thực hiện mục đich nay, hãy nhận triển khai ITracker bằng kỹ thuật Dependency Injection (Sử dụng đối tuợng phụ thuộc). Vi dụ: co thể thực hiện bằng cach đua đối tuợng phụ thuộc vao ham tạo nhu sau:

classSomeClass
{
    publicSomeClass(ITrackertracker)
    {
        tracker.SendEvent("{EVENT}", "{REFERER}");
    }
}

Khi sử dụng phuong thức SendEvent , bạn co thể đang ký cac sự kiện rồi đua them thong tin vao duới dạng tham số, chẳng hạn nhu một loại hang hoa đã mua, gia tiền, loại tiền tệ v.v. Những tham số sau đay đuợc hỗ trợ:

Tham số	Loại	Mo tả
name *	chuỗi	Ten của sự kiện. Dộ dai tố đa 128 ký tự.
referer*	chuỗi	Dịa chỉ của trang nguồn, noi sự kiện đuợc gửi đi. Mọi sự kiện phải lien quan đến số lần (website) ở phia Finteza sử dụng websiteId. Hệ thống đảm bảo rằng một may chủ ma từ đo một sự kiện bắt nguồn sẽ tuong ứng với may chủ đếm (đuợc định rõ trong phần cai đặt website của Bảng điều khiển Finteza). Việc nay ngan chặn việc thổi phồng luu luợng.
backReferer	chuỗi	Dịa chỉ của trang web ma nguời dung truy cập truớc khi thực hiện một hanh động đuợc theo dõi.
userIp	chuỗi	Dịa chỉ IP của khach truy cập thực hiện một hanh động đuợc theo dõi.
userAgent	chuỗi	Tac nhan nguời dung (user agent) của khach truy cập thực hiện một hanh động đuợc theo dõi.
unit	chuỗi	Tham số đon vị đo luờng, chẳng hạn nhu USD, cai v.v. Dộ dai tố đa 32 ký tự.
value	chuỗi	Gia trị của tham số. Dộ dai tố đa 64 ký tự.

* — tham số bắt buộc.

Vi dụ:

tracker.SendEvent("May chủ theo dõi luợt mua", "https://www.mysite.com", "USD", "100");

Khong cần phải xac định tham số referer cho mỗi lần sự kiện đuợc gửi đi nếu đã đặt gia trị mặc định trong giai đoạn khởi chạy. Trong qua trình gọi ham AddFintezaAnalytics , hãy xac định tham số bổ sung DefaultReferer:

services.AddFintezaAnalytics(options =>
{
options.WebsiteId = "{WEBSITE_ID}";
options.DefaultReferer = "{DEFAULT_REFERER}";
...
});

Luu ý: Nếu bạn khong sử dụng tham số DefaultReferer, hãy xac định tham số referer mỗi lần gọi ham SendEvent . Nếu khong, sự kiện sẽ khong đuợc gửi đi.

Một biến thể khac của ham ITracker.SendEvent :

tracker.SendEvent({CONTEXT}, "{EVENT}");

Thay vì phải xac định rõ tham số referer, backReferer, userIp, userAgent, ham nay xac định ngữ cảnh thực hiện ma tham số đã xac định sẽ đuợc nhận va gửi đến Finteza.

Tham số	Loại	Mo tả
httpContext *	Microsoft.AspNetCore.Http.HttpContext	Ngữ cảnh thực hiện yeu cầu HTTP hiện tại ma cac tham số referer, backReferer, userIp va userAgent đuợc tự động tạo.
name *	chuỗi	Ten của sự kiện. Dộ dai tố đa 128 ký tự.
unit	chuỗi	Tham số đon vị đo luờng, chẳng hạn nhu USD, cai v.v. Dộ dai tố đa 32 ký tự.
value	chuỗi	Gia trị của tham số. Dộ dai tố đa 64 ký tự.

* — tham số bắt buộc.