Track business outcomes from your AI features and automatically calculate ROI. Link outcomes to LLM transactions for instant value visibility.
Link outcomes to LLM transactions for instant value and ROI calculation.
No transaction ID? System automatically matches outcomes by timestamp and metadata.
CFOs and CIOs see business value created on the Value Realization dashboard.
All outcome tracking requests must include these headers for proper attribution:
Production, Staging, or Development💡 Tip: Use the validation endpoint /api/outcomes/validate to test your integration without saving data.
1. Capture the transaction ID from your LLM proxy response
2. Track the outcome when your business event occurs
// Install: npm install @notionalpha/clarity-sdk openai
import { NotionAlphaClient } from '@notionalpha/clarity-sdk';
// Initialize client
const clarity = new NotionAlphaClient({
orgId: process.env.NOTIONALPHA_ORG_ID!,
teamId: process.env.NOTIONALPHA_TEAM_ID!,
environment: 'production',
featureId: 'customer-support-bot',
provider: {
type: 'openai',
providerId: process.env.NOTIONALPHA_PROVIDER_ID!
}
});
// Step 1: Make LLM call (FinOps automatic)
const { response, transactionId } = await clarity.chat.completions.create({
model: 'gpt-4o-mini',
messages: [{ role: 'user', content: 'How do I reset my password?' }]
});
console.log(response.choices[0].message.content);
// ✅ Cost automatically tracked
// ✅ Transaction ID captured for outcome tracking
// Step 2: Track outcome (one line)
await clarity.trackOutcome({
transactionId,
type: 'customer_support',
metadata: {
ticketId: 'TICKET-456',
timeSavedMinutes: 15,
customerSatisfaction: 5
}
});
// ✅ ROI automatically calculated
// View value realization
const value = await clarity.getValueRealization();
console.log(`ROI: ${value.roi}x`);Track tickets resolved, time saved, and customer satisfaction scores.
customer_support
Track code generated, developer hours saved, and quality scores.
code_generation
Track content pieces created, items processed, and engagement metrics.
content_creation
Track leads qualified, emails personalized, and conversion rates.
sales_marketing
Need help integrating outcome tracking? Contact our team