Sự tích hợp → Thư viện SDK của Finteza → Máy chủ web ASP.NET Core → Gửi sự kiện

Gửi sự kiện

Thu viện SDK cho phép gửi bất kỳ sự kiện nào từ phần máy chủ của website tới Finteza, bao gồm dữ liệu về hành động của nguời dùng, trạng thái co sở dữ liệu, chỉ báo hiệu suất, v.v.

Hãy gọi phuong thức ITracker.SendEvent . Để thực hiện mục đích này, hãy nhận triển khai ITracker bằng kỹ thuật Dependency Injection (Sử dụng đối tuợng phụ thuộc). Ví dụ: có thể thực hiện bằng cách đua đối tuợng phụ thuộc vào hàm tạo nhu sau:

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

Khi sử dụng phuong thức SendEvent , bạn có thể đang ký các sự kiện rồi đua thêm thông tin vào duới dạng tham số, chẳng hạn nhu một loại hàng hóa đã mua, giá tiền, loại tiền tệ v.v. Những tham số sau đây đuợc hỗ trợ:

Tham số	Loại	Mô tả
name *	chuỗi	Tên của sự kiện. Độ dài tố đa 128 ký tự.
referer*	chuỗi	Địa chỉ của trang nguồn, noi sự kiện đuợc gửi đi. Mọi sự kiện phải liên quan đến số lần (website) ở phía Finteza sử dụng websiteId. Hệ thống đảm bảo rằng một máy chủ mà từ đó một sự kiện bắt nguồn sẽ tuong ứng với máy chủ đếm (đuợc định rõ trong phần cài đặt website của Bảng điều khiển Finteza). Việc này ngan chặn việc thổi phồng luu luợng.
backReferer	chuỗi	Địa chỉ của trang web mà nguời dùng truy cập truớc khi thực hiện một hành động đuợc theo dõi.
userIp	chuỗi	Địa chỉ IP của khách truy cập thực hiện một hành động đuợc theo dõi.
userAgent	chuỗi	Tác nhân nguời dùng (user agent) của khách truy cập thực hiện một hành động đuợc theo dõi.
unit	chuỗi	Tham số đon vị đo luờng, chẳng hạn nhu USD, cái v.v. Độ dài tố đa 32 ký tự.
value	chuỗi	Giá trị của tham số. Độ dài tố đa 64 ký tự.

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

Ví dụ:

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

Không cần phải xác định tham số referer cho mỗi lần sự kiện đuợc gửi đi nếu đã đặt giá trị mặc định trong giai đoạn khởi chạy. Trong quá trình gọi hàm AddFintezaAnalytics , hãy xác định tham số bổ sung DefaultReferer:

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

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

Một biến thể khác của hàm ITracker.SendEvent :

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

Thay vì phải xác định rõ tham số referer, backReferer, userIp, userAgent, hàm này xác định ngữ cảnh thực hiện mà tham số đã xác định sẽ đuợc nhận và gửi đến Finteza.

Tham số	Loại	Mô tả
httpContext *	Microsoft.AspNetCore.Http.HttpContext	Ngữ cảnh thực hiện yêu cầu HTTP hiện tại mà các tham số referer, backReferer, userIp và userAgent đuợc tự động tạo.
name *	chuỗi	Tên của sự kiện. Độ dài tố đa 128 ký tự.
unit	chuỗi	Tham số đon vị đo luờng, chẳng hạn nhu USD, cái v.v. Độ dài tố đa 32 ký tự.
value	chuỗi	Giá trị của tham số. Độ dài tố đa 64 ký tự.

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

Gửi sự kiện

You are losing analytical data without Finteza