You are here:
Cart Management Family DMO Mappings
Cart Management interactions capture when customers add products to their shopping
cart (cart-add), remove products from their cart (cart-remove), or modify quantities and
product options (cart-update). These interactions map to two DMOs: ShoppingCartEngagement for
the cart-level event and ShoppingCartProductEngagement for individual product line
items.
All three interactions use the same DMO structure. The EngagementChannelActionId field stores the specific interaction type
(cart-add, cart-remove, cart-update).
These interactions use the Server2Server integration type.
ShoppingCartEngagement DMO
| Commerce Event Field | DMO Field | Required/Optional | Description |
|---|---|---|---|
currency |
CurrencyId |
Optional | Currency of the cart, in 3-character ISO 4217 format |
dateTime |
CreatedDate |
Required | DateTime event occurred in ISO 8601 format |
dateTime |
EngagementDateTm |
Required | Date and time of customer engagement |
deviceId |
IndividualId |
Required | Identifier of the device sending the event |
eventId |
Id |
Required | Unique identifier of the event that the client generates, commonly a universally unique identifier (UUID) |
eventType |
EngagementTypeId |
Required | Set to "cart" |
interactionName |
EngagementChannelActionId |
Required | User interaction the event describes (cart-add, cart-remove, cart-update) |
siteId |
WebsiteId |
Required | Identifier for the client sending the event |
sourceLocale |
DeviceLocaleId |
Optional | Locale associated with the event |
sourcePageId |
PageId |
Optional | Identifier of the page on which the event occurred |
sourceUrlReferrer |
ReferrerURL |
Optional | Referrer URL of the source page |
webStoreId |
WebStoreId |
Optional | Web store associated with the event |
ShoppingCartProductEngagement DMO
| Commerce Event Field | DMO Field | Required/Optional | Description |
|---|---|---|---|
adjustedTotalProductAmount |
AdjustedTotalProductAmount |
Optional | Adjusted amount (that is, accounting for promotions) of the products for the entire line item (adjusted unit price * quantity) |
cartEventId |
ShoppingCartEngagementId |
Required | Event ID of the Cart event associated with this cartItem event |
catalogObjectId |
ProductId |
Optional | Unique identifier of the catalog object such as a product |
dateTime |
CreatedDate |
Required | DateTime event occurred in ISO 8601 format |
dateTime |
LastModifiedDate |
Required | When the cart item was last modified |
eventId |
Id |
Required | Unique identifier of the event that the client generates, commonly a UUID |
eventType |
EngagementType |
Required | Type of engagement (cart item) |
imageUrl |
ProductImageURL |
Optional | URL of the image that is used when reporting on the product |
lineItemId |
ShoppingCartProductId |
Optional | Unique identifier of the line item for the cart |
name |
ShoppingCartProductItemName |
Optional | Name of the product |
price |
ProductPrice |
Optional | List price of each item |
quantity |
ProductQuantity |
Optional | Absolute quantity of the line item, after the event, specified by lineItemId |
totalProductAmount |
ProductAmount |
Optional | Amount of the products for the entire line item (price book unit price * quantity), not taking into account adjustments |

