Skip to main content

Events Overview

Events capture user interactions and business transactions on your website. They are pushed into the reshape array using window.reshape.push() and processed by the DATA Reshape script.

All events use the same standardized structure based on the Objects documentation for both web and webhook implementations. The only differences are in the context object (web vs webhook) and how data is collected — automatically via JavaScript or manually via webhooks.

The event.name determines how each event is processed and which destinations receive it. Only events mapped in your account configuration will be accepted.

E-commerce Events​

Track the complete shopping journey from product discovery to purchase completion.

EventDescriptionProductsShippingPayments
Product ViewedVisitor views a product✓
Product Added to CartProduct added to cart✓
Product Added to WishlistProduct saved for later✓
Product Removed from CartProduct removed from cart✓
Cart ViewedVisitor views their cart✓
Checkout StartedCheckout process initiated✓
Billing Address AddedBilling info provided✓
Shipping Detail AddedShipping method selected✓✓
Payment Method SelectedPayment method chosen✓✓✓
Checkout CompletedOrder confirmed✓✓✓

Lead & Form Events​

Track lead generation, qualification, and conversion.

EventDescription
Lead CreatedContact form, demo request, quote request
Lead QualifiedLead meets qualification criteria
Lead DisqualifiedLead does not meet criteria
Lead ClosedLead converts to customer
Sign UpNew account created
Email SubscribedUser subscribes to an email list (newsletter, product alert, etc.)
LoginUser authenticates

Interaction Events​

Track click interactions and engagement across the website.

EventDescription
ClickAny tracked click interaction (buttons, links, downloads, shares, videos)
Click to PhoneClick on phone number link
Click to WhatsAppClick on WhatsApp link
Click to EmailClick on email address link

SPA Events​

For Single Page Applications where URL changes don't trigger automatic page loads.

EventDescription
Page ViewedSPA route change

Quick Start​

Start with the two highest-impact events and expand from there:

window.reshape = window.reshape || [];

// 1. Track product views
reshape.push({
"event": {
"name": "product_viewed",
"value": 249.99,
"currency": "USD"
},
"products": [
{
"id": "prod_abc123",
"name": "Example Product Name",
"price_base": 249.99,
"price": 249.99,
"tax_included": true,
"tax_percent": 19,
"quantity": 1
}
]
});

// 2. Track purchases
reshape.push({
"event": {
"name": "checkout_completed",
"value": 299.99,
"currency": "USD",
"id": "ord_abc123"
},
"products": [
{
"id": "prod_abc123",
"name": "Example Product Name",
"price_base": 249.99,
"price": 249.99,
"tax_included": true,
"tax_percent": 19,
"quantity": 1
}
],
"shipping": [
{
"name": "Standard Shipping",
"value": 15.99,
"type": "standard"
}
],
"payments": [
{
"name": "Credit Card",
"value": 299.99,
"type": "card"
}
],
"user": {
"email": "[email protected]"
}
});

For complete field reference and all available properties, see the Objects documentation.