trackEcommerceCartUpdate

The trackEcommerceCartUpdate() method tracks the current state of the cart.

Syntax

const options: EcommerceOptions = {
  visitCustomVariables: { 1: { name: 'name', value: 'value' } },
  customDimensions: { 1: 'value', 2: 'value' },
  currencyCode: 'currencyCode',
};
const ecommerceProduct: EcommerceProduct[] = [
    {
      sku: 'sku',
      name: 'name',
      category: ['category'],
      price: 'price',
      quantity: quantity,
      brand: 'brand',
      variant: 'variant',
      customDimensions: {
        1: 'value',
        2: 'value',
      },
    },
];
let grandTotal: String = 'grandTotal';
await PiwikProSdk.trackEcommerceCartUpdate(ecommerceProduct, grandTotal, options);

Parameters

products (Array<object>, required)

Product list. Each product should have the following attributes:

sku (string, required)

Product stock-keeping unit.

name (string, optional)

Product name (default: “”).

category (string|Array<string>, optional)

Product category or an array of up to 5 categories. Default: “”.

price (number|string, optional)

Product price has to be a float number or a string containing float number representation. Default: 0.

quantity (number|string, optional)

Product quantity has to be an integer number or a string containing integer representation. Default: 1.

brand (string, optional)

Product brand. Default: “”.

variant (string, optional)

Product variant. Default: “”.

customDimensions (object, optional)

Product custom dimensions. Default: {}.

grandTotal (number|string, required)

The total value of items in a cart has to be a float number or a string containing float number representation.

options

Event options: an object containing three properties.

customDimensions

An object that contains custom dimensions.

visitCustomVariables

An object that contains visit custom variables.

currencyCode (string, optional)

ISO 4217 currency code, such asUSD, EUR, PLN. If no currency is provided, the default currency set in the Piwik PRO panel is used.

Examples

const options: EcommerceOptions = {
  visitCustomVariables: { 1: { name: 'name', value: 'value' } },
  customDimensions: { 1: 'value', 2: 'value' },
  currencyCode: 'EUR',
};
const ecommerceProduct: EcommerceProduct[] = [
    {
      sku: 'craft-311',
      name: 'Unicorn Iron on Patch',
      category: ['Crafts & Sewing', 'Toys', 'Cosmetics'],
      price: '49,9089',
      quantity: 3,
      brand: 'DMZ',
      variant: 'blue',
      customDimensions: {
        1: 'coupon-2020',
        2: '20%',
      },
    },
];
let grandTotal: String = '10000';
await PiwikProSdk.trackEcommerceCartUpdate(ecommerceProduct, grandTotal, options);

Related methods

• trackEcommerceAddToCart()
• trackEcommerceOrder()
• trackEcommerceProductDetailView()
• trackEcommerceRemoveFromCart()