Win Events & Custom Events

LinkBridge supports two main types of events: Win Events (sales, revenue-related) and Custom Events (user actions you define). These events help you measure conversions, analyze funnels, and gain a detailed picture of user behavior.

Win Events (win_...)

Win events track sales and revenue. Always send them from your backend to keep data secure. Example request:

POST <YOUR_API_ENDPOINT>
Headers: {
  "Authorization": "Bearer YOUR_SECRET_KEY",
  "Content-Type": "application/json"
}

Request Body:
{
  "eventType": "win_sale", // e.g. win_sale, win_purchase
  "websiteId": "68ab108c4a215929683ad3b9",
  "data": {
    "saleAmount": 149.99,
    "saleId": "ORD-9921",
    "saleCurrency": "USD"
  }
}

Custom Events (custom_...)

Custom events let you track specific user actions (e.g. login, checkout step, button clicks). They can be sent from both backend and frontend, but must include identifiers for tracking.

POST <YOUR_API_ENDPOINT>
Headers: {
  "Authorization": "Bearer YOUR_SECRET_KEY",
  "Content-Type": "application/json"
}

Request Body:
{
  "eventType": "custom_checkout_step",
  "visitorId": "<extract from __visitorId cookie>",
  "sessionId": "<extract from __sessionId cookie>",
  "websiteId": "68ab108c4a215929683ad3b9",
  "data": {
    "step": 2,
    "funnel": "checkout"
  }
}