Data Connection Behavioral Events
The following lists the Commerce behavioral events available when you install the Data Connection extension. The data these events collect is sent to the Adobe Experience Platform. You can also create custom events to collect additional data not provided out of the box.
In addition to the data the following events collect, you also get other data provided by the Adobe Experience Platform Web SDK.
The behavioral events collect anonymized behavioral data from your shoppers as they browse your site. You can use the data these events collect to create promotions and campaigns targeted to a specific set of shoppers.
NOTEAll behavioral events include the
identityMap field, which includes the shopper’s email address, when available, and ECID.Storefront events
Storefront events capture data from shoppers’ interactions on the site and include events such as addToCart, pageView, createAccount, editAccount, startCheckout, completeCheckout, signIn, signOut, and so on. Storefront events apply to simple and configurable products only.
addToCart
| Description | XDM event name |
|---|---|
| Triggered when a product is added to the cart or when the quantity of a product in the cart is incremented. | commerce.productListAdds |
Data collected from addToCart
The following table describes the data collected for this event.
| Field | Description |
|---|---|
channel | Contains information about the source of the data. Both _id and _type contain namespaced values. |
channel._id | The unique identifier of the channel, such as "https://ns.adobe.com/xdm/channels/web". |
channel._type | Identifies the source of the channel data, such as "https://ns.adobe.com/xdm/channel-types/web". |
commerce.productListAdds | Indicates if a product was added to a shopping cart. A value of 1 indicates that a product was added. |
commerce.cart.cartID | The unique ID that identifies the customer’s cart. |
commerce.commerceScope | Indicates where an event occurred (store view, store, website, and so on). |
commerce.commerceScope.environmentID | The environment ID. A 32-digit alphanumeric ID separated by hyphens. |
commerce.commerceScope.storeCode | The unique store code. You can have many stores per website. |
commerce.commerceScope.storeViewCode | The unique store view code. You can have many store views per store. |
commerce.commerceScope.websiteCode | The unique website code. You can have many websites in an environment. |
productListItems | An array of products that were added to the shopping cart. |
productListItems.SKU | Stock Keeping Unit. The unique identifier for the product. |
productListItems.name | The display name or human-readable name of the product. |
productListItems.priceTotal | The total price for the product line item. |
productListItems.quantity | The number of product units in the cart. |
productListItems.discountAmount | Indicates the discount amount applied. |
productListItems.currencyCode | The ISO 4217 currency code used, such as USD or EUR. |
productListItems.productImageUrl | Main image URL of the product. |
productListItems.selectedOptions | Field used for a configurable product. |
productListItems.selectedOptions.attribute | Identifies an attribute of the configurable product, such as size or color. |
productListItems.selectedOptions.value | Identifies the value of the attribute such as small or black. |
openCart
| Description | XDM event name |
|---|---|
| Triggered when a new cart is created, which is when a product is added to an empty cart. | commerce.productListOpens |
Data collected from openCart
The following table describes the data collected for this event.
| Field | Description |
|---|---|
channel | Contains information about the source of the data. Both _id and _type contain namespaced values. |
channel._id | The unique identifier of the channel, such as "https://ns.adobe.com/xdm/channels/web". |
channel._type | Identifies the source of the channel data, such as "https://ns.adobe.com/xdm/channel-types/web". |
commerce.productListOpens | Indicates if a cart was created. A value of 1 indicates that a cart was created. |
commerce.cart.cartID | The unique ID that identifies the customer’s cart. |
commerce.commerceScope | Indicates where an event occurred (store view, store, website, and so on). |
commerce.commerceScope.environmentID | The environment ID. A 32-digit alphanumeric ID separated by hyphens. |
commerce.commerceScope.storeCode | The unique store code. You can have many stores per website. |
commerce.commerceScope.storeViewCode | The unique store view code. You can have many store views per store. |
commerce.commerceScope.websiteCode | The unique website code. You can have many websites in an environment. |
productListItems | An array of products that were added to the shopping cart. |
productListItems.SKU | Stock Keeping Unit. The unique identifier for the product. |
productListItems.name | The display name or human-readable name of the product. |
productListItems.priceTotal | The total price for the product line item. |
productListItems.quantity | The number of product units in the cart. |
productListItems.discountAmount | Indicates the discount amount applied. |
productListItems.currencyCode | The ISO 4217 currency code used, such as USD or EUR. |
productListItems.productImageUrl | Main image URL of the product. |
productListItems.selectedOptions | Field used for a configurable product. |
productListItems.selectedOptions.attribute | Identifies an attribute of the configurable product, such as size or color. |
productListItems.selectedOptions.value | Identifies the value of the attribute such as small or black. |
removeFromCart
| Description | XDM event name |
|---|---|
| Triggered every time a product is removed or every time the quantity of a product in the cart is decremented. | commerce.productListRemovals |
Data collected from removeFromCart
The following table describes the data collected for this event.
| Field | Description |
|---|---|
channel | Contains information about the source of the data. Both _id and _type contain namespaced values. |
channel._id | The unique identifier of the channel, such as "https://ns.adobe.com/xdm/channels/web". |
channel._type | Identifies the source of the channel data, such as "https://ns.adobe.com/xdm/channel-types/web". |
commerce.productListRemovals | Indicates if a product was removed from the cart. A value of 1 indicates that a product was removed from the cart. |
commerce.cart.cartID | The unique ID that identifies the customer’s cart. |
commerce.commerceScope | Indicates where an event occurred (store view, store, website, and so on). |
commerce.commerceScope.environmentID | The environment ID. A 32-digit alphanumeric ID separated by hyphens. |
commerce.commerceScope.storeCode | The unique store code. You can have many stores per website. |
commerce.commerceScope.storeViewCode | The unique store view code. You can have many store views per store. |
commerce.commerceScope.websiteCode | The unique website code. You can have many websites in an environment. |
productListItems | An array of products that were added to the shopping cart. |
productListItems.SKU | Stock Keeping Unit. The unique identifier for the product. |
productListItems.name | The display name or human-readable name of the product. |
productListItems.priceTotal | The total price for the product line item. |
productListItems.quantity | The number of product units in the cart. |
productListItems.discountAmount | Indicates the discount amount applied. |
productListItems.currencyCode | The ISO 4217 currency code used, such as USD or EUR. |
productListItems.productImageUrl | Main image URL of the product. |
productListItems.selectedOptions | Field used for a configurable product. |
productListItems.selectedOptions.attribute | Identifies an attribute of the configurable product, such as size or color. |
productListItems.selectedOptions.value | Identifies the value of the attribute such as small or black. |
shoppingCartView
| Description | XDM event name |
|---|---|
| Triggered when any cart page loads. | commerce.productListViews |
Data collected from shoppingCartView
The following table describes the data collected for this event.
| Field | Description |
|---|---|
channel | Contains information about the source of the data. Both _id and _type contain namespaced values. |
channel._id | The unique identifier of the channel, such as "https://ns.adobe.com/xdm/channels/web". |
channel._type | Identifies the source of the channel data, such as "https://ns.adobe.com/xdm/channel-types/web". |
commerce.productListViews | Indicates if a product list was viewed. |
commerce.cart.cartID | The unique ID that identifies the customer’s cart. |
commerce.commerceScope | Indicates where an event occurred (store view, store, website, and so on). |
commerce.commerceScope.environmentID | The environment ID. A 32-digit alphanumeric ID separated by hyphens. |
commerce.commerceScope.storeCode | The unique store code. You can have many stores per website. |
commerce.commerceScope.storeViewCode | The unique store view code. You can have many store views per store. |
commerce.commerceScope.websiteCode | The unique website code. You can have many websites in an environment. |
commerce.order | Contains information about the pending order for one or more products. |
commerce.order.discountAmount | Indicates the discount amount applied to the whole order. |
productListItems | An array of products that were added to the shopping cart. |
productListItems.SKU | Stock Keeping Unit. The unique identifier for the product. |
productListItems.name | The display name or human-readable name of the product. |
productListItems.priceTotal | The total price for the product line item. |
productListItems.quantity | The number of product units in the cart. |
productListItems.discountAmount | Indicates the discount amount applied. |
productListItems.currencyCode | The ISO 4217 currency code used, such as USD or EUR. |
productListItems.productImageUrl | Main image URL of the product. |
productListItems.selectedOptions | Field used for a configurable product. |
productListItems.selectedOptions.attribute | Identifies an attribute of the configurable product, such as size or color. |
productListItems.selectedOptions.value | Identifies the value of the attribute such as small or black. |
pageView
| Description | XDM event name |
|---|---|
| Triggered when any page loads. | web.webpagedetails.pageViews |
Data collected from pageView
The following table describes the data collected for this event.
| Field | Description |
|---|---|
channel | Contains information about the source of the data. Both _id and _type contain namespaced values. |
channel._id | The unique identifier of the channel, such as "https://ns.adobe.com/xdm/channels/web". |
channel._type | Identifies the source of the channel data, such as "https://ns.adobe.com/xdm/channel-types/web". |
web.webPageDetails.pageViews | Indicates if a page was loaded. A value of 1 indicates that the page was loaded. |
web.webPageDetails.URL | The normative or usual URL of the web page. This can be the actual URL used to reach the page, which would be recorded using Web Link. |
web.webPageDetails.name | The normative name of the web page. This name is not necessarily the page title or directly associated with page content, but is used to organize a site’s pages for classification purposes. |
web.webReferrer.URL | The URL of the webpage a shopper visited before clicking a link to your site. |
commerce.commerceScope | Indicates where an event occurred (store view, store, website, and so on). |
commerce.commerceScope.environmentID | The environment ID. A 32-digit alphanumeric ID separated by hyphens. |
commerce.commerceScope.storeCode | The unique store code. You can have many stores per website. |
commerce.commerceScope.storeViewCode | The unique store view code. You can have many store views per store. |
commerce.commerceScope.websiteCode | The unique website code. You can have many websites in an environment. |
productPageView
| Description | XDM event name |
|---|---|
| Triggered when any product page loads. | commerce.productViews |
Data collected from productPageView
The following table describes the data collected for this event.
| Field | Description |
|---|---|
channel | Contains information about the source of the data. Both _id and _type contain namespaced values. |
channel._id | The unique identifier of the channel, such as "https://ns.adobe.com/xdm/channels/web". |
channel._type | Identifies the source of the channel data, such as "https://ns.adobe.com/xdm/channel-types/web". |
commerce.productViews | Indicates if the product was viewed. |
commerce.commerceScope | Indicates where an event occurred (store view, store, website, and so on). |
commerce.commerceScope.environmentID | The environment ID. A 32-digit alphanumeric ID separated by hyphens. |
commerce.commerceScope.storeCode | The unique store code. You can have many stores per website. |
commerce.commerceScope.storeViewCode | The unique store view code. You can have many store views per store. |
commerce.commerceScope.websiteCode | The unique website code. You can have many websites in an environment. |
productListItems | An array of products that were added to the shopping cart. |
productListItems.SKU | Stock Keeping Unit. The unique identifier for the product. |
productListItems.name | The display name or human-readable name of the product. |
productListItems.priceTotal | The total price for the product line item. |
productListItems.quantity | The number of product units in the cart. |
productListItems.discountAmount | Indicates the discount amount applied. |
productListItems.currencyCode | The ISO 4217 currency code used, such as USD or EUR. |
productListItems.productImageUrl | Main image URL of the product. |
productListItems.selectedOptions | Field used for a configurable product. |
productListItems.selectedOptions.attribute | Identifies an attribute of the configurable product, such as size or color. |
productListItems.selectedOptions.value | Identifies the value of the attribute such as small or black. |
startCheckout
| Description | XDM event name |
|---|---|
| Triggered when the shopper clicks a checkout button. | commerce.checkouts |
Data collected from startCheckout
The following table describes the data collected for this event.
| Field | Description |
|---|---|
channel | Contains information about the source of the data. Both _id and _type contain namespaced values. |
channel._id | The unique identifier of the channel, such as "https://ns.adobe.com/xdm/channels/web". |
channel._type | Identifies the source of the channel data, such as "https://ns.adobe.com/xdm/channel-types/web". |
commerce.checkouts | Indicates if an action occurred during the checkout process. |
commerce.cart.cartID | The unique ID that identifies the customer’s cart. |
commerce.commerceScope | Indicates where an event occurred (store view, store, website, and so on). |
commerce.commerceScope.environmentID | The environment ID. A 32-digit alphanumeric ID separated by hyphens. |
commerce.commerceScope.storeCode | The unique store code. You can have many stores per website. |
commerce.commerceScope.storeViewCode | The unique store view code. You can have many store views per store. |
commerce.commerceScope.websiteCode | The unique website code. You can have many websites in an environment. |
productListItems | An array of products that were added to the shopping cart. |
productListItems.SKU | Stock Keeping Unit. The unique identifier for the product. |
productListItems.name | The display name or human-readable name of the product. |
productListItems.priceTotal | The total price for the product line item. |
productListItems.quantity | The number of product units in the cart. |
productListItems.discountAmount | Indicates the discount amount applied. |
productListItems.currencyCode | The ISO 4217 currency code used, such as USD or EUR. |
productListItems.productImageUrl | Main image URL of the product. |
productListItems.selectedOptions | Field used for a configurable product. |
productListItems.selectedOptions.attribute | Identifies an attribute of the configurable product, such as size or color. |
productListItems.selectedOptions.value | Identifies the value of the attribute such as small or black. |
completeCheckout
| Description | XDM event name |
|---|---|
| Triggered when the shopper places an order. | commerce.purchases |
Data collected from completeCheckout
The following table describes the data collected for this event.
| Field | Description |
|---|---|
channel | Contains information about the source of the data. Both _id and _type contain namespaced values. |
channel._id | The unique identifier of the channel, such as "https://ns.adobe.com/xdm/channels/web". |
channel._type | Identifies the source of the channel data, such as "https://ns.adobe.com/xdm/channel-types/web". |
commerce.purchases | Indicates if an order has been accepted. |
commerce.order | Contains information about the placed order for one or more products. |
commerce.order.purchaseID | Unique identifier assigned by the seller for this purchase or contract. There is no guarantee that the ID is unique. |
commerce.order.payments | The list of payments for this order. |
commerce.order.payments.paymentTransactionID | Unique identifier for this payment transaction. |
commerce.order.payments.paymentAmount | The value of the payment. |
commerce.order.payments.paymentType | The method of payment for this order. Options are: cash, credit_card, debit_card, gift_card, check, paypal, wire_transfer, credit_card_reference, other. |
commerce.order.payments.currencyCode | The ISO 4217 currency code used, such as USD or EUR. |
commerce.order.taxAmount | The tax amount paid by the buyer as part of the final payment. |
commerce.order.discountAmount | Indicates the discount amount applied to the whole order. |
commerce.order.createdDate | The time and date when a new order is created in the commerce system. For example, 2022-10-15T20:20:39+00:00. |
commerce.shipping | Shipping details for one or more products. |
commerce.shipping.shippingMethod | The method of shipping chosen by the customer, such as standard delivery, expedited delivery, pick up in store, and so on. |
commerce.shipping.shippingAmount | The amount the customer had to pay for shipping. |
commerce.shipping.currencyCode | The ISO 4217 currency code used, such as USD or EUR. |
commerce.commerceScope | Indicates where an event occurred (store view, store, website, and so on). |
commerce.commerceScope.environmentID | The environment ID. A 32-digit alphanumeric ID separated by hyphens. |
commerce.commerceScope.storeCode | The unique store code. You can have many stores per website. |
commerce.commerceScope.storeViewCode | The unique store view code. You can have many store views per store. |
commerce.commerceScope.websiteCode | The unique website code. You can have many websites in an environment. |
personalEmail | A personal email address. |
personalEmail.address | The technical address, for example, name@domain.com as commonly defined in RFC2822 and subsequent standards. |
productListItems | An array of products that were added to the shopping cart. |
productListItems.SKU | Stock Keeping Unit. The unique identifier for the product. |
productListItems.name | The display name or human-readable name of the product. |
productListItems.priceTotal | The total price for the product line item. |
productListItems.quantity | The number of product units in the cart. |
productListItems.discountAmount | Indicates the discount amount applied. |
productListItems.productImageUrl | Main image URL of the product. |
productListItems.selectedOptions | Field used for a configurable product. |
productListItems.selectedOptions.attribute | Identifies an attribute of the configurable product, such as size or color. |
productListItems.selectedOptions.value | Identifies the value of the attribute such as small or black. |
Customer profile events
Profile events captured from the storefront include account information, such as signIn, signOut, createAccount, and editAccount. This data is used to help populate key customer details that are needed to better define segments or execute marketing campaigns, such as sending sign-up discount offers, account change confirmations, and so on. There are similar profile events captured from the server-side.
signIn
| Description | XDM event name |
|---|---|
| Triggered when a shopper attempts to sign in. | userAccount.login |
NOTEThis event is triggered when the specific action is attempted. It does not indicate that the action was successful.
Data collected from signIn
The following table describes the data collected for this event.
| Field | Description |
|---|---|
channel | Contains information about the source of the data. Both _id and _type contain namespaced values. |
channel._id | The unique identifier of the channel, such as "https://ns.adobe.com/xdm/channels/web". |
channel._type | Identifies the source of the channel data, such as "https://ns.adobe.com/xdm/channel-types/web". |
person | An individual actor, contact, or owner. |
person.accountID | Captures the user account ID. |
person.accountType | Captures the user account type, such as Personal or Company, if applicable. |
person.personalEmailID | The technical address, for example, name@domain.com as commonly defined in RFC2822 and subsequent standards. |
personalEmail | Captures contact details - an e-mail and associated information. |
personalEmail.address | The technical address, for example, name@domain.com as commonly defined in RFC2822 and subsequent standards. |
userAccount | Indicates any loyalty details, preferences, login processes, and other account preferences. |
userAccount.login | Indicates if a visitor attempted to log in. |
commerce.commerceScope | Indicates where an event occurred (store view, store, website, and so on). |
commerce.commerceScope.environmentID | The environment ID. A 32-digit alphanumeric ID separated by hyphens. |
commerce.commerceScope.storeCode | The unique store code. You can have many stores per website. |
commerce.commerceScope.storeViewCode | The unique store view code. You can have many store views per store. |
commerce.commerceScope.websiteCode | The unique website code. You can have many websites in an environment. |
