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.
| Event | Description | Products | Shipping | Payments |
|---|---|---|---|---|
| Product Viewed | Visitor views a product | ✓ | ||
| Product Added to Cart | Product added to cart | ✓ | ||
| Product Added to Wishlist | Product saved for later | ✓ | ||
| Product Removed from Cart | Product removed from cart | ✓ | ||
| Cart Viewed | Visitor views their cart | ✓ | ||
| Checkout Started | Checkout process initiated | ✓ | ||
| Billing Address Added | Billing info provided | ✓ | ||
| Shipping Detail Added | Shipping method selected | ✓ | ✓ | |
| Payment Method Selected | Payment method chosen | ✓ | ✓ | ✓ |
| Checkout Completed | Order confirmed | ✓ | ✓ | ✓ |
Lead & Form Events
Track lead generation, qualification, and conversion.
| Event | Description |
|---|---|
| Lead Created | Contact form, demo request, quote request |
| Lead Qualified | Lead meets qualification criteria |
| Lead Disqualified | Lead does not meet criteria |
| Lead Closed | Lead converts to customer |
| Sign Up | New account created |
| Newsletter Subscribed | User subscribes to a newsletter or mailing list |
| Login | User authenticates |
Interaction Events
Track click interactions and engagement across the website.
| Event | Description |
|---|---|
| Click | Any tracked click interaction (buttons, links, downloads, shares, videos) |
| Click to Phone | Click on phone number link |
| Click to WhatsApp | Click on WhatsApp link |
| Click to Email | Click on email address link |
SPA Events
For Single Page Applications where URL changes don't trigger automatic page loads.
| Event | Description |
|---|---|
| Page Viewed | SPA 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": "EUR"
},
"products": [
{
"id": "PRODUCT_001",
"name": "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": "EUR",
"id": "ORDER_12345"
},
"products": [
{
"id": "PRODUCT_001",
"name": "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.