Docs

ecommerceAddToCart

Suggest Edits

The ecommerceAddToCart() method tracks when a product is added to the cart.

Syntax

ecommerceAddToCart(products[, options])

eCommerce.ecommerceAddToCart(products[, options])

eCommerce.ecommerceAddToCart(products[, options])

eCommerce.ecommerceAddToCart(products[, options])

eCommerce.ecommerceAddToCart(products[, options])

eCommerce.ecommerceAddToCart(products[, options])

eCommerce.ecommerceAddToCart(products[, options])

Parameters

ParameterTypeDescriptionRequired
productsArray<Product>List of productsYes
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([
  "ecommerceAddToCart",
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "49.90",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  { currencyCode: "EUR" },
]);

eCommerce.ecommerceAddToCart(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "49.90",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  { currencyCode: "EUR" }
);

eCommerce.ecommerceAddToCart(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "49.90",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  { currencyCode: "EUR" }
);

eCommerce.ecommerceAddToCart(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "49.90",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  { currencyCode: "EUR" }
);

eCommerce.ecommerceAddToCart(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "49.90",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  { currencyCode: "EUR" }
);

eCommerce.ecommerceAddToCart(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "49.90",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  { currencyCode: "EUR" }
);

eCommerce.ecommerceAddToCart(
  [
    {
      sku: "craft-311",
      name: "Unicorn Iron on Patch",
      category: "Crafts & Sewing",
      price: "49.90",
      quantity: 3,
      brand: "DMZ",
      variant: "blue",
      customDimensions: {
        1: "coupon-2020",
        2: "20%",
      },
    },
  ],
  { currencyCode: "EUR" }
);

Related methods

Updated 6 days ago