View Cart
Fire whenever a user views their cart. This event is not the same as the ecommerce event "Begin Checkout". Unlike "Begin Checkout", the view_cart event will fire when a user is preparing to finalize their purchase, usually presented with their list of products, as well as options as to how they will proceed with checking out (e.g. normal checkout, paypal, amazon, etc).
Javascript Code
// When:
// User views cart
// Code:
window.dataLayer = window.dataLayer || [];
dataLayer.push({ event_data: null, ecommerce: null }); // Clear the previous ecommerce object.
dataLayer.push({
event: "view_cart",
event_data: {
identifier: "<identifier>", // REQUIRED | string | ex. uniquely_created_id, skin360_pwa_ntg_atc
name: '<name>' // REQUIRED | string | ex. pdp_add_to_cart, skin360_pwa_ntg add_to_cart
},
ecommerce: {
currency: "<currency>", // REQUIRED | string | ex. USD | pattern: ^[A-Z]{3}$ | min. 3, max. 3
items: "<items>", // REQUIRED | array | ex. [{item_id: "test"}]
value: "<value>" // REQUIRED | number | ex. 7.77 | pattern: ^\d\.\d\d$ | min. 0.00
}
});
Variable Definitions
Field | Type | Required | Description | Example | Pattern | Minimum Length | Maximum Length | Minimum |
---|---|---|---|---|---|---|---|---|
identifier | string |
required | The wtb-event machine-readable name. This should be a unique value specific to this piece of content, if one exists. If one does not exist, this can also be populated with the same value as the |
contact , lead_generation |
100 |
|||
name | string |
required | The wtb-event human-readable name. This should be something that an analyst without a deep knowledge of the technical implementation of the site can easily identify the event with. It should be lowercase snake_case. | contact , lead_generation |
100 |
|||
currency | string | required | Currency of the items associated with the event, in 3-letter ISO 4217 format. | USD |
^[A-Z]{3}$ |
3 |
3 |
|
items | array of items | required | Populate with item objects that represent the product viewed. | [{item_id: "test"}] |
100 |
|||
value | number | required | The monetary value of the event. Does not include currency sign. | 7.77 |
^\d\.\d\d$ |
100 |
0.00 |