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 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

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

API endpoints

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

Event mapping

OrderCloud to Sitecore events

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
• Order checkout integration event
• Using extended properties in custom eCommerce apps