Menghantar peristiwa

SDK tersebut membolehkan penghantaran sebarang peristiwa daripada bahagian pelayan laman web anda kepada Finteza, termasuk data tindakan pengguna, status pangkalan data, penunjuk prestasi, dll.

Panggil ITracker.SendEvent kaedah. Bagi tujuan ini, dapatkan pelaksanaan ITracker menggunakan Suntikan Pergantungan. Sebagai contoh, ini boleh dilakukan menggunakan suntikan berikut ke dalam pembina:

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

Menggunakan kaedah SendEvent , anda boleh mendaftarkan peristiwa dan memberikan maklumat tambahan sebagai parameter, sebagai contoh, jenis barangan dibeli, harga, mata wang, dll. Parameter berikut disokong:

Parameter	Jenis	Butiran
nama *	string	Nama peristiwa. Panjang maksimum ialah 128 simbol.
referer *	string	Alamat halaman di mana peristiwa tersebut dihantar. Semua peristiwa terikat kepada kaunter (laman web) di sisi Finteza menggunakan websiteId. Sistem memastikan hos asal peristiwa adalah sama dengan hos kaunter (dinyatakan dalam tetapan pada panel Finteza). Ini mencegah trafik yang melambung.
backReferer	string	Alamat lokasi pelawat laman web sebelum menjalankan tindakan dijejak.
userIp	string	Alamat IP pelawat yang menjalankan tindakan dijejak.
userAgent	string	Ejen-pengguna bagi pelawat yang menjalankan tindakan dijejak.
unit	string	Unit ukuran parameter, contohnya, USD, item, dll. Panjang maksimum ialah 32 aksara.
value	string	Nilai parameter tersebut. Panjang maksimum ialah 64 simbol.

* – parameter diperlukan.

Contoh:

tracker.SendEvent("Pembelian Jejak Pelayan", "https://www.mysite.com", "USD", "100");

Tiada keperluan untuk menyatakan referer parameter setiap kali peristiwa dihantar, jika anda menetapkan nilai lalai ini sewaktu permulaan. Sewaktu AddFintezaAnalytics panggilan, nyatakan parameter tambahan DefaultReferer:

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

Nota: Jika anda tidak menggunakan DefaultReferer, nyatakan perujuk sewaktu setiap SendEvent panggilan. Jika tidak, peristiwa tersebut tidak akan dihantar.

Varian lain tersedia untuk ITracker.SendEvent function:

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

Daripada menyatakan secara jelas referer, backReferer, userIp, userAgent, di sini konteks pelaksanaan permintaan dinyatakan, yang menjadi punca penerimaan paramater yang dinyatakan dan dihantar kepada Finteza.

Parameter	Jenis	Butiran
httpContext *	Microsoft.AspNetCore.Http.HttpContext	Konteks pelaksanaan permintaan HTTP semasa, daripada mana parameter referer, backReferer, userIp dan userAgent dicipta secara automatik.
nama *	string	Nama peristiwa. Panjang maksimum ialah 128 simbol.
unit	string	Unit ukuran parameter, contohnya, USD, item, dll. Panjang maksimum ialah 32 aksara.
value	string	Nilai parameter tersebut. Panjang maksimum ialah 64 simbol.

* – parameter diperlukan.