Skip to content
39 changes: 32 additions & 7 deletions src/connections/spec/ecommerce/v2.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,8 @@ title: 'Spec: V2 Ecommerce Events'

Segment's e-commerce spec helps define the journey for a customer as they browse your store, click on promotions, view products, add those products to a cart, and complete a purchase.

**Note:** Not all destinations support every event listed here. Refer to individual destination docs for more information on supported events and properties.
> info "Note"
> Not all destinations support every event listed here and accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.

## Event Lifecycles

Expand Down Expand Up @@ -117,7 +118,10 @@ analytics.track('Products Searched', {

### Product List Viewed

Fire this event when a visitor views a product list or category.
Fire this event when a visitor views a product list or category.

> info "Note"
> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.

This event supports the following semantic properties:

Expand Down Expand Up @@ -240,7 +244,10 @@ analytics.track('Product List Viewed', {

### Product List Filtered

Send this event when a visitor filters a product list or category.
Send this event when a visitor filters a product list or category.

> info "Note"
> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.

This event supports the following semantic properties:

Expand Down Expand Up @@ -933,7 +940,10 @@ analytics.track('Product Removed', {

### Cart Viewed

Fire this event when a visitor views a shopping cart.
Fire this event when a visitor views a shopping cart.

> info "Note"
> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.

This event supports the following semantic properties:

Expand Down Expand Up @@ -1044,7 +1054,10 @@ analytics.track('Cart Viewed', {

### Checkout Started

Fire this event whenever an order/transaction was started. Fire on the page that the customer lands on after they press the checkout button.
Fire this event whenever an order/transaction was started. Fire on the page that the customer lands on after they press the checkout button.

> info "Note"
> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.

Be sure to **include all items in the cart as event properties**, with the same properties from the previous calls, like so:

Expand Down Expand Up @@ -1364,7 +1377,10 @@ You can have as many or as few steps in the checkout funnel as you'd like. Note

### Order Updated

Fire this event whenever an order/transaction was updated.
Fire this event whenever an order/transaction was updated.

> info "Note"
> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.

Be sure to **include all items in the cart as event properties**, with the same properties from the previous calls, like so:

Expand Down Expand Up @@ -1532,7 +1548,10 @@ The `sku` and `product_id` do not have to be different. If they are different, t

### Order Completed

Fire this event whenever an order/transaction was successfully completed by the customer.
Fire this event whenever an order/transaction was successfully completed by the customer.

> info "Note"
> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.

Be sure to **include all items in the cart as event properties**, with the same properties from the previous calls, like so:

Expand Down Expand Up @@ -1767,6 +1786,9 @@ analytics.track('Order Refunded', {

Fire this event whenever an order/transaction was cancelled.

> info "Note"
> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.

Be sure to **include all items in the cart as event properties**, with the same properties from the previous calls.

This event supports the following semantic properties:
Expand Down Expand Up @@ -2562,6 +2584,9 @@ analytics.track('Product Shared', {

Fire this event when a customer shares a shopping cart.

> info "Note"
> Not all destinations accept arrays as properties. Refer to individual destination docs for more information on supported events and properties.

This event supports the following semantic properties:

<table>
Expand Down