--- schema_version: "1" id: 1f07fbd25dbbcbe8b3e3bfab27f7480015a049d9b032dcce66207ff8426836b7 title: Engagement Events Integration Reference collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/cc/264-0-0/b2c_data_cloud_engagement_events_reference_overview.md canonical_url: https://help.salesforce.com/s/articleView?id=cc.b2c_data_cloud_engagement_events_reference_overview.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: f9a35a2ad8a3740ede5336733169a97a006ad29a180c294b4720e8c15f28db04 description: Engagement events capture customer interactions from B2C Commerce storefronts in near real-time and map that data into Data 360 Data Model Objects (DMOs). products: - Commerce - B2C Commerce release: "264" --- # Engagement Events Integration Reference Engagement events capture customer interactions from B2C Commerce storefronts in near real-time and map that data into Data 360 Data Model Objects (DMOs). ## Event Families Engagement events fall into event families. Each family captures specific interaction types: - [Cart Management](https://help.salesforce.com/s/articleView?id=cc.b2c_data_cloud_engagement_events_cart_management_family_dmo_mappings.htm&release=264.0.0&type=5 "Cart Management interactions capture when B2C Commerce 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."): Tracks cart interactions (`cart-add`, `cart-remove`, `cart-update`) to help analyze cart abandonment and purchase intent. - [Checkout Process](https://help.salesforce.com/s/articleView?id=cc.b2c_data_cloud_engagement_events_checkout_process_family_dmo_mappings.htm&release=264.0.0&type=5 "Checkout Process interactions capture when B2C Commerce customers initiate checkout (checkout-begin), progress through checkout stages (checkout-step), provide contact information (checkout-contact-info, deprecated), create accounts during checkout (checkout-user-register), and submit final orders (checkout-submit). These interactions map to WebsiteEngagement DMO for checkout events, plus Individual, ContactPointEmail, ContactPointPhone, and ContactPointAddress DMOs for customer data capture."): Tracks checkout progression (`checkout-begin`, `checkout-step`, `checkout-contact-info` (deprecated), `checkout-user-register`, `checkout-submit`) to help analyze checkout conversion. - [Customer Profile Management](https://help.salesforce.com/s/articleView?id=cc.b2c_data_cloud_engagement_events_customer_profile_family_dmo_mappings.htm&release=264.0.0&type=5 "Customer Profile Management interactions capture new B2C Commerce customer account creation (user-register) and profile modifications (update-user-profile). These interactions map to five DMOs: Individual for core customer identity, ContactPointEmail for email addresses, ContactPointPhone for phone numbers, ContactPointAddress for physical addresses, and PartyIdentification for cross-system identity linking."): Tracks account registration and profile updates (`user-register`, `update-user-profile`) to help analyze identity management and cross-device recognition. - [Order Processing](https://help.salesforce.com/s/articleView?id=cc.b2c_data_cloud_engagement_events_order_processing_family_dmo_mappings.htm&release=264.0.0&type=5 "Order Processing interactions capture when B2C Commerce orders are successfully processed and accepted (order-accepted). This interaction maps to ProductOrderEngagement DMO for order completion events, and can also update customer profile data through Individual and ContactPoint objects."): Tracks completed orders (`order-accepted`) to help analyze revenue tracking and customer lifecycle. - [Product Discovery](https://help.salesforce.com/s/articleView?id=cc.b2c_data_cloud_engagement_events_product_discovery_family_dmo_mappings.htm&release=264.0.0&type=5 "Product Discovery interactions capture when B2C Commerce customers perform product searches (search), view product detail pages (catalog-object-view-start), and see product impressions (catalog-object-impression). These interactions map to two DMOs: WebSearchEngagement for search activities, and ProductBrowseEngagement for product viewing and browsing."): Tracks product search and browsing (`search`, `catalog-object-view-start`, `catalog-object-impression`) to help analyze search optimization and merchandising strategies. - [Content Engagement](https://help.salesforce.com/s/articleView?id=cc.b2c_data_cloud_engagement_events_content_engagement_family_dmo_mappings.htm&release=264.0.0&type=5 "Content Engagement captures a single interaction, page-view, recorded each time a shopper loads a B2C Commerce storefront page. This browser-side interaction maps to the WebsiteEngagement DMO using the Browser2Server integration type."): Tracks page views (`page-view`) to help analyze content optimization and user journey mapping. - [Wishlist Management](https://help.salesforce.com/s/articleView?id=cc.b2c_data_cloud_engagement_events_wishlist_managment_family_dmo_mappings.htm&release=264.0.0&type=5 "Wishlist Management interactions capture when B2C Commerce customers save products for later (wish-list-add) and remove items from their wishlist (wish-list-remove). These interactions map to WebsiteEngagement DMO for wishlist interactions."): Tracks products saved for later (`wish-list-add`, `wish-list-remove`) to help analyze remarketing campaigns and inventory planning. ## Event Interactions The following table shows event families, their interactions, the Commerce APIs that trigger each interaction, and the integration type. There are two integration types: - **Server2Server**: Events are automatically sent from the B2C Commerce application server to Data 360. - **Browser2Server**: Browser JavaScript captures events and sends them to Data 360. | Event Family | Interaction | API | Integration Type | | --- | --- | --- | --- | | Cart Management | `cart-add` | [Shopper Baskets: addItemToBasket](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-baskets-v2?meta=addItemToBasket) | Server2Server | | Cart Management | `cart-remove` | [Shopper Baskets: removeItemFromBasket](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-baskets-v2?meta=removeItemFromBasket) | Server2Server | | Cart Management | `cart-update` | [Shopper Baskets: updateItemsInBasket](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-baskets-v2?meta=updateItemsInBasket) | Server2Server | | Checkout Process | `checkout-begin` | — | Server2Server | | Checkout Process | `checkout-user-register` | [Shopper Customers: registerCustomer](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-customers?meta=registerCustomer) | Server2Server | | Checkout Process | `checkout-submit` | [Shopper Orders: createOrder](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-orders?meta=createOrder) | Server2Server | | Checkout Process | `checkout-step` | — | Server2Server | | Checkout Process | `checkout-contact-info` (deprecated) | — | Server2Server | | Customer Profile Management | `user-register` | [Shopper Customers: registerCustomer](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-customers?meta=registerCustomer) | Server2Server | | Customer Profile Management | `update-user-profile` | [Shopper Customers: updateCustomer](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-customers?meta=updateCustomer) | Server2Server | | Order Processing | `order-accepted` | [Shopper Orders: createOrder](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-orders?meta=createOrder) | Server2Server | | Product Discovery | `search` | [Shopper Search: productSearch](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-search?meta=productSearch) | Browser2Server | | Product Discovery | `catalog-object-view-start` | — | Browser2Server | | Product Discovery | `catalog-object-impression` | — | Browser2Server | | Content Engagement | `page-view` | — | Browser2Server | | Wishlist Management | `wish-list-add` | [Shopper Customers: createCustomerProductListItem](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-customers?meta=createCustomerProductListItem) | Server2Server | | Wishlist Management | `wish-list-remove` | [Shopper Customers: deleteCustomerProductList](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-customers?meta=deleteCustomerProductList) | Server2Server | ## Storefront Support PWA Kit, Salesforce Reference Architecture (SFRA), and SiteGenesis storefronts support all event families. - **[Event Family DMO Mappings](https://help.salesforce.com/s/articleView?id=cc.b2c_data_cloud_engagement_events_integration_dmo_mappings.htm&release=264.0.0&type=5)** Each event family maps to specific Data Model Objects (DMOs) in Data 360. When B2C Commerce captures engagement events, it transforms that data into standardized DMO fields that Data 360 can process. Each event family has distinct mappings based on the type of customer interaction. - **[Engagement Events Data Enrichment](https://help.salesforce.com/s/articleView?id=cc.b2c_data_cloud_engagement_events_data_enrichment.htm&release=264.0.0&type=5)** All B2C Commerce event families benefit from automatic data enrichment that enhances the basic event data with additional context.