---
title: Tracking events
slug: tracking-events
abstract: Event tracking provides intelligence and insights into commerce operations
content_type: concept
audience: \[developer, architect]
---
# Tracking events

## Overview

Event tracking provides intelligence and insights into commerce operations. While analytics systems capture user behavior and drive conversions, OrderCloud's role is to:

- Govern transaction validation
- Capture order information
- Enable data transmission
- Support analytics integration

The new Tracking Events feature enhances these capabilities.

## Event architecture

### Design philosophy

- Hydrated data models
- Complete event context
- Business-focused workflows
- Enhanced webhook functionality

### Event payloads

Example data included:

- Complete order details
- All line items
- Product information
- User data

## Integration options

### Sitecore integration

First iteration features:

- Send & Discover integration
- Built-in infrastructure
- Automatic event queuing
- Seamless processing
- Zero-configuration setup

Benefits:

- Email campaign management
- Abandoned cart recovery
- Product recommendations
- Personalized shopping

### Custom endpoints

Second iteration capabilities:

- External endpoint configuration
- Flexible integration options
- Solution agnosticism
- Composable architecture

### Server-side advantages

Benefits over client-side tracking:

- Reduced development time
- Minimized browser noise
- Avoided CORS restrictions
- Bypass tracking blockers
- Platform independence

## OrderCloud configuration

### Prerequisites

Note: Available to Sitecore customers

Requirements:

1. Production marketplace
2. [DeliveryConfiguration](https://doc.sitecore.com/ordercloud/en/developers/platform/delivery-configuration.html) setup:
   - SendEvent for Sitecore Send
   - DiscoverEvent for Sitecore Discover
   - Custom delivery targets
3. API client tracking configuration

### Sitecore Discover setup

1. Access Discover portal
2. Navigate to Developer Resources
3. Copy credentials:
   - Client ID (customer key)
   - API keys

## Resource models

### TrackingEvent model

```json
{
  "ID": "",
  "EventType": "UserLoggedIn | LineItemAdded | LineItemUpdated | OrderSubmitted",
  "ClientID": "",
  "Name": "",
  "DeliveryConfigID": "",
  "ConfigData": ""
}
```

### API endpoints

```http
GET /integrations/TrackingEvents
GET /integrations/TrackingEvents/{id}
POST /integrations/TrackingEvents
PUT /integrations/TrackingEvents/{id}
PATCH /integrations/TrackingEvents/{id}
DELETE /integrations/TrackingEvents/{id}
```

For details, see [Tracking Events API Reference](https://api-docs.sitecore.com/ordercloud/tracking-events)

## Event mapping

### OrderCloud to Sitecore events

| OrderCloud Operation | Sitecore event type |
| --------------------- | --------------------- |
| Log in | sitecore.backbone.messages.sessions.identified |
| Add item to cart | sitecore.backbone.messages.orders.lines.added |
| Update item in cart | sitecore.backbone.messages.orders.lines.updated |
| Submit order | sitecore.backbone.messages.orders.submitted |

## User identity management

### Anonymous to authenticated

OrderCloud supports:

- Anonymous shopping
- Authenticated users
- Identity stitching
- Complete user journeys

### Implementation steps

1. Beacon integration:
   - Insert page beacons
   - Capture session IDs
   - Include in anonymous tokens
   - Associate with calls

2. Authentication handling:
   - Call `me/orders/TransferAnonUserOrder`
   - Pass anonymous token
   - Enable identity stitching
   - Maintain session context

## Related reading

- [Tracking inventory changes in your markeplace](https://doc.sitecore.com/ordercloud/en/developers/platform/inventory-integration.html)
- [Order checkout integration event](https://doc.sitecore.com/ordercloud/en/developers/platform/order-checkout.html)
- [Using extended properties in custom eCommerce apps](https://doc.sitecore.com/ordercloud/en/developers/platform/extended-properties.html#using-extended-properties-in-custom-ecommerce-apps)
