Key performance indicator (KPI) scorecards are used to measure the relationship between event counts and a baseline count. These counts include the number of sessions, number of page views, or another event count. Each KPI scorecard can have any number of individual defined KPIs, each containing a list of events to report, their grades, and the base count.

KPI scorecards typically show how values or ratios are comparing to your site's predefined scoring model. For example, values such as the number of page views or ratios such as conversion rates can be represented in chart form. Ratios such as conversion rates across time can be displayed in pie charts, bar charts, and other representations.

You must have permission to perform any tasks associated with KPI scorecards.

## KPI scorecard terminology

These terms pertain to key performance indicator (KPI) scorecards.

**Term****Definition**- Activity Indicator
- An indicator of the general activity or traffic on a web application regardless of success, failure, or availability. It can be the total number of web application sessions, hits, or the count of a particular Canister event. It is used as the denominator in KPI percentage rating calculations.
- Availability Indicator
- An event that indicates either that the system is available or unavailable. The count of HTTP responses whose HTTP status code is 200 (success) indicates availability, while HTTP 500 (internal server error) is an indicator of non-availability.
- Grades
- When the ratio for the scorecard falls within a configured range, it is assigned a grade A-F.
- Permissions
- User access permissions for the scorecard.

## What is a weighted KPI calculation?

For weighted KPI calculations, the base weight of each KPI is factored against the weighted counts of each KPI by using the following formulas.

Here are the formulas:

```
base weight = 100% / # of KPI events
```

The weighted count is calculated by using the user-defined weights as a ratio to the base weight, as in the following formula:

```
weighted count= event count * (event weight / base weight)
```

The rating for each KPI event is then calculated as follows:

```
grade rating = sum of weighted counts / base activity count
```

In the table below, each row represents the KPI calculation for each type of Summary Calculation
for the Weighted values. In the previous example, the count for Event5 is set to `0`

,
which factors into the following average calculations.

Summary Calculation Type | Value | Formula | Grade Rating |

`Total` |
38 | Sum of ((Count of Event) * (Weighted/Unweighted)) for all event types | 76.00% |

`Average Including 0` |
7.6 | (Value of `Total` / #Events (5)) |
15.20% |

`Average Excluding 0` |
9.5 | (Value of `Total` ) / 4) Excludes Event5 |
19.00% |

## What is an unweighted KPI calculation?

In the following table, each row represents the KPI calculation for each type of Summary Calculation for the unweighted values.

- In the preceding table, the count for Event5 is set to
`0`

, which factors into the average calculations. - Grade Rating is computed by the following formula. Grades are assigned by comparing this Grade
Rating to the Grade buckets.
`Value / Base Activity`

Summary Calculation Type | Value | Formula | Grade Rating |

`Total` |
28 |
Count of Event1 + Count of Event2 + Count of Event3 + Count of Event4 + Count of Event5 |
56.00% |

`Average Including 0` |
5.6 | (Value of `Total` / #Events (5)) |
11.20% |

`Average Excluding 0` |
7 | (Value of `Total` ) / 4) Excludes Event5 |
14.00% |

## Example: Event counts and weighting in KPI scorecards

In the following table, you can see how event counts and weights are related.

For our example of five events, you can see the Event Counts for each event for the time period.

If no weights are assigned for the selected events, the unweighted percentage is calculated by the following formula for each event:

```
1 / (Number of events)
```

In our example, this calculation is 1/5 or 20% for each type of event.

In the Weighted column , example weights are applied for each event. These weights are as part of creating the KPI scorecard.

`100`

.Event ID | Event Count | Unweighted | Weighted |

Event1 | 10 | 20% | 50% |

Event2 | 8 | 20% | 20% |

Event3 | 6 | 20% | 10% |

Event4 | 4 | 20% | 10% |

Event5 | 0 | 20% | 10% |