Ecommerce Statistics

Get Insights on Customers, Revenue, and Buying Habits

  1. Integrate Our E-Commerce Events And Watch Your Website Intelligence Grow.
    1. The function expects 3 parameters:
    2. The following events are supported:
  2. Event "add_payment_info"
    1. Description of the "add_payment_info" event
    2. Event Tag for "add_payment_info"
    3. Parameters for "add_payment_info"
  3. Event "add_shipping_info"
    1. Description of the "add_shipping_info" event
    2. Event tag for "add_shipping_info"
    3. Parameters for "add_shipping_info"
  4. Event "add_to_cart"
    1. Description of the "add_to_cart" event
    2. Event tag for "add_to_cart"
    3. Parameters for "add_to_cart"
    4. Item parameters for "add_to_cart"
  5. Event "add_to_wishlist"
    1. Description of the "add_to_wishlist" event
    2. Event tag for "add_to_wishlist"
    3. Parameters for "add_to_wishlist"
    4. Item parameters for "add_to_wishlist"
  6. Event "begin_checkout"
    1. Description of the "begin_checkout" event
    2. Event tag for "begin_checkout"
    3. Parameters for "begin_checkout"
    4. Item parameters for "begin_checkout"
  7. Event "generate_lead"
    1. Description of the "generate_lead" event
    2. Event tag for "generate_lead"
    3. Parameters for "generate_lead"
  8. Event "login"
    1. Description of the "login" event
    2. Event tag for "login"
    3. Parameters for "login"
  9. Event "purchase"
    1. Description of the "purchase" event
    2. Event tag for "purchase"
    3. Parameters for "purchase"
    4. Item parameters for "purchase"
  10. Event "refund"
    1. Description of the "refund" event
    2. Event tag for "refund"
    3. Parameters for "refund"
    4. Item parameters for "refund"
  11. Event "remove_from_cart"
    1. Description of the "remove_from_cart" event
    2. Event tag for "remove_from_cart"
    3. Parameters for "remove_from_cart"
    4. Item parameters for "remove_from_cart"
  12. Event "remove_from_wishlist"
    1. Description of the "remove_from_wishlist" event
    2. Event tag for "remove_from_wishlist"
    3. Parameters for "remove_from_wishlist"
    4. Item parameters for "remove_from_wishlist"
  13. Event "share"
    1. Description of the "share" event
    2. Event tag for "share"
    3. Parameters for "share"
    4. Item parameters for "share"
  14. Event "sign_up"
    1. Description of the "sign_up" event
    2. Event tag for "sign_up"
    3. Parameters for "sign_up"
  15. Event "view_cart"
    1. Description of the "view_cart" event
    2. Event tag for "view_cart"
    3. Parameters for "view_cart"
    4. Item parameters for "view_cart"
  16. Event "view_item"
    1. Description of the "view_item" event
    2. Event tag for "view_item"
    3. Parameters for "view_item"
    4. Item parameters for "view_item"
  17. Event "view_item_list"
    1. Description of the "view_item_list" event
    2. Event tag for "view_item_list"
    3. Parameters for "view_item_list"
    4. Item parameters for "view_item_list"
  18. Filters For eCommerce Statistics
    1. Unleash the Power of Your eCommerce Data

Integrate Our E-Commerce Events And Watch Your Website Intelligence Grow.

The E-commerce Events function is very similarly to the custom events feature. It relies on the global va function available in the website of the user that sends the events through the worker to the API.

The function expects 3 parameters:

  1. ecom - to specify that this is an e-com event
  2. The type of the events from the list below
  3. The payload of the event

The events follow a very similar structure to Google Analytics in order to facilitate migration.

The following events are supported:

  1. add_payment_info
  2. add_shipping_info
  3. add_to_cart
  4. add_to_wishlist
  5. begin_checkout
  6. generate_lead
  7. login
  8. purchase
  9. refund
  10. remove_from_cart
  11. remove_from_wishlist
  12. share
  13. sign_up
  14. view_cart
  15. view_item
  16. view_item_list

Event "add_payment_info"

Description of the "add_payment_info" event

This event is triggered when a user submits their payment information during an ecommerce checkout process. This information typically includes the user’s credit card number, billing address, and other relevant details. By tracking this event, you will gain insights into the number of successful transactions and the effectiveness of your payment processing system.

Event Tag for "add_payment_info"


va('ecom', 'add_payment_info', {
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "currency": "RON",
  "value": 0.00,
  "method": "Credit Card"
})
		

Parameters for "add_payment_info"

NameTypeRequiredExample ValueDescription
 
 currency
 
 
 string
 
 
 Yes*
 
 
 EUR
 
 
 Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
 value
 
 
 number
 
 
 Yes*
 
 
 17.99
 
 
 The monetary value of the event.
 
 
 payment_type
 
 
 string
 
 
 No
 
 
 Credit Card
 
 
 The chosen method of payment
 

Event "add_shipping_info"

Description of the "add_shipping_info" event

This event is triggered when a user submits their shipping information during an ecommerce checkout process. Shipping information typically includes the user’s name, address, and other relevant details that are required to deliver the purchased product to them. By tracking this event, you will gain insights into the number of successful deliveries and the effectiveness of your shipping process. This can help you to optimize your shipping strategies and improve overall customer satisfaction.

Event tag for "add_shipping_info"


va('ecom','add_shipping_info',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "currency":"RON",
  "value":0.00,
  "shippingTier":"DHL"
})
		

Parameters for "add_shipping_info"

NameTypeRequiredExample ValueDescription
 
  currency
 
 
  string
 
 
  Yes*
 
 
  EUR
 
 
  Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
  value
 
 
  number
 
 
  Yes*
 
 
  17.99
 
 
  The monetary value of the event (quantity * price)
 
 
  shipping_tier
 
 
  string
 
 
  No
 
 
  Ground
 
 
  The shipping tier (e.g. Ground, Air, Next-day) selected for delivery of the purchased item.
 

Event "add_to_cart"

Description of the "add_to_cart" event

This event is triggered when a user adds an item to their cart during an ecommerce session. By tracking this event, you will gain insights into the number of items added to the cart and the effectiveness of your product placement and pricing strategies. This can help you optimize your ecommerce experience and improve customer satisfaction.

Event tag for "add_to_cart"


va('ecom','add_to_cart',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "currency":"RON",
  "value":0.00,
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "add_to_cart"

NameTypeRequiredExample ValueDescription
 
 currency
 
 
 string
 
 
 Yes*
 
 
 EUR
 
 
 Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
 value
 
 
 number
 
 
 Yes*
 
 
 17.99
 
 
 The monetary value of the event.
 
 
 items
 
 
 Array<Item>
 
 
 Yes
 
 
  
 
 
 The items of the event.
 

 

Item parameters for "add_to_cart"

NameTypeRequiredExample ValueDescription
 
 item_id
 
 
 string
 
 
 Yes*
 
 
 SKU_123
 
 
 The ID of the item.
 
 
 item_name
 
 
 string
 
 
 Yes*
 
 
 iPhone 15
 
 
 The name of the item.
 
 
 affiliation
 
 
 string
 
 
 No
 
 
 Magazin online #1
 
 
 A product affiliation to designate a supplying company or brick and mortar store location. Note: 'affiliation' is only available at the item-scope.
 
 
 coupon
 
 
 string
 
 
 No
 
 
 50%OFF
 
 
 The coupon name/code associated with the item. Event-level and item-level coupon parameters are independent.
 
 
 discount
 
 
 number
 
 
 No
 
 
 10
 
 
 The unit monetary discount value associated with the item.
 
 
 index
 
 
 number
 
 
 No
 
 
 0
 
 
 The index/position of the item in a list.
 
 
 item_brand
 
 
 string
 
 
 No
 
 
 Apple
 
 
 The brand of the item.
 
 
 item_category
 
 
 string
 
 
 No
 
 
 Category 1
 
 
 The category of the item. If used as part of a category hierarchy or taxonomy then this will be the first category.
 
 
 item_category2
 
 
 string
 
 
 No
 
 
 Category 2
 
 
 The second category hierarchy or additional taxonomy for the item.
 
 
 item_category3
 
 
 string
 
 
 No
 
 
 Category 3
 
 
 The third category hierarchy or additional taxonomy for the item.
 
 
 item_category4
 
 
 string
 
 
 No
 
 
 Category 4
 
 
 The fourth category hierarchy or additional taxonomy for the item.
 
 
 item_category5
 
 
 string
 
 
 No
 
 
 Category 5
 
 
 The fifth category hierarchy or additional taxonomy for the item.
 
 
 item_list_id
 
 
 string
 
 
 No
 
 
 LIST-123
 
 
 The ID of the list in which the item was presented to the user. If set, event-level item_list_name is ignored. If not set, event-level item_list_name is used, if present.
 
 
 item_list_name
 
 
 string
 
 
 No
 
 
 John's wishlist
 
 
 The name of the list in which the item was presented to the user. If set, event-level item_list_name is ignored. If not set, event-level item_list_name is used, if present.
 
 
 item_variant
 
 
 string
 
 
 No
 
 
 Sky Blue
 
 
 The item variant or unique code or description for additional item details/options.
 
 
 location_id
 
 
 string
 
 
 No
 
 
 Online shop #2
 
 
 The location associated with the item (e.g. the physical store location).
 
 
 price
 
 
 number
 
 
 No
 
 
 6512.30
 
 
 The monetary unit price of the item, in units of the specified currency parameter. If a discount applies to the item, set price to the discounted unit price and specify the unit price discount in the discount parameter.
 
 
 quantity
 
 
 number
 
 
 No
 
 
 1
 
 
 Item quantity.
 
 
 image_url
 
 
 string
 
 
 No
 
 
 imageURLoftheproduct.com
 
 
 The image URL of the product.
 

 

Event "add_to_wishlist"

Description of the "add_to_wishlist" event

This event indicates that a user has added an item to their wishlist. You can leverage this event to identify popular gift items in your app.

Event tag for "add_to_wishlist"


va('ecom','add_to_wishlist',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "currency":"RON",
  "value":0.00,
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "add_to_wishlist"

NameTypeRequiredExample ValueDescription
 
   currency
 
 
   string
 
 
   Yes*
 
 
   EUR
 
 
   Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
   value
 
 
   number
 
 
   Yes*
 
 
   17.99
 
 
   The monetary value of the event.
 
 
   items
 
 
   Array<Item>
 
 
   Yes
 
 
       
 
 
   The items of the event.
 

Item parameters for "add_to_wishlist"

The item parameters can be found at item parameters for "add_to_cart"

Event "begin_checkout"

Description of the "begin_checkout" event

This event indicates that a user has initiated the checkout process.

Event tag for "begin_checkout"


va('ecom','begin_checkout',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "currency":"RON",
  "value":0.00,
  "coupon": "DISCOUNT CODE",
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "begin_checkout"

NameTypeRequiredExample ValueDescription
 
 currency
 
 
 string
 
 
 Yes*
 
 
 EUR
 
 
 Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
 value
 
 
 number
 
 
 Yes*
 
 
 17.99
 
 
 The monetary value of the event.
 
 
 coupon
 
 
 string
 
 
 No
 
 
 Coupon_code
 
 
 The coupon name/code associated with the event.
 
 
 items
 
 
 Array<Item>
 
 
 Yes
 
 
  
 
 
 The items of the event.
 

Item parameters for "begin_checkout"

The item parameters can be found at item parameters for "add_to_cart"

Event "generate_lead"

Description of the "generate_lead" event

This event is used to track when a lead is generated, such as through a form completion. By logging this event, you will gain insights into the effectiveness of your marketing campaigns and how many customers re-engage with your business after remarketing to them. This can help you optimize your marketing strategies and improve your customer engagement.

Event tag for "generate_lead"


va('ecom','generate_lead',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "currency":"RON",
  "value":0.00
})
		

Parameters for "generate_lead"

NameTypeRequiredExample ValueDescription
 
 currency
 
 
 string
 
 
 Yes*
 
 
 EUR
 
 
 Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
 value
 
 
 number
 
 
 Yes*
 
 
 17.99
 
 
 The monetary value of the event.
 

Event "login"

Description of the "login" event

Use this event to indicate that a user has logged in to your website or app.

Event tag for "login"


va('ecom','login',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "method": "Basic auth"
})
		

Parameters for "login"

NameTypeRequiredExample ValueDescription
 
 method
 
 
 string
 
 
 No
 
 
 TWIPLA
 
 
 The method used to login.
 

Event "purchase"

Description of the "purchase" event

This event indicates that a user has bought one or more items.

Event tag for "purchase"


va('ecom','purchase',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "transaction_id": "PayPal12312321312",
  "currency": "RON",
  "value": 6502.30,
  "coupon": "DISCOUNT_CODE",
  "shipping":12.50,
  "tax": 850.21,
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "purchase"

NameTypeRequiredExample ValueDescription
 
 currency
 
 
 string
 
 
 Yes*
 
 
 EUR
 
 
 Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
 value
 
 
 number
 
 
 Yes*
 
 
 17.99
 
 
 The monetary value of the event.
 
 
 transaction_id
 
 
 string
 
 
 Yes
 
 
 T_12345
 
 
 The unique identifier of a transaction.
 
 
 coupon
 
 
 string
 
 
 No
 
 
 Coupon_code
 
 
 The coupon name/code associated with the event.
 
 
 shipping
 
 
 number
 
 
 No
 
 
 3.33
 
 
 Shipping cost associated with a transaction.
 
 
 tax
 
 
 number
 
 
 No
 
 
 1.11
 
 
 Tax cost associated with a transaction.
 
 
 items
 
 
 Array<Item>
 
 
 Yes
 
 
  
 
 
 The items of the event.
 

Item parameters for "purchase"

The item parameters can be found at item parameters for "add_to_cart"

Event "refund"

Description of the "refund" event

This event indicates that one or more items have been refunded to a user.

Event tag for "refund"


va('ecom','refund',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "transaction_id": "PayPal12312321312",
  "currency": "RON",
  "value": 6502.30,
  "coupon": "DISCOUNT_CODE",
  "shipping":12.50,
  "tax": 850.21,
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "refund"

NameTypeRequiredExample ValueDescription
 
  currency
 
 
  string
 
 
  Yes*
 
 
  EUR
 
 
  Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
  transaction_id
 
 
  string
 
 
  Yes
 
 
  T_12345
 
 
  The unique identifier of a transaction.
 
 
  value
 
 
  number
 
 
  Yes*
 
 
  17.99
 
 
  The monetary value of the event.
 
 
  coupon
 
 
  string
 
 
  No
 
 
  Coupon_code
 
 
  The coupon name/code associated with the event.
 
 
  shipping
 
 
  number
 
 
  No
 
 
  3.33
 
 
  Shipping cost associated with a transaction.
 
 
  tax
 
 
  number
 
 
  No
 
 
  1.11
 
 
  Tax cost associated with a transaction.
 
 
  items
 
 
  Array<Item>
 
 
  No*
 
 
   
 
 
  The items of the event.
 

Item parameters for "refund"

The item parameters can be found at item parameters for "add_to_cart"

Event "remove_from_cart"

Description of the "remove_from_cart" event

This event indicates that a user has taken an item out of their cart. The occurrence of this event is a clear indication that an item has been removed from a cart.

Event tag for "remove_from_cart"


va('ecom','remove_from_cart',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "currency":"RON",
  "value":0.00,
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "remove_from_cart"

NameTypeRequiredExample ValueDescription
 
 currency
 
 
 string
 
 
 Yes*
 
 
 EUR
 
 
 Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
 value
 
 
 number
 
 
 Yes*
 
 
 17.99
 
 
 The monetary value of the event.
 
 
 items
 
 
 Array<Item>
 
 
 Yes
 
 
  
 
 
 The items of the event.
 

Item parameters for "remove_from_cart"

The item parameters can be found at item parameters for "add_to_cart"

Event "remove_from_wishlist"

Description of the "remove_from_wishlist" event

The event signifies that an item was removed from a wishlist. 

Event tag for "remove_from_wishlist"


va('ecom','remove_from_wishlist',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "currency":"RON",
  "value":0.00,
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "remove_from_wishlist"

NameTypeRequiredExample ValueDescription
 
 currency
 
 
 string
 
 
 Yes*
 
 
 EUR
 
 
 Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
 value
 
 
 number
 
 
 Yes*
 
 
 17.99
 
 
 The monetary value of the event.
 
 
 items
 
 
 Array<Item>
 
 
 Yes
 
 
  
 
 
 The items of the event.
 

 

Item parameters for "remove_from_wishlist"

The item parameters can be found at item parameters for "add_to_cart"

Event "share"

Description of the "share" event

This event should be used to identify when a user has shared content.

Event tag for "share"


va('ecom','share',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "method": "Twitter",
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "share"

NameTypeRequiredExample ValueDescription
 
 method
 
 
 string
 
 
 No
 
 
 Twitter
 
 
 The method in which the content is shared.
 
 
 content_type
 
 
 string
 
 
 No
 
 
 image
 
 
 The type of shared content.
 
 
 item_id
 
 
 string
 
 
 No
 
 
 C_12345 
 
 
 The ID of the shared content.
 

Item parameters for "share"

The item parameters can be found at item parameters for "add_to_cart"

Event "sign_up"

Description of the "sign_up" event

The occurrence of this event is a clear indication that a user has created an account. You can leverage this event to identify and analyze the distinct behaviors of users who are logged in and those who are not.

Event tag for "sign_up"


va('ecom','sign_up',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "method": "Google"
})
		

Parameters for "sign_up"

NameTypeRequiredExample ValueDescription
 
 method
 
 
 string
 
 
 No
 
 
 TWIPLA
 
 
 The method used for sign up.
 

Event "view_cart"

Description of the "view_cart" event

The occurrence of this event is a clear indication that a user has looked at the contents of their cart.

Event tag for "view_cart"


va('ecom','view_cart',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "currency":"RON",
  "value":0.00,
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "view_cart"

NameTypeRequiredExample ValueDescription
 
 currency
 
 
 string
 
 
 Yes*
 
 
 EUR
 
 
 Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
 value
 
 
 number
 
 
 Yes*
 
 
 17.99
 
 
 The monetary value of the event.
 
 
 items
 
 
 Array<Item>
 
 
 Yes
 
 
  
 
 
 The items of the event.
 

Item parameters for "view_cart"

The item parameters can be found at item parameters for "add_to_cart"

Event "view_item"

Description of the "view_item" event

This event indicates that a user has viewed some content. You can use this event to identify the most frequently viewed items.

Event tag for "view_item"


va('ecom','view_item',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "currency":"RON",
  "value":0.00,
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "view_item"

NameTypeRequiredExample ValueDescription
 
 currency
 
 
 string
 
 
 Yes*
 
 
 EUR
 
 
 Currency of the items associated with the event, in 3-letter ISO 4217 format.
 
 
 value
 
 
 number
 
 
 Yes*
 
 
 17.99
 
 
 The monetary value of the event.
 
 
 items
 
 
 Array<Item>
 
 
 Yes
 
 
  
 
 
 The items of the event.
 

Item parameters for "view_item"

The item parameters can be found at item parameters for "add_to_cart"

Event "view_item_list"

Description of the "view_item_list" event

Record this event when the user has been shown a list of items belonging to a specific category.

Event tag for "view_item_list"


va('ecom','view_item_list',{
  "customer": {
    "id": "internalID",
    "name": "John Smith",
    "email": "john@smith.com",
    "phoneNumber": "+4012312312312" 
  },
  "term": "Item List Name",
  "currency":"RON",
  "value":0.00,
  "items":[
    {
      "id": "SKU_123",
      "item_name": "iPhone 15",
      "affiliation": "Magazin online #1",
      "coupon": "50%OFF",
      "discount": 10,
      "index": 0,
      "item_brand": "Apple",
      "item_category": "Category 1",
      "item_category2": "Category 2",
      "item_category3": "Category 3",
      "item_category4": "Category 4",
      "item_category5": "Category 5",
      "item_list_id": "LIST-123",
      "item_list_name": "John's wishlist",
      "item_variant": "Sky Blue",
      "location_id": "Online shop #2",
      "price": 6512.30,
      "quantity": 1,
      "image_url": "https://www.apple.com/newsroom/images/2023/09/apple-unveils-iphone-15-pro-and-iphone-15-pro-max/tile/Apple-iPhone-15-Pro-lineup-hero-230912.jpg.og.jpg?202309270316"
    }
  ]
})
		

Parameters for "view_item_list"

NameTypeRequiredExample ValueDescription
 
 item_list_id
 
 
 string
 
 
 No
 
 
 related_products
 
 
 The ID of the list in which the item was presented to the user.
 
 
 item_list_name
 
 
 string
 
 
 No
 
 
 Related products
 
 
 The name of the list in which the item was presented to the user.
 
 
 items
 
 
 Array<Item>
 
 
 Yes
 
 
  
 
 
 The items of the event.
 

Item parameters for "view_item_list"

The item parameters can be found at item parameters for "add_to_cart"


Take control of your eCommerce statistics with our new filters! Dive deeper into your eComm data to find valuable insights and improve your online strategy.

We have two options that you can use to filter your data:

  1. New Filter: You can select one or combine different filters to help you focus on specific information by sorting through a large set of data and displaying only what meets certain criteria. The following filters are available for you:
    • Browser Name: Allows you to filter the data by browser name which helps you optimize your website based on your audience preferences.
    • Browser Version: Same with the Browser Name, you can ensure that your website is optimized for the browsers your audience prefers. Identify issues related to specific browser versions and prioritize fixes accordingly.
    • City of Visit: Drill down into user location data even further by using this filter. This information can be pivotal for local businesses, helping them tailor their content and marketing strategies to specific cities.
    • Company Category Associated With Visit: B2B businesses can derive significant value from this filter. Identify which companies are visiting your site and segment them by industry category. This can inform lead generation strategies and personalized outreach efforts.
    • Company Name Associated With Visit: Same with the Company Category, this filter would help in analyzing the data by industry category, getting to know which companies from specific industries visit your website the most. This filter allows you to segment and organize your visitor data to gain insights into the types of companies and industries showing interest in your website. 
    • Country Name: Businesses with a global presence will appreciate the Country Name filter. It enables you to explore user behavior and preferences on a country-specific level, aiding in localization efforts and targeting strategies.
    • Device Type: Understand how your audience accesses your website by filtering data based on device type. This filter helps ensure that your site is responsive and user-friendly across various devices, from desktops to smartphones.
    • IP: The IP filter can be a valuable tool for tracking visits from specific IP addresses, such as those from your organization or potential clients. Monitor user activity and tailor your website experience accordingly.
    • Operating System: Ensure optimal performance across different operating systems by filtering data by OS. This information can be used to identify compatibility issues and fine-tune your website for various platforms.
    • Page URL: Dive deep into your website's performance by narrowing down data to specific page URLs. This filter is invaluable for identifying which pages are driving the most engagement, conversion, or perhaps need optimization.
    • Screen Resolution: This filter is essential for optimizing your website's layout and design. Make sure your site looks stunning on all screen sizes and resolutions by analyzing data through this filter.
    • Traffic Channel: Understanding where your website traffic is coming from is vital. The Traffic Channel filter lets you segment your data by channels like organic search, paid search, direct, referral, and more. This insight can help you allocate resources more effectively and refine your marketing strategies.
    • UTM Campaign Filter: UTM parameters play a crucial role in tracking the performance of your marketing campaigns. Now, you can easily filter your dashboard data by specific UTM campaigns to see exactly how each campaign is performing.
    • eCommerce: This filter helps you analyze your orders, including customer and product details.
  2. Filter Templates: You can save your customized filters for later use by clicking the "Save Filters as a Template" button on the right side of the selected filters. You'll be required to enter a Filter Template Name then click “Save Changes”.
    • Use a Filter Template: To use a filter template, click the filter icon then go to Filter Templates. Select the template from the list then click “Submit”.
    • Edit or Delete: If you need to edit or delete a filter template, click the "pencil" icon next to the template to rename it or click “Delete Template” to delete it. A confirmation modal will appear before deletion.

The eCommerce filter is a powerful new tool that lets you dive deep into your eCommerce data. By leveraging this feature, you can gain valuable insights into your customers' behavior, product performance, and overall sales trends to  drive your business forward.

You can find the eCommerce filter on the following report blocks:

  • eCommerce KPIs
  • Revenue by Product
  • Units Sold per Product
  • Product KPIs
  • Ratio Sessions/Sales
  • Number of Orders by Traffic Channel

How to use the eCommerce filter:

  1. Navigate to the desired report block.
  2. Click on the filter icon.
  3. Select the "eCommerce" filter.
  4. Choose the specific field you want to filter by.
    • Customer ID
    • Item Category 1
    • Item Category 2
    • Item Category 3
    • Item Category 4
    • Item Category 5
    • Affiliation
    • Item ID
    • Item Name
  5. Apply the filter and analyze the results.

Important Hint: Combine multiple filters to narrow down your analysis and get more specific results.