ecommerceCartUpdate

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

Syntax

ecommerceCartUpdate(products, grandTotal[, options])
eCommerce.ecommerceCartUpdate(products, grandTotal[, options])
eCommerce.ecommerceCartUpdate(products, grandTotal[, options])
eCommerce.ecommerceCartUpdate(products, grandTotal[, options])
eCommerce.ecommerceCartUpdate(products, grandTotal[, options])
eCommerce.ecommerceCartUpdate(products, grandTotal[, options])
eCommerce.ecommerceCartUpdate(products, grandTotal[, options])

Parameters

ParameterTypeDescriptionRequired
productsArray<Product>List of productsYes
grandTotalnumber | stringThe total value of items in a cart has to be a float number or a string containing float number representation.Yes
optionsobjectOptional object used to provide additional parameters to the requestNo

Product Object

AttributeTypeDescriptionRequired
skustringProduct stock-keeping unit.Yes
namestringProduct name (default: “”).No
categorystring | Array<string>Product category or an array of up to 5 categories. Default: “”.No
pricenumber | stringProduct price must be a float number or a string containing float number representation. Default: 0.No
quantitynumber | stringProduct quantity must be an integer number or a string containing integer representation. Default: 1.No
brandstringProduct brand. Default: “”.No
variantstringProduct variant. Default: “”.No
customDimensionsobjectProduct custom dimensions. Default: {}.No

Options Object

OptionTypeDescriptionRequired
currencyCodestringCurrency of the 'conversionValue' in ISO 4217 format. If not provided, the currency set in app settings will be used instead.No

Examples

_paq.push([
  "ecommerceCartUpdate",
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "150.00",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
    {
      sku: "craft-312",
      name: "Unicorn Iron on Grass",
      category: "Crafts & Sewing",
      price: "30.00",
      quantity: 1,
      brand: "DMZ",
      variant: "red",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  "180.00",
  { currencyCode: "EUR" },
]);
eCommerce.ecommerceCartUpdate(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "150.00",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
    {
      sku: "craft-312",
      name: "Unicorn Iron on Grass",
      category: "Crafts & Sewing",
      price: "30.00",
      quantity: 1,
      brand: "DMZ",
      variant: "red",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  "180.00",
  { currencyCode: "EUR" }
);
eCommerce.ecommerceCartUpdate(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "150.00",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
    {
      sku: "craft-312",
      name: "Unicorn Iron on Grass",
      category: "Crafts & Sewing",
      price: "30.00",
      quantity: 1,
      brand: "DMZ",
      variant: "red",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  "180.00",
  { currencyCode: "EUR" }
);
eCommerce.ecommerceCartUpdate(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "150.00",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
    {
      sku: "craft-312",
      name: "Unicorn Iron on Grass",
      category: "Crafts & Sewing",
      price: "30.00",
      quantity: 1,
      brand: "DMZ",
      variant: "red",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  "180.00",
  { currencyCode: "EUR" }
);
eCommerce.ecommerceCartUpdate(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "150.00",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
    {
      sku: "craft-312",
      name: "Unicorn Iron on Grass",
      category: "Crafts & Sewing",
      price: "30.00",
      quantity: 1,
      brand: "DMZ",
      variant: "red",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  "180.00",
  { currencyCode: "EUR" }
);
eCommerce.ecommerceCartUpdate(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "150.00",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
    {
      sku: "craft-312",
      name: "Unicorn Iron on Grass",
      category: "Crafts & Sewing",
      price: "30.00",
      quantity: 1,
      brand: "DMZ",
      variant: "red",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  "180.00",
  { currencyCode: "EUR" }
);
eCommerce.ecommerceCartUpdate(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "150.00",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
    {
      sku: "craft-312",
      name: "Unicorn Iron on Grass",
      category: "Crafts & Sewing",
      price: "30.00",
      quantity: 1,
      brand: "DMZ",
      variant: "red",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  "180.00",
  { currencyCode: "EUR" }
);

Related methods