Gửi sự kiện

Thu viện SDK cho phep gửi bất kỳ sự kiện nao từ phần may chủ của website tới Finteza, bao gồm dữ liệu về hanh động của nguời dung, trạng thai co sở dữ liệu, chỉ bao hiệu suất, v.v.

Hãy gọi phuong thức ITracker.SendEvent . Dể thực hiện mục đich nay, hãy nhận triển khai ITracker bằng kỹ thuật Dependency Injection (Sử dụng đối tuợng phụ thuộc). Vi dụ: co thể thực hiện bằng cach đua đối tuợng phụ thuộc vao ham tạo nhu sau:

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

 

Khi sử dụng phuong thức SendEvent , bạn co thể đang ký cac sự kiện rồi đua them thong tin vao duới dạng tham số, chẳng hạn nhu một loại hang hoa đã mua, gia tiền, loại tiền tệ v.v. Những tham số sau đay đuợc hỗ trợ:

Tham số

Loại

Mo tả

name *

chuỗi

Ten của sự kiện. Dộ dai tố đa 128 ký tự.

referer*

chuỗi

Dịa chỉ của trang nguồn, noi sự kiện đuợc gửi đi. Mọi sự kiện phải lien quan đến số lần (website) ở phia Finteza sử dụng websiteId. Hệ thống đảm bảo rằng một may chủ ma từ đo một sự kiện bắt nguồn sẽ tuong ứng với may chủ đếm (đuợc định rõ trong phần cai đặt website của Bảng điều khiển Finteza). Việc nay ngan chặn việc thổi phồng luu luợng.

backReferer

chuỗi

Dịa chỉ của trang web ma nguời dung truy cập truớc khi thực hiện một hanh động đuợc theo dõi.

userIp

chuỗi

Dịa chỉ IP của khach truy cập thực hiện một hanh động đuợc theo dõi.

userAgent

chuỗi

Tac nhan nguời dung (user agent) của khach truy cập thực hiện một hanh động đuợc theo dõi.

unit

chuỗi

Tham số đon vị đo luờng, chẳng hạn nhu USD, cai v.v. Dộ dai tố đa 32 ký tự.

value

chuỗi

Gia trị của tham số. Dộ dai tố đa 64 ký tự.

 

* — tham số bắt buộc.

Vi dụ:

tracker.SendEvent("May chủ theo dõi luợt mua""https://www.mysite.com""USD""100");

 

Khong cần phải xac định tham số referer cho mỗi lần sự kiện đuợc gửi đi nếu đã đặt gia trị mặc định trong giai đoạn khởi chạy. Trong qua trình gọi ham AddFintezaAnalytics , hãy xac định tham số bổ sung DefaultReferer:

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

 

Luu ý: Nếu bạn khong sử dụng tham số DefaultReferer, hãy xac định tham số referer mỗi lần gọi ham SendEvent . Nếu khong, sự kiện sẽ khong đuợc gửi đi.


 

Một biến thể khac của ham ITracker.SendEvent :

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

 

Thay vì phải xac định rõ tham số referer, backReferer, userIp, userAgent, ham nay xac định ngữ cảnh thực hiện ma tham số đã xac định sẽ đuợc nhận va gửi đến Finteza.

Tham số

Loại

Mo tả

httpContext *

Microsoft.AspNetCore.Http.HttpContext

Ngữ cảnh thực hiện yeu cầu HTTP hiện tại ma cac tham số referer, backReferer, userIp va userAgent đuợc tự động tạo.

name *

chuỗi

Ten của sự kiện. Dộ dai tố đa 128 ký tự.

unit

chuỗi

Tham số đon vị đo luờng, chẳng hạn nhu USD, cai v.v. Dộ dai tố đa 32 ký tự.

value

chuỗi

Gia trị của tham số. Dộ dai tố đa 64 ký tự.

 

* — tham số bắt buộc.