Copilot event tracking

You can track actions performed by your users with AI copilots, along with properties describing the event. This allows you to measure and analyze the quality of your copilot experience and identify opportunities for improvement.

How It Works

We can leverage our event tracking capabilities for copilots:

• Every user prompt sent is tracked as an event.

• Every copilot response is tracked as an event.

Optional events (like conversions or satisfaction) can be added to analyze success and user sentiment.

By adding properties to these events, you can provide additional context.

Events to Track

Mandatory Events

"screeb_copilot_user_prompt"

Triggered when a user sends a message to the copilot.

$screeb("event.copilot", "screeb_copilot_user_prompt", {
  prompt: "How can I export my data?",
  conversation_id: "conv_123",
  session_id: "sess_456",
  agent_id: "agent_789",
  // + any custom properties your product needs
});

Mandatory properties:

• prompt: string
• conversation_id: string
• session_id: string
• agent_id: string

"screeb_copilot_response"

Triggered when the copilot replies to the user.

$screeb("event.copilot", "screeb_copilot_response", {
  response: "You can export your data from the Settings page.",
  conversation_id: "conv_123",
  session_id: "sess_456",
  agent_id: "agent_789",
  // + any custom properties your product needs
});

Mandatory properties:

• response: string
• conversation_id: string
• session_id: string
• agent_id: string

Optional Events

"screeb_copilot_conversion"

Triggered when a copilot interaction leads to a conversion (e.g. a purchase, signup, or workflow completion).

$screeb("event.copilot", "screeb_copilot_conversion", {
  agent_id: "agent_789",
  // conversation_id and session_id are optional for conversion events
  // + any custom properties your product needs
});

Mandatory properties:

• agent_id: string

Optional properties:

• conversation_id: string
• session_id: string

"screeb_copilot_satisfaction"

Triggered when a user provides feedback on the copilot interaction.

$screeb("event.copilot", "screeb_copilot_satisfaction", {
  rating_scale: "5",
  rating: "4",
  conversation_id: "conv_123",
  session_id: "sess_456",
  agent_id: "agent_789",
  // + any custom properties
});

Mandatory properties:

• rating_scale: string
• rating: string
• conversation_id: string
• session_id: string
• agent_id: string