Introduction

note

The ecommerce section is still in beta , missing the final touches for official publication.

In the ecommerce section of Vantevo you can monitor specific actions affecting your ecommerce website and the sources of traffic that lead to sales. This can help you optimize your website and marketing campaigns to increase your profitability.

How to add ecommerce monitoring script

The code for the Vantevo Analytics ecommerce monitoring script will look as follows, in order for the script to work you must also have entered the standard monitoring code.

<script defer id="vantevo-analytics-ecommerce" src="https://vantevo.io/js/vantevo-ecommerce.js"></script>
<script>
  window.vantevo_ecommerce = window.vantevo_ecommerce || function() {(window.vantevo_ecommerce.data = window.vantevo_ecommerce.data || [])};
</script>

Parameters for advanced measurements

The advanced parameters available are:

data-param-dev
data-param-domain
data-param-api

Learn more about parameters-for-advanced-measurements.

Events List

These are the events to use to monitor your ecommerce.

Event	Description
`add_to_wishlist`	a user adds a product to the favorites list
`view_item`	a user views a product
`remove_item_cart`	a user removes a product from the cart
`add_item_cart`	a user adds product to the cart
`start_checkout`	a user has started the checkout process
`checkout_info`	a user submits personal data
`checkout_ship`	a user submits shipments data
`checkout_payment`	a user initiated the payment process
`purchase`	a user has completed a purchase

add_to_wishlist

This event indicates that a user has added a product to the wishlist

*Parameters

Option	Type	Description
items	`array` (Required)	The product information

Product parameters

Option	Type	Example	Description
item_id	`string` (Required)	SKU_1234	Product ID (SKU)
item_name	`string` (Required)	Samsung Galaxy	Product name / title
currency	`string` (Optional)	USD	Indicates the currency used. The format to use is: ISO 4217. If no currency is entered Vantevo will use the default currency selected in the domain settings. Check the list of available currencies.
quantity	`number` (Optional)	1	Product quantity. Default 1.
price	`number` (Optional)	199.90	Product price. Default 0.
discount	`number` (Optional)	20.20	The value of the discount associated with the product. Default 0.
position	`number` (Optional)	1	The position of the product in a list. Default 1.
brand	`string` (Optional)	Samsung	The brand of the product.
category_1	`string` (Optional)	Smartphone	Category 1 of the product.
category_2	`string` (Optional)	Samsung	Category 2 of the product.
category_3	`string` (Optional)	Galaxy	Category 3 of the product.
category_4	`string` (Optional)	Smart	Category 4 of the product.
category_5	`string` (Optional)	Large	Category 5 of the product.
variant_1	`string` (Optional)	black	Variant 2 of the product.
variant_2	`string` (Optional)	5.5 inch	Variant 3 of the product.
variant_3	`string` (Optional)	100 g	Variant 4 of the product.

Esempio

<script>
    window.vantevo_ecommerce("add_to_wishlist", {
        "items": [
         {
            'item_id': "SKU_123",
            'item_name': "Samsung Galaxy",
            'currency': "EUR",
            'quantity': 1,
            'price': 199.99,
            'discount': 0,
            'position': 1,
            'brand': "Samsung",
            'category_1': "Smartphone",
            'category_2': "Samsung",
            'category_3': "Galaxy",
            'category_4': "",
            'category_5': "",
            'variant_1': "Black",
            'variant_2': "5.5 inch",
            'variant_3': ""
        }
      ] 
  });
</script>

view_item

This event indicates that a user has viewed a product

*Parameters

Option	Type	Description
items	`array` (Required)	The product information

Product parameters

Option	Type	Example	Description
item_id	`string` (Required)	SKU_1234	Product ID (SKU)
item_name	`string` (Required)	Samsung Galaxy	Product name / title
currency	`string` (Optional)	USD	Indicates the currency used. The format to use is: ISO 4217. If no currency is entered Vantevo will use the default currency selected in the domain settings. Check the list of available currencies.
quantity	`number` (Optional)	1	Product quantity. Default 1.
price	`number` (Optional)	199.90	Product price. Default 0.
discount	`number` (Optional)	20.20	The value of the discount associated with the product. Default 0.
position	`number` (Optional)	1	The position of the product in a list. Default 1.
brand	`string` (Optional)	Samsung	The brand of the product.
category_1	`string` (Optional)	Smartphone	Category 1 of the product.
category_2	`string` (Optional)	Samsung	Category 2 of the product.
category_3	`string` (Optional)	Galaxy	Category 3 of the product.
category_4	`string` (Optional)	Smart	Category 4 of the product.
category_5	`string` (Optional)	Large	Category 5 of the product.
variant_1	`string` (Optional)	black	Variant 2 of the product.
variant_2	`string` (Optional)	5.5 inch	Variant 3 of the product.
variant_3	`string` (Optional)	100 g	Variant 4 of the product.

Esempio

<script>
    window.vantevo_ecommerce("view_item", {
        "items": [
         {
            'item_id': "SKU_123",
            'item_name': "Samsung Galaxy",
            'currency': "EUR",
            'quantity': 1,
            'price': 199.99,
            'discount': 0,
            'position': 1,
            'brand': "Samsung",
            'category_1': "Smartphone",
            'category_2': "Samsung",
            'category_3': "Galaxy",
            'category_4': "",
            'category_5': "",
            'variant_1': "Black",
            'variant_2': "5.5 inch",
            'variant_3': ""
        }
      ] 
  });
</script>

remove_item_cart

This event indicates that a user has removed a product from the shopping cart

*Parameters

Option	Type	Description
items	`array` (Required)	The product information

Product parameters

Option	Type	Example	Description
item_id	`string` (Required)	SKU_1234	Product ID (SKU)
item_name	`string` (Required)	Samsung Galaxy	Product name / title
currency	`string` (Optional)	USD	Indicates the currency used. The format to use is: ISO 4217. If no currency is entered Vantevo will use the default currency selected in the domain settings. Check the list of available currencies.
quantity	`number` (Optional)	1	Product quantity. Default 1.
price	`number` (Optional)	199.90	Product price. Default 0.
discount	`number` (Optional)	20.20	The value of the discount associated with the product. Default 0.
position	`number` (Optional)	1	The position of the product in a list. Default 1.
brand	`string` (Optional)	Samsung	The brand of the product.
category_1	`string` (Optional)	Smartphone	Category 1 of the product.
category_2	`string` (Optional)	Samsung	Category 2 of the product.
category_3	`string` (Optional)	Galaxy	Category 3 of the product.
category_4	`string` (Optional)	Smart	Category 4 of the product.
category_5	`string` (Optional)	Large	Category 5 of the product.
variant_1	`string` (Optional)	black	Variant 2 of the product.
variant_2	`string` (Optional)	5.5 inch	Variant 3 of the product.
variant_3	`string` (Optional)	100 g	Variant 4 of the product.

Esempio

<script>
    window.vantevo_ecommerce("remove_item_cart", {
        "items": [
         {
            'item_id': "SKU_123",
            'item_name': "Samsung Galaxy",
            'currency': "EUR",
            'quantity': 1,
            'price': 199.99,
            'discount': 0,
            'position': 1,
            'brand': "Samsung",
            'category_1': "Smartphone",
            'category_2': "Samsung",
            'category_3': "Galaxy",
            'category_4': "",
            'category_5': "",
            'variant_1': "Black",
            'variant_2': "5.5 inch",
            'variant_3': ""
        }
      ] 
  });
</script>

add_item_cart

This event indicates that a user has added a product to the shopping cart

*Parameters

Option	Type	Description
items	`array` (Required)	The product information

Product parameters

Option	Type	Example	Description
item_id	`string` (Required)	SKU_1234	Product ID (SKU)
item_name	`string` (Required)	Samsung Galaxy	Product name / title
currency	`string` (Optional)	USD	Indicates the currency used. The format to use is: ISO 4217. If no currency is entered Vantevo will use the default currency selected in the domain settings. Check the list of available currencies.
quantity	`number` (Optional)	1	Product quantity. Default 1.
price	`number` (Optional)	199.90	Product price. Default 0.
discount	`number` (Optional)	20.20	The value of the discount associated with the product. Default 0.
position	`number` (Optional)	1	The position of the product in a list. Default 1.
brand	`string` (Optional)	Samsung	The brand of the product.
category_1	`string` (Optional)	Smartphone	Category 1 of the product.
category_2	`string` (Optional)	Samsung	Category 2 of the product.
category_3	`string` (Optional)	Galaxy	Category 3 of the product.
category_4	`string` (Optional)	Smart	Category 4 of the product.
category_5	`string` (Optional)	Large	Category 5 of the product.
variant_1	`string` (Optional)	black	Variant 2 of the product.
variant_2	`string` (Optional)	5.5 inch	Variant 3 of the product.
variant_3	`string` (Optional)	100 g	Variant 4 of the product.

Esempio

<script>
    window.vantevo_ecommerce("add_item_cart", {
        "items": [
         {
            'item_id': "SKU_123",
            'item_name': "Samsung Galaxy",
            'currency': "EUR",
            'quantity': 1,
            'price': 199.99,
            'discount': 0,
            'position': 1,
            'brand': "Samsung",
            'category_1': "Smartphone",
            'category_2': "Samsung",
            'category_3': "Galaxy",
            'category_4': "",
            'category_5': "",
            'variant_1': "Black",
            'variant_2': "5.5 inch",
            'variant_3': ""
        }
      ] 
  });
</script>

start_checkout

This event indicates that a user has initiated the checkout process

*Parameters

Option	Type	Description
items	`array` (Required)	The product information
total	`number` (Optional)	The total amount of the order Example: `1255.00`
coupon	`string` (Optional)	The name of the coupon used. Example: `newsletter`
coupon_value	`number` (Optional)	The value of the coupon used. Example: `45.00`
payment_type	`string` (Optional)	The mode of payment. Example: `Payal` o `Carta di credito`.

Product parameters

Option	Type	Example	Description
item_id	`string` (Required)	SKU_1234	Product ID (SKU)
item_name	`string` (Required)	Samsung Galaxy	Product name / title
currency	`string` (Optional)	USD	Indicates the currency used. The format to use is: ISO 4217. If no currency is entered Vantevo will use the default currency selected in the domain settings. Check the list of available currencies.
quantity	`number` (Optional)	1	Product quantity. Default 1.
price	`number` (Optional)	199.90	Product price. Default 0.
discount	`number` (Optional)	20.20	The value of the discount associated with the product. Default 0.
position	`number` (Optional)	1	The position of the product in a list. Default 1.
brand	`string` (Optional)	Samsung	The brand of the product.
category_1	`string` (Optional)	Smartphone	Category 1 of the product.
category_2	`string` (Optional)	Samsung	Category 2 of the product.
category_3	`string` (Optional)	Galaxy	Category 3 of the product.
category_4	`string` (Optional)	Smart	Category 4 of the product.
category_5	`string` (Optional)	Large	Category 5 of the product.
variant_1	`string` (Optional)	black	Variant 2 of the product.
variant_2	`string` (Optional)	5.5 inch	Variant 3 of the product.
variant_3	`string` (Optional)	100 g	Variant 4 of the product.

Esempio

<script>
    window.vantevo_ecommerce("start_checkout", {
        "total": 199.99,
        "coupon": "",
        "coupon_value": 0,
        "payment_type": "Credit Card",
        "items": [
         {
            'item_id': "SKU_123",
            'item_name': "Samsung Galaxy",
            'currency': "EUR",
            'quantity': 1,
            'price': 199.99,
            'discount': 0,
            'position': 1,
            'brand': "Samsung",
            'category_1': "Smartphone",
            'category_2': "Samsung",
            'category_3': "Galaxy",
            'category_4': "",
            'category_5': "",
            'variant_1': "Black",
            'variant_2': "5.5 inch",
            'variant_3': ""
        }
      ] 
  });
</script>

checkout_info

This event indicates that a user submits the data of personal

*Parameters

Option	Type	Description
items	`array` (Required)	The product information
total	`number` (Optional)	The total amount of the order Example: `1255.00`
coupon	`string` (Optional)	The name of the coupon used. Example: `newsletter`
coupon_value	`number` (Optional)	The value of the coupon used. Example: `45.00`
payment_type	`string` (Optional)	The mode of payment. Example: `Payal` o `Carta di credito`.

Product parameters

Option	Type	Example	Description
item_id	`string` (Required)	SKU_1234	Product ID (SKU)
item_name	`string` (Required)	Samsung Galaxy	Product name / title
currency	`string` (Optional)	USD	Indicates the currency used. The format to use is: ISO 4217. If no currency is entered Vantevo will use the default currency selected in the domain settings. Check the list of available currencies.
quantity	`number` (Optional)	1	Product quantity. Default 1.
price	`number` (Optional)	199.90	Product price. Default 0.
discount	`number` (Optional)	20.20	The value of the discount associated with the product. Default 0.
position	`number` (Optional)	1	The position of the product in a list. Default 1.
brand	`string` (Optional)	Samsung	The brand of the product.
category_1	`string` (Optional)	Smartphone	Category 1 of the product.
category_2	`string` (Optional)	Samsung	Category 2 of the product.
category_3	`string` (Optional)	Galaxy	Category 3 of the product.
category_4	`string` (Optional)	Smart	Category 4 of the product.
category_5	`string` (Optional)	Large	Category 5 of the product.
variant_1	`string` (Optional)	black	Variant 2 of the product.
variant_2	`string` (Optional)	5.5 inch	Variant 3 of the product.
variant_3	`string` (Optional)	100 g	Variant 4 of the product.

Esempio

<script>
    window.vantevo_ecommerce("checkout_info", {
        "total": 199.99,
        "coupon": "",
        "coupon_value": 0,
        "payment_type": "Credit Card",
        "items": [
         {
            'item_id': "SKU_123",
            'item_name': "Samsung Galaxy",
            'currency': "EUR",
            'quantity': 1,
            'price': 199.99,
            'discount': 0,
            'position': 1,
            'brand': "Samsung",
            'category_1': "Smartphone",
            'category_2': "Samsung",
            'category_3': "Galaxy",
            'category_4': "",
            'category_5': "",
            'variant_1': "Black",
            'variant_2': "5.5 inch",
            'variant_3': ""
        }
      ] 
  });
</script>

checkout_ship

This event indicates that a user submits shipment data

*Parameters

Option	Type	Description
items	`array` (Required)	The product information
total	`number` (Optional)	The total amount of the order Example: `1255.00`
coupon	`string` (Optional)	The name of the coupon used. Example: `newsletter`
coupon_value	`number` (Optional)	The value of the coupon used. Example: `45.00`
payment_type	`string` (Optional)	The mode of payment. Example: `Payal` o `Carta di credito`.

Product parameters

Option	Type	Example	Description
item_id	`string` (Required)	SKU_1234	Product ID (SKU)
item_name	`string` (Required)	Samsung Galaxy	Product name / title
currency	`string` (Optional)	USD	Indicates the currency used. The format to use is: ISO 4217. If no currency is entered Vantevo will use the default currency selected in the domain settings. Check the list of available currencies.
quantity	`number` (Optional)	1	Product quantity. Default 1.
price	`number` (Optional)	199.90	Product price. Default 0.
discount	`number` (Optional)	20.20	The value of the discount associated with the product. Default 0.
position	`number` (Optional)	1	The position of the product in a list. Default 1.
brand	`string` (Optional)	Samsung	The brand of the product.
category_1	`string` (Optional)	Smartphone	Category 1 of the product.
category_2	`string` (Optional)	Samsung	Category 2 of the product.
category_3	`string` (Optional)	Galaxy	Category 3 of the product.
category_4	`string` (Optional)	Smart	Category 4 of the product.
category_5	`string` (Optional)	Large	Category 5 of the product.
variant_1	`string` (Optional)	black	Variant 2 of the product.
variant_2	`string` (Optional)	5.5 inch	Variant 3 of the product.
variant_3	`string` (Optional)	100 g	Variant 4 of the product.

Esempio

<script>
    window.vantevo_ecommerce("checkout_ship", {
        "total": 199.99,
        "coupon": "",
        "coupon_value": 0,
        "payment_type": "Credit Card",
        "items": [
         {
            'item_id': "SKU_123",
            'item_name': "Samsung Galaxy",
            'currency': "EUR",
            'quantity': 1,
            'price': 199.99,
            'discount': 0,
            'position': 1,
            'brand': "Samsung",
            'category_1': "Smartphone",
            'category_2': "Samsung",
            'category_3': "Galaxy",
            'category_4': "",
            'category_5': "",
            'variant_1': "Black",
            'variant_2': "5.5 inch",
            'variant_3': ""
        }
      ] 
  });
</script>

checkout_payment

This event indicates that a user has initiated the payment process

*Parameters

Option	Type	Description
items	`array` (Required)	The product information
total	`number` (Optional)	The total amount of the order Example: `1255.00`
coupon	`string` (Optional)	The name of the coupon used. Example: `newsletter`
coupon_value	`number` (Optional)	The value of the coupon used. Example: `45.00`
payment_type	`string` (Optional)	The mode of payment. Example: `Payal` o `Carta di credito`.

Product parameters

Option	Type	Example	Description
item_id	`string` (Required)	SKU_1234	Product ID (SKU)
item_name	`string` (Required)	Samsung Galaxy	Product name / title
currency	`string` (Optional)	USD	Indicates the currency used. The format to use is: ISO 4217. If no currency is entered Vantevo will use the default currency selected in the domain settings. Check the list of available currencies.
quantity	`number` (Optional)	1	Product quantity. Default 1.
price	`number` (Optional)	199.90	Product price. Default 0.
discount	`number` (Optional)	20.20	The value of the discount associated with the product. Default 0.
position	`number` (Optional)	1	The position of the product in a list. Default 1.
brand	`string` (Optional)	Samsung	The brand of the product.
category_1	`string` (Optional)	Smartphone	Category 1 of the product.
category_2	`string` (Optional)	Samsung	Category 2 of the product.
category_3	`string` (Optional)	Galaxy	Category 3 of the product.
category_4	`string` (Optional)	Smart	Category 4 of the product.
category_5	`string` (Optional)	Large	Category 5 of the product.
variant_1	`string` (Optional)	black	Variant 2 of the product.
variant_2	`string` (Optional)	5.5 inch	Variant 3 of the product.
variant_3	`string` (Optional)	100 g	Variant 4 of the product.

Esempio

<script>
    window.vantevo_ecommerce("checkout_payment", {
        "total": 199.99,
        "coupon": "",
        "coupon_value": 0,
        "payment_type": "Credit Card",
        "items": [
         {
            'item_id': "SKU_123",
            'item_name': "Samsung Galaxy",
            'currency': "EUR",
            'quantity': 1,
            'price': 199.99,
            'discount': 0,
            'position': 1,
            'brand': "Samsung",
            'category_1': "Smartphone",
            'category_2': "Samsung",
            'category_3': "Galaxy",
            'category_4': "",
            'category_5': "",
            'variant_1': "Black",
            'variant_2': "5.5 inch",
            'variant_3': ""
        }
      ] 
  });
</script>

purchase

This event indicates that a user has completed a purchase

*Parameters

Option	Type	Description
items	`array` (Required)	The product information
total	`number` (Optional)	The total amount of the order Example: `1255.00`
coupon	`string` (Optional)	Il nome del coupon utilizzato. Esempio: `newsletter`
coupon_value	`number` (Optional)	Il valore del coupon utilizzato. Esempio: `45.00`
payment_type	`string` (Optional)	La modalità di pagamento. Esempio : `Payal` o `Carta di credito`.

Product parameters

Option	Type	Example	Description
item_id	`string` (Required)	SKU_1234	Product ID (SKU)
item_name	`string` (Required)	Samsung Galaxy	Product name / title
currency	`string` (Optional)	USD	Indicates the currency used. The format to use is: ISO 4217. If no currency is entered Vantevo will use the default currency selected in the domain settings. Check the list of available currencies.
quantity	`number` (Optional)	1	Product quantity. Default 1.
price	`number` (Optional)	199.90	Product price. Default 0.
discount	`number` (Optional)	20.20	The value of the discount associated with the product. Default 0.
position	`number` (Optional)	1	The position of the product in a list. Default 1.
brand	`string` (Optional)	Samsung	The brand of the product.
category_1	`string` (Optional)	Smartphone	Category 1 of the product.
category_2	`string` (Optional)	Samsung	Category 2 of the product.
category_3	`string` (Optional)	Galaxy	Category 3 of the product.
category_4	`string` (Optional)	Smart	Category 4 of the product.
category_5	`string` (Optional)	Large	Category 5 of the product.
variant_1	`string` (Optional)	black	Variant 2 of the product.
variant_2	`string` (Optional)	5.5 inch	Variant 3 of the product.
variant_3	`string` (Optional)	100 g	Variant 4 of the product.

Esempio

<script>
    window.vantevo_ecommerce("purchase", {
        "total": 199.99,
        "coupon": "",
        "coupon_value": 0,
        "payment_type": "Credit Card",
        "items": [
         {
            'item_id': "SKU_123",
            'item_name': "Samsung Galaxy",
            'currency': "EUR",
            'quantity': 1,
            'price': 199.99,
            'discount': 0,
            'position': 1,
            'brand': "Samsung",
            'category_1': "Smartphone",
            'category_2': "Samsung",
            'category_3': "Galaxy",
            'category_4': "",
            'category_5': "",
            'variant_1': "Black",
            'variant_2': "5.5 inch",
            'variant_3': ""
        }
      ] 
  });
</script>

Currencies list

Vantevo Analytics supports the following codes and currencies:

Codice	Codice	Nome
AED	د.إ"	United Arab Emirates Dirham
ALL	Lek	Albanian Lek
ARS	$	Argentine Peso
AUD	$	Australian Dollar
BGN	лв	Bulgarian Lev
BOB	$b	Bolivian Boliviano
BRL	R$	Brazilian Real
CHF	CHF	Swiss Franc
CLP	$	Chilean Peso
CNY	¥	Chinese Yuan
COP	$	Colombian Peso
CUP	₱	Cuban Peso
CZK	Kč	Czech Republic Koruna
DKK	kr	Danish Krone
EGP	£	Egyptian Pound
EUR	€	Euro
GBP	£	British Pound Sterling
HKD	$	Hong Kong Dollar
HRK	kn	Croatian Kuna
HUF	Ft	Hungarian Forint
IDR	Rp	Indonesian Rupiah
ILS	₪	Israeli New Sheqel
INR	₹	Indian Rupee
JPY	¥	Japanese Yen
KRW	₩	South Korean Won
LTL	Lt	Lithuanian Litas
MAD	DH	Moroccan Dirham
MDL	Lei	Moldovan Leu
MXN	$	Mexican Peso
MYR	RM	Malaysian Ringgit
NGN	₦	Nigerian Naira
NOK	kr	Norwegian Krone
NZD	$	New Zealand Dollar
PEN	S/	Peruvian Nuevo Sol
PHP	₱	Philippine Peso
PKR	₨	Pakistani Rupee
PLN	zł	Polish Zloty
PYG	Gs	Paraguayan Guarani
RON	Lei	Romanian Leu
RSD	Дин.	Serbian Dinar
RUB	₽	Russian Ruble
SAR	﷼	Saudi Riyal
SEK	kr	Swedish Krona
SGD	$	Singapore Dollar
THB	฿	Thai Baht
TND	د.ت	Tunisian Dinar
TRY	₺	Turkish Lira
TWD	NT$	New Taiwan Dollar
UAH	₴	Ukrainian Hryvnia
USD	$	United States Dollar
VND	₫	Vietnamese Dong
ZAR	R	South African Rand

note

How to add ecommerce monitoring script​

Parameters for advanced measurements​

Events List​

add_to_wishlist​

view_item​

remove_item_cart​

add_item_cart​

start_checkout​

checkout_info​

checkout_ship​

checkout_payment​

purchase​

Currencies list​

How to add ecommerce monitoring script

Parameters for advanced measurements

Events List

add_to_wishlist

view_item

remove_item_cart

add_item_cart

start_checkout

checkout_info

checkout_ship

checkout_payment

purchase

Currencies list