Parameter Troli dan Item

Peristiwa dihantar boleh mengandungi parameter yang menerangkan produk atau parameter troli.

Tetapan Troli #

Parameter

Jenis

Penerangan

cart_id

string

ID Troli.

cart_items

number

Bilangan item dalam troli (produk unik)

currency

string

Mata wang bagi harga item dalam troli, ditunjukkan berserta cukai, diskaun dan kos penghantaran. Jika parameter tersebut tidak dinyatakan, mata wang "USD" akan dipaparkan dalam laporan.

value

number

Nilai bagi semua item dalam troli, termasuk cukai, diskaun dan kos penghantaran. Dalam kata lain, ini ialah amaun yang dibayar oleh pembeli untuk pembelian tersebut. Ditunjukkan dalam bentuk nilai wang.

profit

number

Keuntungan bersih untuk penjual hasil jualan semua item dalam troli tersebut. Ditunjukkan dalam bentuk nilai wang. Mata wang pengiraan yang digunakan merujuk "currency".

transaction_fee

number

Yuran transaksi (komisyen sistem pembayaran) untuk pembelian bagi semua item daripada troli. Ditunjukkan dalam bentuk nilai wang. Mata wang pengiraan yang digunakan merujuk "currency".

transaction_id

string

ID bagi transaksi berkaitan pembayaran untuk item dalam troli.

affiliation

string

Gedung atau cawangan di mana transaksi tersebut dilakukan.

detail

string

Butiran ralat pembelian atau sebab bayaran balik. Medan tersebut juga boleh digunakan jika pembelian berjaya (Checkout Success) untuk memberikan sebarang butiran tambahan.

tax_value

number

Jumlah cukai untuk semua item dalam troli dalam bentuk nilai wang. Mata wang pengiraan yang digunakan merujuk "currency".

tax_name

string

Nama cukai.

tax_type

string

Jenis cukai.

discount_value

number

Jumlah amaun diskaun untuk semua item dalam troli dalam bentuk nilai wang. Mata wang pengiraan yang digunakan merujuk "currency".

discount_name

string

Nama diskaun.

discount_type

string

Jenis diskaun.

shipping_value

number

Jumlah kos penghantaran semua item dalam troli dalam bentuk nilai wang. Mata wang pengiraan yang digunakan merujuk "currency".

shipping_name

string

Nama perkhidmatan penghantaran.

shipping_type

string

Jenis penghantaran.

checkout_step

number

Nombor langkah semasa pelanggan. Anda memberikan nombor ini sendiri, mengikut turutan peristiwa Mula Daftar Keluar, Kemajuan DAftar Keluar dan peristiwa Daftar Keluar Berjaya

checkout_option

string

Pilihan pembayaran troli.

buyer

string

Nama atau ID pembeli. Sebagai contoh, log masuk pengguna dalam laman web anda. Parameter ini digunakan untuk menjana laporan bagi pembeli tertinggi. Laporan sedemikian berguna jika produk oleh banyak penjual pihak ketiga ditampilkan pada laman anda.

seller

string

Nama atau ID penjual. Sebagai contoh, log masuk pengguna dalam laman web anda. Parameter ini digunakan untuk menjana laporan bagi penjual tertinggi. Laporan sedemikian berguna jika produk oleh banyak penjual pihak ketiga ditampilkan pada laman anda.

Tetapan produk #

Parameter

Jenis

Penerangan

id *

string

Unit Penyimpanan Stok (SKU)

name *

string

Nama item.

brand

string

Jenama item.

category

string

Kategori item. Sebagai contoh, "Clothes" atau "Smartphones".

variant

string

Varian item: warna, model, dll.

quantity

number

Kuantiti item.

currency

string

Mata wang yang digunakan untuk menyatakan nilai harga item, di samping cukai, diskaun serta kos penghantaran. Jika parameter tersebut tidak dinyatakan, mata wang "USD" akan dipaparkan dalam laporan.

price

number

Nilai item.

value

number

Nilai bersih item dalam bentuk nilai wang, termasuk cukai, diskaun dan kos penghantaran: price + tax_value + shipping_value + transaction_fee - discount_value. Dalam kata lain, ini ialah amaun yang dibayar oleh pembeli untuk item tersebut. Ditunjukkan dalam bentuk nilai wang.

profit

number

Untung bersih penjual hasil jualan item tersebut. Ditunjukkan dalam bentuk nilai wang. Mata wang pengiraan yang digunakan merujuk "currency".

transaction_fee

number

Yuran transaksi bagi pembelian item tersebut. Ditunjukkan dalam bentuk nilai wang. Mata wang pengiraan yang digunakan merujuk "currency".

list_name

string

Nama senarai di mana item tersebut dipaparkan kepada pengguna. Sebagai contoh, Senarai Harga.

list_position

number

Kedudukan item tersebut dalam senarai yang dinyatakan dalam list_name.

tax_value

number

Cukai item dalam bentuk nilai wang. Mata wang pengiraan yang digunakan merujuk "currency".

tax_name

string

Nama cukai.

tax_type

string

Jenis cukai.

discount_value

number

Diskaun untuk item tersebut dalam bentuk nilai wang. Mata wang pengiraan yang digunakan merujuk "currency".

discount_name

string

Nama diskaun.

discount_type

string

Jenis diskaun.

shipping_value

number

Kod penghantaran item tersebut dalam bentuk nilai wang. Mata wang pengiraan yang digunakan merujuk "currency".

shipping_name

string

Nama perkhidmatan penghantaran.

shipping_type

string

Jenis penghantaran.

* – parameter diperlukan.