Mengirim peristiwa

SDK memungkinkan pengiriman peristiwa apapun dari bagian server situs web anda ke Finteza, termasuk data tindakan pengguna, status basis data, indikator kinerja, dll.

Panggil metode ITracker.SendEvent. Untuk tujuan ini, dapatkan implementasi ITracker menggunakan Injeksi Dependensi. Misalnya, ini bisa dilakukan dengan menggunakan injeksi berikut ke dalam konstruktor:

class SomeClass
{
    public SomeClass(ITracker tracker)
    {
        tracker.SendEvent("{EVENT}", "{REFERER}");
    }
}

Dengan menggunakan metode SendEvent, anda dapat mendaftarkan peristiwa dan meneruskan informasi tambahan sebagai parameter, misalnya, jenis barang yang dibeli, harga, mata uang, dll. Parameter berikut ini didukung:

Parameter	Jenis	Deskripsi
name *	string	Nama peristiwa. Panjang maksimum 128 simbol.
referer*	string	Alamat halaman tempat peristiwa dikirim. Semua peristiwa terikat ke counter (situs web) di sisi Finteza menggunakan websiteId. Sistem memastikan bahwa host tempat peristiwa telah datang sesuai dengan host penghitung (ditentukan dalam pengaturan situs web dari panel Finteza). Ini mencegah peningkatan trafik.
backReferer	string	Alamat halaman web tempat pengunjung berada sebelum melakukan tindakan yang terlacak.
userIp	string	Alamat IP pengunjung yang melakukan tindakan terlacak.
userAgent	string	Agen pengguna pengunjung yang melakukan tindakan terlacak.
unit	string	Satuan pengukuran parameter, misalnya USD, item, dll. Panjang maksimum adalah 32 karakter.
value	string	Nilai parameter. Panjang maksimum 64 simbol.

* - parameter yang diperlukan.

Contoh:

tracker.SendEvent("Server Track Purchase", "https://www.mysite.com", "USD", "100");

Tidak perlu menentukan parameter referer setiap kali peristiwa dikirim, jika anda mengatur nilai defaultnya selama inisialisasi. Selama panggilan AddFintezaAnalytics, tentukan parameter tambahan DefaultReferer:

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

Catatan:Jika anda tidak menggunakanDefaultReferer, tentukan referer selama setiap panggilan SendEvent. Jika tidak, peristiwa tidak akan dikirim.

Varian lain tersedia untuk fungsi ITracker.SendEvent:

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

Alih-alih spesifikasi eksplisit referer, backReferer , userIp , userAgent, di sini konteks eksekusi permintaan ditentukan, darimana parameter yang ditentukan akan diterima dan dikirim ke Finteza.

Parameter	Jenis	Deskripsi
httpContext *	Microsoft.AspNetCore.Http.HttpContext	Konteks eksekusi permintaan HTTP saat ini, darimana parameter referer, backReferer, <t5 >userIp dan userAgent otomatis terbentuk.
name *	string	Nama peristiwa. Panjang maksimum 128 simbol.
unit	string	Satuan pengukuran parameter, misalnya USD, item, dll. Panjang maksimum adalah 32 karakter.
value	string	Nilai parameter. Panjang maksimum 64 simbol.

* - parameter yang diperlukan.