Tellius
  • 🚩Getting Started
    • 👋Say Hello to Tellius
      • Glossary
      • Tellius 101
      • Navigating around Tellius
    • ⚡Quick Start Guides
      • Search
      • Vizpads (Explore)
      • Insights (Discover)
    • ✅Best Practices
      • Search
      • Vizpads (Explore)
      • Insights (Discover)
      • Predict
      • Data
    • ⬇️Initial Setup
      • Tellius architecture
      • System requirements
      • Installation steps for Tellius
      • Customizing Tellius
    • Universal Search
    • 🏠Tellius Home Page
    • ❓FAQs
      • Kaiya Conversational AI
      • Data Preparation FAQs
      • Environment FAQs
      • Search FAQs
      • Vizpads FAQs
      • Data Caching FAQs
      • Embedding FAQs
      • Insights FAQs
  • Kaiya
    • ♟️Understanding AI Agents & Agentic Flows
      • Glossary
      • Composer
      • 🗝️Triggering an agentic workflow
      • The art of possible
      • Setting up LLM for Kaiya
    • 🤹Kaiya conversational AI
      • Triggering Insights with "Why" questions
      • Mastering Kaiya conversational AI
      • 📒Kaiya Learnings
      • Kaiya Terms of Service
  • 🔍Search
    • 👋Get familiar with our Search interface
    • 🤔Understanding Tellius Search
    • 📍Search Guide
    • 🚀Executing a search query
      • Selecting a Business View
      • Typing a search query
      • Constructing effective search queries
      • Marketshare queries
    • 🔑Analyzing search results
      • Understanding search results
      • Search Inspector
      • Time taken to execute a query
      • Interacting with the resulting chart
    • 📊Know your charts in Tellius
      • Understanding Tellius charts
      • Variations of a chart type
      • Building charts from Configuration pane
      • List of chart-specific fields
      • Adding columns to fields in Configuration pane
      • Absolute and percentage change aggregations
      • Requirements of charts
      • Switching to another chart
      • Formatting charts
      • Advanced Analytics
      • Cumulative line chart
    • 🧑‍🏫Help Tellius learn
    • 🕵️‍♂️Search history
    • 🎙️Voice-driven search
    • 🔴Live Query mode
  • 📈Vizpads (Explore)
    • 🙋Meet Vizpads!
    • 👋Get familiar with our Vizpads
    • #️⃣Measures, dimensions, date columns
    • ✨Creating Vizpads
    • 🌐Applying global filters
      • Filters in multi-BV Vizpads
      • Filters using common columns
    • 📌Applying local filters
    • 📅Date picker in filters
      • Customizing the calendar view
    • ✅Control filters
      • Multi-select list
      • Single-select list
      • Range slider
      • Dropdown list
    • 👁️Actions in View mode
      • Interacting with the charts
    • 📝Actions in Edit mode
      • 🗨️Viz-level actions
    • 🔧Anomaly management for line charts
      • Instance level
      • Vizpad level
      • Chart level
    • ⏳Time taken to load a chart
      • Instance level
      • Vizpad level
      • Chart level
    • ♟️Working with sample datasets
    • 🔁Swapping Business View of charts
      • Swapping only the current Vizpad
      • Swapping multiple objects
      • Configuring the time of swap
    • 🤖Explainable AI charts
  • 💡Insights (Discover)
    • 👋Get familiar with our Insights
    • ❓Understanding the types of Insights
    • 🕵️‍♂️Discovery Insights
      • Impact Calculation for Top Contributors
    • ➕How to create new Insights
      • 🔛Creating Discovery Insight
      • 🔑Creating Key Driver Insights
      • 〰️Creating Trend Insights
      • 👯Creating Comparison Insights
    • 🧮The art of selecting columns for Insights
      • ➡️How to include/exclude columns?
  • 🔢Data
    • 👋Get familiar with our Data module
    • 🥂Connect
    • 🪹Create new datasource
      • Connecting to Oracle database
      • Connecting to MySQL database
      • Connecting to MS SQL database
      • Connecting to Postgres SQL database
      • Connecting to Teradata
      • Connecting to Redshift
      • Connecting to Hive
      • Connecting to Azure Blob Storage
      • Connecting to Spark SQL
      • Connecting to generic JDBC
      • Connecting to Salesforce
      • Connecting to Google cloud SQL
        • Connecting to a PostgreSQL cloud SQL instance
        • Connecting to an MSSQL cloud SQL instance
        • Connecting to a MySQL Cloud SQL Instance
      • Connecting to Amazon S3
      • Connecting to Google BigQuery
        • Steps to connect to a Google BigQuery database
      • Connecting to Snowflake
        • OAuth support for Snowflake
        • Integrating Snowflake with Azure AD via OAuth
        • Integrating Snowflake with Okta via OAuth
        • Azure PrivateLink
        • AWS PrivateLink
        • Best practices
      • Connecting to Databricks
      • Connecting to Databricks Delta Lake
      • Connecting to an AlloyDB Cluster
      • Connecting to HDFS
      • Connecting to Looker SQL Interface
      • Loading Excel sheets
      • 🚧Understanding partitioning your data
    • ⏳Time-to-Live (TTL) and Caching
    • 🌷Refreshing a datasource
    • 🪺Managing your datasets
      • Swapping datasources
    • 🐣Preparing your datasets
      • 🤾Actions that can be done on a dataset
      • Data Pipeline
      • SQL code snippets
      • ✍️Writeback window
      • 🧩Editing Prepare → Data
      • Handling null or mismatched values
      • Metadata view
      • List of icons and their actions
        • Functions
        • SQL Transform
        • Python Transform
        • Standard Aggregation
        • Creating Hierarchies
      • Dataset Scripting
      • Fusioning your datasets
      • Scheduling refresh for datasets
    • 🐥Preparing your Business Views
      • 🌟Create a new Business View
      • Creating calculated columns
      • Creating dynamic parameters
      • Scheduling refresh for Business Views
      • Setting up custom calendars
    • Tellius Engine: Comparison of In-Memory vs. Live Mode
    • User roles and permissions
  • Feed
    • 📩What is a Feed in Tellius?
    • ❗Alerts on the detection of anomalies
    • 📥Viewing and deleting metrics
    • 🖲️Track a new metric
  • Assistant
    • 💁Introducing Tellius Assistant
    • 🎤Voice-based Assistant
    • 💬Interacting with Assistant
    • ↖️Selecting Business View
  • Embedding Tellius
    • What you should know before embedding
    • Embedding URL
      • 📊Embedding Vizpads
        • Apply and delete filters
        • Vizpad-related actionTypes
        • Edit, save, and share a Vizpad
        • Keep, remove, drill sections
        • Adding a Viz to a Vizpad
        • Row-level policy filters
      • 💡Embedding Insights
        • Creating and Viewing Insights
      • 🔎Embedding Search
        • Search query execution
      • Embedding Assistant
      • 🪄Embedding Kaiya
      • Embedding Feed
  • API
    • Insights APIs
    • Search APIs
    • Authentication API (Login API)
  • ✨What's New
    • Release 5.4
      • Patch 5.4.0.x
    • Release 5.3
      • Patch 5.3.1
      • Patch 5.3.2
      • Patch 5.3.3
    • Release 5.2
      • Patch 5.2.1
      • Patch 5.2.2
    • Release 5.1
      • Patch 5.1.1
      • Patch 5.1.2
      • Patch 5.1.3
    • Release 5.0
      • Patch 5.0.1
      • Patch 5.0.2
      • Patch 5.0.3
      • Patch 5.0.4
      • Patch 5.0.5
    • Release 4.3 (Fall 2023)
      • Patch 4.3.1
      • Patch 4.3.2
      • Patch 4.3.3
      • Patch 4.3.4
    • Release 4.2
      • Patch 4.2.1
      • Patch 4.2.2
      • Patch 4.2.3
      • Patch 4.2.4
      • Patch 4.2.5
      • Patch 4.2.6
      • Patch 4.2.7
    • Release 4.1
      • Patch 4.1.1
      • Patch 4.1.2
      • Patch 4.1.3
      • Patch 4.1.4
      • Patch 4.1.5
    • Release 4.0
  • 🛠️Settings
    • 👨‍💻My Profile
    • Users & Groups
Powered by GitBook

© 2025 Tellius

On this page
  • What is an Impact Score?
  • How the calculation adapts to your analysis?
  • Why the score is statistically trustworthy
  • Reading the score
  • Example 1: Trend Driver on a numeric total
  • Example 2: Trend Driver on a rate or percentage
  • Example 3: Trend Driver on market share
  • Example 4: Cohort Driver on a numeric total
  • Example 5: Cohort Driver on a rate or percentage
  • Example 6: Cohort Driver on market share

Was this helpful?

  1. Insights (Discover)
  2. Discovery Insights

Impact Calculation for Top Contributors

How a change reason contributor influences a target variable

What is an Impact Score?

Impact Scores in Tellius spotlight the dimensions that genuinely move your metric—scaled for size, corrected for noise, and tuned to the exact comparison you’re running—so you can act on what truly matters.

When Tellius highlights a “Top Contributor”, it is answering:

“If this contributor hadn’t changed, by how much would the overall metric still have moved?”

Impact scales each contributor’s movement against the overall movement, so small but volatile segments don’t eclipse large steady movers.

% = percent of overall change (used for numeric metrics) pp = percentage-points (used for rates or share comparisons)

How the calculation adapts to your analysis?

Tellius looks at two things before it computes the score:

  • Insight type – either Trend Drivers (comparing two time periods) or Cohort Drivers (comparing two groups).

  • Target metric – either a numeric total (revenue, units), a rate or percentage (win‑rate, approval‑rate), or market share.

The logic is then:

  • Numeric totals (Trend or Cohort)

    1. Work out the contributor’s change (or difference) – let's call this ΔC.

    2. Work out the overall change (or difference) – let's call this ΔO.

    3. Impact percent = (ΔC ÷ ΔO) × 100. A value of 50 % means the contributor explains half of the total movement.

  • Rates and percentages (Trend or Cohort)

    1. In each period or group, take the contributor’s rate minus the rate for everything else – that gives you a gap G₁ and G₂.

    2. Impact is the gap change: G₂ minus G₁, expressed in percentage‑points. A positive value means the contributor pushed the overall rate upward.

  • Market share

    1. Compute the contributor’s share in each period or group.

    2. Impact is simply the change in share, again in percentage‑points. This works whether you’re looking at overall share or a share inside a filter such as “Shoes in California.”

This same logic covers special cases like 4‑week vs 5‑week retail calendars because the calculation looks only at the periods or cohorts you’ve selected.

Why the score is statistically trustworthy

  • Population weighting – Every contributor’s impact is multiplied by how much data it represents, so two approvals in Iowa never outweigh thousands in California.

  • Significance test – Tellius treats the raw impact values as a distribution and only surfaces contributors that lie beyond a default 90 % confidence threshold.

  • False‑discovery control – When you examine dozens of dimensions at once, a Benjamini–Hochberg procedure keeps the false‑positive rate below 5 %.

Reading the score

  • Around +100 % – this contributor alone accounts for the full rise; celebrate or double‑down.

  • Around 0 % – it moved in line with the pack; nothing special to act upon.

  • Around ‑100 % – it fell while the total rose (or vice‑versa); investigate the drag.

Example 1: Trend Driver on a numeric total

Metric: total revenue. Periods compared: Week 5 vs Week 6.

  • What happened overall? Revenue rose from $100 M to $130 M, a lift of $30 M.

  • What happened for the contributor “Office Supplies”? It rose from $25 M to $40 M, a lift of $15 M.

  • Impact calculation: $15 M (contributor change) divided by $30 M (overall change) × 100 = 50 %.

  • Read‑out: Office Supplies explains half of the entire revenue growth in that period.

Example 2: Trend Driver on a rate or percentage

Metric: approval‑rate for Home Loans. Periods compared: Week 5 vs Week 6.

  • Home‑Loan approval improved from 6.5 % to 7.4 %.

  • Approval for all other loans improved from 45.4 % to 49.6 %.

  • Gap in Week 5 = 6.5 % – 45.4 % = ‑38.9 pp (percentage‑points).

  • Gap in Week 6 = 7.4 % – 49.6 % = ‑42.2 pp.

  • Impact = change in the gap = (‑42.2 pp) – (‑38.9 pp) = ‑3.3 pp.

  • Read‑out: the approval gap versus other loans widened by 3.3 points, pulling the overall rate down slightly.

Example 3: Trend Driver on market share

Metric: share of Office Supplies in overall sales. Periods compared: Week 5 vs Week 6.

  • Week 5 share = $25 M ÷ $100 M = 25 %.

  • Week 6 share = $50 M ÷ $150 M = 33 %.

  • Impact = 33 % – 25 % = +8 percentage‑points.

  • Read‑out: Office Supplies grabbed eight points of extra share week‑over‑week.

Example 4: Cohort Driver on a numeric total

Metric: total Office‑Supplies sales. Cohorts compared: Chicago vs NYC in the same week.

  • Chicago sells $25 M of Office Supplies; NYC sells $50 M.

  • Overall sales difference between cities is $100 M (Chicago) vs $150 M (NYC) → $50 M gap.

  • Contributor difference is $25 M.

  • Impact = $25 M ÷ $50 M × 100 = 50 %.

  • Read‑out: half of the sales gap between the two cities comes from Office Supplies.

Example 5: Cohort Driver on a rate or percentage

Metric: approval‑rate for Home Loans. Cohorts compared: Chicago vs NYC.

  • Home‑Loan approval: 6.5 % in Chicago, 7.4 % in NYC.

  • All‑other loans: 45.4 % in Chicago, 49.6 % in NYC.

  • Gap in Chicago = 6.5 % – 45.4 % = ‑38.9 pp.

  • Gap in NYC = 7.4 % – 49.6 % = ‑42.2 pp.

  • Impact = –42.2 pp – (–38.9 pp) = ‑3.3 pp.

  • Read‑out: Home‑Loan approval lags other loans slightly more in NYC than in Chicago.

Example 6: Cohort Driver on market share

Metric: market share of Nike within California. Sub‑brands compared: Nike vs Reebok.

  • Nike sells $25 M of shoes; Reebok sells $50 M. Total shoe sales in CA = $100 M.

  • Nike share = 25 %; Reebok share = 50 %.

  • Impact for Nike = 25 pp below Reebok.

  • Read‑out: Nike trails Reebok by twenty‑five share points in California.

In every case, a contributor’s change is measured in relation to the overall change—and when you're working with rates, the calculation also adjusts for how the rest of the data behaves. This scaling is what makes Impact a reliable signal, not just a raw difference.

PreviousDiscovery InsightsNextHow to create new Insights

Last updated 14 hours ago

Was this helpful?

💡
🕵️‍♂️