Add to cart event

The add to cart event (a2c:<page title>) must be sent when a user adds a product to the shopping cart. This event is required to compute cart abandonment metrics. If you do not send this event, the Sitecore Discover category and product analytics cannot report cart abandonment metrics.

The following table lists the attributes of the add to cart event:

Name

Type

Description

Value

type

String

Required.

Type of the event.

a2c

name

String

Required.

Name of the event, usually it is the name of the page where the event happened.

  • home

  • pdp

  • category

  • cart

  • qview

value.products

Array

Required.

Array containing a single product object.

n/a

value.products[].sku

String

Required.

SKU of the product that the user added to the cart.

n/a

value.products[].price

Float

Required.

Price of the product that is added to the cart.

n/a

value.products[].quantity

Integer

Required.

The number of units of products that a user added to the cart.

n/a

value.products[].fitment

Array

Required if site supports fitments.

An array of fitment objects. Refer to products, fitments for more details.

n/a

value.context.page

Object

Required if site is set up with locale configuration.

Add page-specific information (including locale information) under the page object.

n/a

value.locale (deprecated)

Object

Optional.

A locale object. This attribute is deprecated. We suggest you use the page object for locale data.

n/a

Sample event specification

The following is an example of an add to cart event object. This example is in the new format, which means it contains a context object.

RequestResponse
{
  "type": "a2c",
  "name": "home",
  "value": {
    "context": {
      "page": {
        "locale_country": "<country code, 2 letters, lowercase, e.g. fr>",
        "locale_language": "<language code, 2 letters, lowercase, e.g. en>",
        "locale_currency": "<currency code, 3 letters, lowercase, e.g. eur>"
      }
    },
    "products": [
      {
        "sku": "191258",
        "quantity": 1,
        "price": 11.99,
        "fitment": {
          "ids": [
            "3333"
          ]
        }
      }
    ]
  }

Do you have some feedback for us?

If you have suggestions for improving this article,