Skip to main content
Users
CloudPortalLogin
  • Powered byPowered by
Developing with Sitecore Personalize
Data privacy
Before you start sending data
Integrating with Sitecore Personalize
Stream API
Personalize API Flow execution
REST APIs
  • Sitecore Personalize for developers
  • Stream API
  • Direct HTTP requests reference
  • Sending events
  • ADD event for ancillary product

ADD event for ancillary product

You can use the ADD event to capture ancillary products that the user adds to their cart, such as insurance. This event is optional, but employing it can positively affect the amount of available data. Using this event is the only way to capture ancillary products that the user adds to their cart. This event also helps ensure accuracy of the cart contents and order values when a user returns to their abandoned cart.

To send an ADD event for an ancillary product, 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.

N/A

The product object:

Attribute

Type

Description

Example

Required/optional

type

string (uppercase)

The type of product added to cart.

  • "HOTEL"

  • "CAR"

  • "BAG"

  • "INSURANCE"

  • "LOUNGE_ACCESS"

  • "HOTEL_WIFI"

  • "INFLIGHT_ENTERTAINMENT"

  • "CARBON_OFFSET"

  • "INFLIGHT_VOUCHER"

  • "CHARITY_DONATION"

  • "TRANSFER"

Deprecated:

  • "BAGGAGE"

  • "FEES"

  • "SEAT_UPGRADES"

  • "INFLIGHT_VOUCHERS"

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.

"BAG_1"

Required

name

string (title case recommended)

The name of the product added to the cart.

"DUB-LHR Economy Flight"

"20kg Bag"

Required

currency

string (uppercase ISO 4217)

The currency of the product added to the cart.

"EUR"

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

product_id

string

The product ID of the product added. Used in analytics for reporting.

"Bag20"

Required

quantity

number

The number of unit added. Total price of the product is calculated by unit price multiplied by quantity.

1

Required

Example 45. ADD event object for ancillary product
RequestResponse
{
    "channel": "MOBILE_APP",
    "type": "ADD",
    "language": "EN",
    "currency": "EUR",
    "page": "passengers page",
    "pos": "spinair.com/france",
    "browser_id": "a38b230c-11eb-4cf9-8d5d-274e9f344925​",
    "product": {
        "type": "BAG",
        "item_id": "BAG_1",
        "name": "20kg Bag",
        "currency": "EUR",
        "price": 10,
        "product_id": "Bag20",
        "quantity": 1
    }
}


Do you have some feedback for us?

If you have suggestions for improving this article,

Privacy policySitecore Trust CenterCopyright © 1999-2025 Sitecore