Web SDK

<script>
window.StaminadsConfig = {
  workspace_id: 'ws_your_workspace_id',
  endpoint: 'https://your-staminads-server.com'
};
</script>
<script async src="https://your-staminads-server.com/sdk/staminads.min.js"></script>

window.StaminadsConfig = {
  // Required
  workspace_id: 'ws_your_workspace_id',
  endpoint: 'https://your-staminads-server.com',

  // Optional
  debug: false,                    // Enable console logging
  sessionTimeout: 30 * 60 * 1000,  // 30 minutes (default)

  // Features
  trackSPA: true,                  // Auto-track SPA navigation
  trackScroll: true,               // Track scroll depth
};

window.StaminadsConfig = {
  workspace_id: 'ws_your_workspace_id',
  endpoint: 'https://your-staminads-server.com',

  // List all domains that should share sessions
  crossDomains: ['shop.example.com', 'blog.example.com'],
  crossDomainExpiry: 120,        // Link valid for 2 minutes (default)
  crossDomainStripParams: true   // Remove _stm param after reading (default)
};

// Decorate a URL with session data
const decoratedUrl = Staminads.decorateUrl('https://shop.example.com/checkout');
// Returns: https://shop.example.com/checkout?_stm=eyJzIjoi...

// Use with programmatic navigation
window.location.href = decoratedUrl;

// Get current session ID
const sessionId = await Staminads.getSessionId();

// Get persistent visitor ID
const visitorId = await Staminads.getVisitorId();

// Get authenticated user ID (if set)
const userId = await Staminads.getUserId();

// Get active engagement time (milliseconds)
const focusDuration = await Staminads.getFocusDuration();

// Get total time since session start (milliseconds)
const totalDuration = await Staminads.getTotalDuration();

// Get current config
const config = Staminads.getConfig();

// Track current page
await Staminads.trackPageView();

// Track specific URL
await Staminads.trackPageView('/custom/path');

// Simple goal
await Staminads.trackGoal({
  action: 'purchase'
});

// Goal with value
await Staminads.trackGoal({
  action: 'purchase',
  id: 'order-456',
  value: 99.99,
  currency: 'USD',
  properties: {
    plan: 'premium'
  }
});

https://example.com/page?stm_1=campaign_a&stm_2=variant_b&stm_3=source_x

// Set single dimension
await Staminads.setDimension(1, 'premium');
await Staminads.setDimension(2, 'returning');

// Set multiple dimensions
await Staminads.setDimensions({
  1: 'premium',
  2: 'returning',
  3: 'mobile-app'
});

// Get dimension value
const value = await Staminads.getDimension(1);

// Clear all dimensions
await Staminads.clearDimensions();

// Set user ID after login
await Staminads.setUserId('user_12345');

// Get current user ID
const userId = await Staminads.getUserId();

// Clear user ID on logout
await Staminads.setUserId(null);

// Pause tracking (e.g., for cookie consent)
await Staminads.pause();

// Resume tracking
await Staminads.resume();

// Reset session (start fresh, clears user ID)
await Staminads.reset();

// Get debug information
const debug = Staminads.debug();

console.log(debug);
// {
//   session: { id: '...', visitor_id: '...', ... },
//   config: { workspace_id: '...', ... },
//   focusState: 'FOCUSED',
//   isTracking: true,
//   queueLength: 0
// }