Record a conversion for an attributed session.

Updates the attribution session with conversion details, enabling revenue tracking back to the original AI query. This is the key endpoint for proving ROI: "Which ChatGPT query generated $499 in revenue?"

Use Case: When a user completes a purchase, upgrade, or other conversion event, call this endpoint with the session_id and conversion value.

Example:

// User completes checkout
const sessionId = AIVisibility.getSessionId();
await fetch('/api/v1/sdk/conversion', {
  method: 'POST',
  headers: { 'X-API-Key': 'your_key' },
  body: JSON.stringify({
    session_id: sessionId,
    value: 499.00,
    currency: 'USD',
    metadata: { plan: 'pro', interval: 'monthly' }
  })
});

Request Body:

• session_id: SDK session identifier (same as used in /attribution/link)
• value: Conversion value (e.g., 499.00 for $499)
• currency: ISO currency code (default: USD)
• metadata: Optional conversion details (plan, customer_email, etc.)

Response: Returns conversion details including query_id (if attributed) and ai_source. If session wasn't attributed to an AI query, query_id will be null.

Note: If the session doesn't exist in attribution_sessions, the conversion is still recorded but won't be attributed to a specific AI query.