Sending events

ADD event

The ADD event captures the product details when a user adds the product(s) to their online cart.

In case of cart abandonment, ADD events contribute to the calculation of abandoned revenue. When multiple ADD events in the same session use the same product.item_id, Sitecore Personalize treats later ADD events as an update to that line. The latest quantity and price values are used to calculate the line total. The sum of all line totals at session close equals the session's abandoned revenue.

To send an ADD event, use the following required attributes:

Attribute	Type	Description	Example
`channel`	string (uppercase)	The touchpoint where the user interacts with your brand.	`"MOBILE_APP"` `"MOBILE_WEB"` `"WEB"`
`type`	string (uppercase)	The type of the event that takes place when the user interacts with your brand.	`"ADD"`
`language`	string (uppercase ISO 639-1)	The language the user is using your app in.	`"DE"` `"EN"` `"FR"`
`currency`	string (uppercase ISO 4217)	The alphabetic currency code of the currency the user is using in your app.	`"EUR"` `"GBP"` `"USD"`
`page`	string	The name of the webpage where the interaction with your brand takes place. This is a custom value of your choice.	`"home"` `"contact-us.html"`
`pos`	string	The name of the point of sale where the interaction with your brand takes place.	`"myretailsite/ireland"` `"spinair.com/france"`
`browser_id`	string	The browser ID.	`"a38b230c-11eb-4cf9-8d5d-274e9f344925"`
`product`	object	The product entity data.	`"mys3cr3tstr1ingforauth1!x"`

The product object:

Attribute	Type	Description	Example	Required/optional
`type`	string (uppercase)	The type of product added to cart.	`"BET"`	Required
`item_id`	string	The item ID of the product added to cart. Used in Extract, Transform, Load (ETL) data integration to create the order.	`"EXACT_90"`	Required
`name`	string (title case recommended)	The name of the product added to the cart.	`"Exact score after 90 minutes"`	Required
`orderedAt`	string (ISO 8601)	The date and time the product was ordered.	`"2026-08-23T16:`17 `.000Z"`	Required
`quantity`	number	The number of unit added. Total price of the product is calculated by unit price multiplied by quantity.	`1`	Required
`price`	number (currency)	The unit price of the product. Total price of the product is calculated by unit price multiplied by quantity.	`100.00`	Required
`productId`	string	The product ID of the product added. Used in analytics for reporting.	`"CORRECT_SCORE"`	Required
`currency`	string (uppercase ISO 4217)	The currency of the product added to the cart.	`"EUR"`	Required
`originalPrice`	number (currency)	The unit price of the order item before conversion to the organization's currency.	`100.00`	Optional
`originalCurrencyCode`	string (uppercase ISO 4217)	The original currency code for the order item.	`"EUR"`	Optional
`referenceId`	string	An ID generated by your organization to reference the order item.	`"BET_001-1"`	Required

Example 44. ADD event object

{
   "channel": "MOBILE_APP",
   "type": "ADD",
   "language": "EN",
   "currency": "EUR",
   "page": "races",
   "pos": "myretailsite/ireland",
   "browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925",
   "product": {
      "type": "BET",
      "item_id": "EXACT_90",
      "name": "Exact score after 90 minutes",
      "orderedAt": "2026-08-23T16:`17:16`.000Z",
      "quantity": 1,
      "price": 100.00,
      "productId": "CORRECT_SCORE",
      "currency": "EUR",
      "originalPrice": 100.00,
      "originalCurrencyCode": "EUR",
      "referenceId": "BET_001-1"
   }
}

If you have suggestions for improving this article, let us know!