TargetBoard Documentation
website·Indexed 33 days ago
https://docs.targetboard.ai/TargetBoard provides AI-powered operational analysts (Agents) that monitor company data to detect meaningful changes and surface insights. The platform integrates with a wide range of tools including GitHub, GitLab, Salesforce, HubSpot, Zendesk, NetSuite, and various HR and engineering platforms to track KPIs and operational metrics.
What's inside TargetBoard
- TargetBoard's Present Folder feature allows you to showcase KPIs in a clean, focused format, making it ideal for Quarterly Business Reviews (QBRs), leadership reviews, or team check-ins. Unlike static slide decks, Present Mode allows for active data engagement, including hovering over visualizations for more info and performing detailed drill-downs. You can also apply filters to the folder to maintain a consistent data set across all boards in the presentation.
Understand TargetBoard default board visibility
By default, all newly created boards in TargetBoard are private. They are only visible to the creator and workspace administrators. Private boards are identified by a blue Private label next to the board's name.Understand how TargetBoard tracks AI Adoption
TargetBoard tracks AI Adoption by correlating Pull Request data (developer identity, programming language, commit counts, lines added/removed, timestamps, and review activity) with activity data from connected AI coding tools (suggested lines, accepted lines, and acceptance ratios). If multiple AI tools are connected, TargetBoard normalizes the data to standardize developer names and programming languages for consistent comparison. This data is aggregated into core AI Adoption metrics and can be viewed at the individual Pull Request level or broken down by team and developer.Understand TargetBoard filter hierarchy and cumulative behavior
TargetBoard employs five levels of filtering. Filters are cumulative, meaning if multiple levels (e.g., account, folder, board, and card) have filters applied, the resulting data is the intersection of all those filters.
Filter Levels (from broadest to most specific):
- Account Level: Global data exclusion.
- Metric Level: Reusable metric definitions.
- Folder Level: Applies to all boards and cards within a folder.
- Board Level: Applies to all cards on a specific board.
- Card Level: Applies to a single KPI card.
Understand the difference between Managed and Custom Boards
TargetBoard offers two types of boards for organizing metrics and KPIs:
- Managed Boards: Curated and maintained by the TargetBoard team based on industry best practices (e.g., AI Adoption, Productivity, Sales Performance). They are not directly editable but provide a quick start. They are ideal for users who want a low-maintenance setup or standard industry breakdowns.
- Custom Boards: Built from scratch to meet specific requirements. Users can also create a Custom Board by duplicating a Managed Board and then editing the duplicate to serve as a template.
Understand TargetBoard Metric types
Metrics are measures used to track processes or goals and are located in the Catalog. They are categorized into three types:
- Core Metrics: Top-level metrics determined by connected integrations (e.g., Jira, GitHub, Zendesk) and the specific use cases defined in the account agreement.
- Custom Metrics: Top-level metrics built to specific organizational requirements or non-industry standard definitions (e.g., specific DORA metrics). These are created via a Customer Success Manager.
- Filtered Metrics: Subsets of Core Metrics created by applying specific filters (e.g., 'Backend Team Cycle Time'). These appear indented under their parent Core Metric in the Catalog and are used to avoid repeating the same filter configurations across multiple boards.
Understand TargetBoard Agents and Signals
TargetBoard Agents are AI-powered operational analysts that monitor company data to detect risks, bottlenecks, trends, and opportunities. They replace the need for manual dashboard reviews by proactively surfacing actionable insights.
Agents focus on specific operational domains such as:
- Software quality
- Velocity (e.g., monitoring cycle time, throughput, blocked work, PR review time)
- AI Impact
- Predictability
- Sustainability
Users can define the data scope for an Agent (e.g., specific teams or projects) and provide feedback to refine the Agent's focus over time.
Signals are the specific insights generated by Agents. A Signal is created when an Agent detects a meaningful change, risk, anomaly, or opportunity. Each Signal provides:
- What happened and why it matters
- Supporting metrics
- The originating Agent
- Severity level
- Creation timestamp
Understand the AI Maturity Scoring Model
The AI Maturity Scoring Model measures 'how well' developers use AI by converting weekly behavioral signals into a 0–100 maturity score.
Key mechanics include:
- Data Collection: Every developer is tracked weekly from their first AI tool use onward. Silent weeks are treated as signals, not missing data.
- Calculation: Fourteen behavioral signals are measured, normalized to a 0–1 scale, averaged into three group sub-scores, and combined into a weighted composite score.
- Smoothing: The final maturity level is based on a four-week rolling average to prevent erratic level jumps, while the weekly score reacts immediately.
- Scoring Methods:
- Absolute: Scored against a configured target and capped at 100%.
- Relative: Ranked against all other active users in the same week to measure relative maturity rather than raw volume.
Implement Data-Driven Performance Evaluation using Calculated Metrics
TargetBoard uses Calculated Metrics to translate qualitative performance dimensions into structured, weighted scoring models. This allows organizations to define customized evaluation criteria for different roles (e.g., software developers vs. account executives) to ensure objectivity and prevent gamification of a single metric. These scores can be combined with alerts to notify leadership of significant performance changes.Measure AI adoption and impact using TargetBoard
TargetBoard attributes AI-assisted engineering work by correlating two categories of operational metadata rather than using invasive monitoring. This allows organizations to measure the business impact of AI tools (e.g., effect on PR activity, cycle time, and throughput) without accessing proprietary source code, developer prompts, or local workstation activity.
TargetBoard's attribution model specifically avoids:
- Installing agents on developer machines or monitoring keystrokes.
- Reading source code or accessing proprietary IP.
- Reading prompts, AI conversations, or capturing IDE activity.
- Collecting files or attachments from repositories.
Track AI adoption and impact with TargetBoard
Connect your AI coding tools to TargetBoard to track the impact of AI on your organization's engineering workflows. TargetBoard aggregates AI usage data with other engineering metrics to help organizations measure ROI, identify which AI tools are most trusted by teams, and make data-driven decisions regarding AI integration. Note that specific metrics, calculations, and data points are often customized based on individual customer requirements via a Customer Success Manager.Prerequisites for integrating Fullstory with TargetBoard
To integrate Fullstory data into TargetBoard via the Data Export REST API, your FullStory account must have the 'Data Export Pack' add-on. This is a paid add-on that enables the export of raw event data.