Cart and Item Parameters

Sent events can contain parameters describing product or cart parameters.

Cart Properties #

Parameter

Type

Description

cart_id

string

Cart ID.

cart_items

number

The number of items in the cart (unique products).

currency

string

The currency in which the price of items in the cart, as well as taxes, discounts and shipping costs are indicated. If the parameter is not specified, the currency will be displayed as "USD" in the report.

value

number

The value of all items in the cart, including taxes, discounts and shipping costs. In other words, this is the amount which the buyer paid for the purchase. Indicated in money.

profit

number

The seller's net profit from selling all items in the cart. Indicated in money. The calculation currency is used in accordance with "currency".

transaction_fee

number

Transaction fee (payment system commission) for the purchase of all items from the cart. Indicated in money. The calculation currency is used in accordance with "currency".

transaction_id

string

The ID of the transaction related to the payment for the items in the cart.

affiliation

string

The store or branch in which the transaction was performed.

detail

string

Details of the purchase error or the reason for the refund. The field can also be used in case of a successful purchase (Checkout Success) to provide any additional details.

tax_value

number

The total tax for all items in the cart in money. The calculation currency is used in accordance with "currency".

tax_name

string

Tax name.

tax_type

string

Tax type.

discount_value

number

The total discount amount for all items in the cart in money. The calculation currency is used in accordance with "currency".

discount_name

string

Discount name.

discount_type

string

Discount type.

shipping_value

number

The total shipping cost of all items in the cart in money. The calculation currency is used in accordance with "currency".

shipping_name

string

Delivery service name.

shipping_type

string

Shipping type.

checkout_step

number

The number of a step the customer is currently at. You number these steps yourself, according to the Checkout Begin, Checkout Progress and Checkout Success events

checkout_option

string

Cart payment option.

buyer

string

Buyer's name or ID. For example, user login in your website. This parameter is used for generating reports on top buyers. Such reports are useful if products by many third-party sellers are featured on your sites.

seller

string

Seller's name or ID. For example, user login in your website. This parameter is used for generating reports on top sellers. Such reports are useful if products by many third-party sellers are featured on your sites.

Product properties #

Parameter

Type

Description

id *

string

Stock Keeping Unit (SKU).

name *

string

Item name.

brand

string

Item brand.

category

string

Item category. For example, "Clothes" or "Smartphones".

variant

string

Item variant: color, model, etc.

quantity

number

Item quantity.

currency

string

The currency in which the item price, as well as taxes, discounts and shipping costs are indicated. If the parameter is not specified, the currency will be displayed as "USD" in the report.

price

number

Item value.

value

number

Net item value in money, including taxes, discount and shipping costs: price + tax_value + shipping_value + transaction_fee - discount_value. In other words, this is the amount which the buyer paid for the item. Indicated in money.

profit

number

The seller's net profit from selling the item. Indicated in money. The calculation currency is used in accordance with "currency".

transaction_fee

number

Transaction fee for the purchase of the item. Indicated in money. The calculation currency is used in accordance with "currency".

list_name

string

The name of the list in which the item was presented to the user. For example, Price List.

list_position

number

The position of the item in the list specified in list_name.

tax_value

number

The item tax in money. The calculation currency is used in accordance with "currency".

tax_name

string

Tax name.

tax_type

string

Tax type.

discount_value

number

The discount for the item in money. The calculation currency is used in accordance with "currency".

discount_name

string

Discount name.

discount_type

string

Discount type.

shipping_value

number

The item shipping cost in money. The calculation currency is used in accordance with "currency".

shipping_name

string

Delivery service name.

shipping_type

string

Shipping type.

* – required parameters.