Feature Adoption

Overview

Feature Adoption measures what percentage of your active users have tried a specific feature at least once during the analysis window. The adoption rate is unique feature users ÷ total active users in the period. This is distinct from a raw usage count — it tells you about feature discovery and uptake relative to your active user base.

When to use featureAdoption: "How many active users have tried the new AI assistant?", "What is the adoption rate of the export feature?", "Is v2 dashboard adoption growing month over month?"

When NOT to use featureAdoption: If you want a raw time-series count of feature usage, use trend. If you want a simple rate not tied to the active user base, use conversion.

Configuration Reference

Prop

Type

Available Template Variables

Variable	Description
`{{activeBaseCount}}`	Total active users in the analysis window
`{{uniqueAdopters}}`	Users who fired at least one feature event
`{{adoptionRatePct}}`	Percentage of active users who adopted the feature
`{{avgUsesPerAdopter}}`	Average number of feature interactions per adopter
`{{hasComparison}}`	`true` if `compareWindow` was set and previous-period data is available
`{{prevAdoptionRatePct}}`	Adoption rate in the previous period (when `hasComparison` is true)
`{{adoptionDeltaPct}}`	Percentage-point change vs. previous period (when `hasComparison` is true)
`{{windowPeriod}}`	Human-readable analysis window, e.g. `"last 30 days"`
`{{dataAsJson}}`	Full structured result as JSON
`{{executedAt}}`	ISO 8601 execution timestamp

Example

.journium/trackers/ai-assistant-adoption.yml

apiVersion: journium.app/v0Beta
kind: InsightTracker
metadata:
  name: ai-assistant-adoption
  displayName: AI Assistant Feature Adoption
  description: What fraction of active users have tried the AI assistant
spec:
  type: LLM
  trigger:
    mode: automatic
    schedule: weekly
  window:
    period: last_30d
  analysis:
    type: featureAdoption
    entity: person_id
    featureEvents:
      - event: ai_assistant_opened
        label: Opened AI Assistant
      - event: ai_suggestion_accepted
        label: Accepted AI Suggestion
    activeUserBaseline:
      event: session_started
      period: 30d
    breakdowns:
      - property: plan
        maxCardinality: 5
    metrics:
      - adoptionRate
      - avgUsesPerAdopter
      - weekOverWeekDelta
    compareWindow: previous_period
  llm:
    promptTemplate: |
      AI assistant adoption analysis for {{windowPeriod}}.
      Active user base: {{activeBaseCount}}.
      Adopters: {{uniqueAdopters}} ({{adoptionRatePct}}%).
      Average uses per adopter: {{avgUsesPerAdopter}}.
      {{#if hasComparison}}
      Previous period: {{prevAdoptionRatePct}}% ({{adoptionDeltaPct}}pp change).
      {{/if}}
      Full data: {{dataAsJson}}
      Describe whether adoption is healthy and suggest one action to increase it.
    maxOutputTokens: 400

Overview

Configuration Reference

Available Template Variables

Example

On this page