# User KPI (Time-Based, Seat-Based, Flat-Rate, RFC)

{% hint style="info" %} <mark style="color:blue;">Path: Dashboard</mark>
{% endhint %}

* [Definition](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-definition)
* [Create a KPI](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-createakpi)
* [Read a KPI from the user’s dashboard](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-readakpifromtheusersdashboar)
  * [KPI types](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-kpitypes)
    * [Standard KPI blocks](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-standardkpiblocks)
    * [Tops KPI blocks](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-topskpiblocks)
  * [Offeror KPI](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-offerorkpi)
    * [Standard KPI blocks](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-standardkpiblocks.1)
    * [Top KPI blocks](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-topkpiblocks)
  * [Asker KPI](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-askerkpi)
    * [Standard KPI blocks](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-standardkpiblocks.2)
  * [Filters](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-filters)
    * [Users roles](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-usersroles)
    * [Date filter](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-datefilter)
  * [Differential values](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-differentialvalues)
    * [Differential value based on the same start and end date in the date filter](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-differentialvaluebasedonthes)
    * [Differential value based on a date range with different start and end date](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-differentialvaluebasedonthes)
* [Update the KPI](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-updatethekpi)
* [Delete the KPI](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-deletethekpi)
* [Related resources](#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-relatedresources)

## Definition <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-definition" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-definition"></a>

By default, the user dashboard homepage displays the Key Performance Indicators (KPI) of that user.

**K*****ey*****&#x20;P*****erformance*****&#x20;I*****ndicator*** is a quantifiable measure of performance over time for a specific objective. KPIs provide targets for users to shoot for, milestones to gauge progress, and insights that help people across the organization make better decisions.

The KPI displayed can change depending on the activated bundle and the user's role.

<mark style="color:red;background-color:yellow;">**WHO CAN USE THIS FEATURE?**</mark>

**Switch users:** All logged-in users

**Non-Switch users:** All logged-in offerors.

**Non-Switch users:** All logged-in askers.

## Create a KPI <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-createakpi" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-createakpi"></a>

KPIs cannot be created. A preset of KPIs are available on all platforms (the displayed KPIs vary depending on the activated bundles).

## Read a KPI from the user’s dashboard <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-readakpifromtheusersdashboar" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-readakpifromtheusersdashboar"></a>

### KPI types <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-kpitypes" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-kpitypes"></a>

#### Standard KPI blocks <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-standardkpiblocks" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-standardkpiblocks"></a>

On the user dashboard’s homepage, several KPI blocks are displayed (figure 1).

Each KPI block displays:

* a value (based on the date range selected in filters)
* a differential (that compares the current value based on the date range selected in the filters with the value for the previous date range)
* a title.

A graphic can be opened to check the progression of these KPIs by clicking on the graphic icon (figure 1) in the KPI block. A pop-in modal with a graphic (figure 2) will open.

<figure><img src="/files/FpiVQlnWm2nhPXcOFPme" alt=""><figcaption><p>figure 2</p></figcaption></figure>

#### Tops KPI blocks <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-topskpiblocks" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-topskpiblocks"></a>

TOPS KPI blocks (figure 3) are ordered lists of the top 10 values based on a given criteria goal (e.g. top searched countries).

<figure><img src="/files/esZw6WfUti3VmOuY2m8G" alt=""><figcaption><p>figure 3</p></figcaption></figure>

### Offeror KPI <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-offerorkpi" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-offerorkpi"></a>

#### Standard KPI blocks <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-standardkpiblocks.1" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-standardkpiblocks.1"></a>

* **Accepted bookings:** The total of bookings accepted by the offeror
* **Cancelled bookings:** The total of bookings cancelled by askers

{% hint style="warning" %} <mark style="color:orange;">A cancelled booking is always cancelled by the asker</mark>
{% endhint %}

* **Expired bookings:** The total of bookings expired due to the offeror not responding
* **Declined bookings:** The total of bookings declined by the offeror
* **Booking requests:** The total number of booking requests received
* **Business volume:** The total business volume made by the offeror through accepted and paid bookings
* **Unique customers:** The total number of unique customers who have made a booking to the offeror
* **Search result appearance:** The total number of appearances in the search results for the offeror’s listings
* **Listing views:** The cumulated number of views of the offeror’s listings
* **My score:** The average rating
* **Average booking amount:** The average purchase volume per booking
* **Average respond time**: The average time it takes the offeror to reply to a message or booking request
* **Booking response rate:** The average booking request with an offeror response (regardless of whether it is declined or accepted)

#### Top KPI blocks <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-topkpiblocks" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-topkpiblocks"></a>

* **Top customers:** The top 10 customers who generated the most business volume through their bookings on the offeror’s listings
* **Top listings:** The top 10 offeror listings generating the most business volume
* **Top countries:** The top 10 countries in which the offeror’s listings generated the most business volume

### Asker KPI <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-askerkpi" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-askerkpi"></a>

#### Standard KPI blocks <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-standardkpiblocks.2" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-standardkpiblocks.2"></a>

* **Accepted bookings:** The total of bookings accepted by offerors
* **Cancelled bookings:** The total of bookings cancelled by the asker

{% hint style="warning" %} <mark style="color:orange;">A booking cancelled is a booking request pending OR a booking paid that is cancelled by the asker</mark>
{% endhint %}

* **Expired bookings:** The total of bookings expired due to offerors not responding
* **Declined bookings:** The total of bookings declined by offerors
* **Booking requests:** The number of booking requests made
* **Purchase volume:** The total purchase volume made by the asker through accepted and paid bookings

### Filters <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-filters" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-filters"></a>

Users can filter KPIs to display more detailed data.

Filter buttons are available in the filter block at the top of the main body (figure 4).

<figure><img src="/files/1wkqK80SylGmKd4wdwrY" alt=""><figcaption><p>figure 4</p></figcaption></figure>

The filters available are:

#### Users roles <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-usersroles" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-usersroles"></a>

The user roles filter is enabled **only for switch platforms**. If a user is both an offeror and an asker, he can select the role dependent KPI data he wants to display (figure 5).

<figure><img src="/files/uRVQIRHtlUD8HofdAOAT" alt=""><figcaption><p>figure 5</p></figcaption></figure>

On a non-switch platform, users will see the KPI data according to their default user role: asker or offeror.

#### Date filter <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-datefilter" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-datefilter"></a>

Users can filter the KPI displayed according to dates.

**Default date range**

A default date range is applied when users first access their KPIs. This default range displays KPIs from the first recorded data until the current date.&#x20;

**Quick filters**

There are 3 quick filters (figure 6) available:

<figure><img src="/files/IC9wA8dT3xaQ1WDzO9ZR" alt=""><figcaption><p>figure 6</p></figcaption></figure>

**This month button**

The “This month” button (figure 6) displays the KPIs of the current month.

This filter will start at the beginning of the current month and end at the current date.

*e.g.: Today is September 13th 2021, the date range will be: from September 1st 2021 to September 13th 2021.*

**This week button**

The “This week” button (figure 6) displays the KPI of the current week.

This filter will start at the beginning of the current week and end at the current day of the week.

*e.g.: The date ranges from Monday of the current week to the current day of the week.*

**Today button**

The “Today” button (figure 6), will display the KPI of the current day.

**Date time picker**

Users can filter their KPI for a given period with the date picker (figure 7) by selecting the start date and end date for the desired period.

<figure><img src="/files/sBwWplVXjamtS92YY5x9" alt=""><figcaption><p>figure 7</p></figcaption></figure>

**Specific day**

Users can display KPI for a specific day by selecting an identical start and end date.

**Date range**

Users can display KPI for a specific date range by selecting different start and end dates.

**Listings**

This filter is only available for the offeror role.

An offeror can have several listings. To view KPIs regarding a given listing, a “Listings” dropdown button (figure 8) is available.

<figure><img src="/files/jl1LRGOeAFWbYOhLDLh5" alt=""><figcaption><p>figure 8</p></figcaption></figure>

### Differential values <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-differentialvalues" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-differentialvalues"></a>

{% hint style="info" %} <mark style="color:blue;">Monitor progress throughout time.</mark>
{% endhint %}

Each standard KPI block displays a differential value (figure 9).

This value is based on the filter date ranges.

<figure><img src="/files/W4Jf18OZ9cpy7dHN6dRM" alt=""><figcaption><p>figure 9</p></figcaption></figure>

#### Differential value based on the same start and end date in the date filter <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-differentialvaluebasedonthes" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-differentialvaluebasedonthes"></a>

If a user selects the same start and end date in the date filter, the differential value will compare the T and T-1 dates' values.

#### Differential value based on a date range with different start and end date <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-differentialvaluebasedonadat" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-differentialvaluebasedonadat"></a>

If a user selects a different start and end date in the date filter, the differential value will compare the T and T-N dates' values.

## Update the KPI <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-updatethekpi" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-updatethekpi"></a>

Users cannot manually update the KPIs.

KPI values are automatically updated.

## Delete the KPI <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-deletethekpi" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-deletethekpi"></a>

Users cannot delete any KPI or top list on their user dashboard homepage.

## Related resources <a href="#id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-relatedresources" id="id-1.14.x-userkpi-basicsolution-sessionsbundle-servicesbundle-rfcbundle-relatedresources"></a>

**Business rules:**

* [Time-Based rendering type - Business rules](/v2.0/core-concepts/time-based-rendering-type.md)
* [Flat-Rate rendering type - Business rules](/v2.0/core-concepts/flat-rate-rendering-type.md)
* [Seat-Based rendering type - Business rules](/v2.0/core-concepts/seat-based-rendering-type.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://features.scnd.com/v2.0/dashboards/user-kpi-homepage/user-kpi-time-based-seat-based-flat-rate-rfc.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
