What is a metric?
A metric is one named number, for example Room revenue, Occupancy, Sessions or Conversion rate. In Indicate every metric is a definition: Which fields to read, how to filter them and how to add them up. That can be a sum, a count or an average. Metrics are what you pick when you build a widget, ask Resi or connect an AI assistant. Nobody queries the raw tables. Everybody queries the metric, and the metric returns the same answer every time.
Three more words belong to it:
KPI collection: A set of metrics and dimensions that belong together, for example everything a shop delivers. Managed collections come with an integration, and your team builds custom ones in
KPI Studio.Insight: A KPI collection connected to a source. This is what widgets read. See Insights.
Dimension: What a metric can be split by. A Grouping dimension such as Booking channel gives one value per channel. A Perspective dimension is a date, for example the arrival date or the booking date, and decides which period a record counts in. See Grouping and perspective.
The numbers in Indicate mirror your source system. Indicate reads what the PMS, the ad platform or the shop delivers through its interface, applies the metric definition and returns the result. If a value looks wrong, the cause is almost always in the source or in how a field is defined there.
Where do I see which metrics I have?
There are three places, depending on what you want to know.
Before you connect: The Catalog of an integration
Open Data sources → Marketplace, click the name of an integration and click the Catalog tab. It lists every KPI the integration delivers, with its description, kind, type, aggregation and dimensions. Click a KPI to see its dimensions with their scope, Grouping or Perspective.
With numbers: The Insights tab of an Insight
Open Data sources → Insights, click an Insight and click a metric on the left. The panel shows the figures for the period, Sum, Mean, Median, Min, Max, Count, First and Last, and a chart. Change the Time range, Group by time, Group by and Search in time by, and add filters to see how the metric behaves. Nothing is saved here. See Insights.
Hover over the icon i next to a metric to read its description. If a metric shows no data for the last 30 days, widen the time range. Some metrics, for example forecasts, only hold values in the future and need a preset such as Next 30 days.
The definitions: KPI Studio
Open Data sources → KPI Studio. The page KPI collections lists every collection in your space with its status, Active, Deprecated or Draft, and whether it is Managed or Custom. It also shows how many metrics and dimensions a collection holds.
Click a collection to open it:
Metrics: Every metric with its unit and description. Edit in studio opens the definition.
Dimensions: Every dimension with its scope, Grouping or Perspective, its type, and which metrics use it.
Sharing and Settings: Who else can use the collection, and its name, description and version.
How do managed and custom metrics differ?
Managed metrics come with an integration. Indicate defines and maintains them, and they cover the standard figures of that system, such as revenue, occupancy, sessions and conversions. You cannot edit them, but you can read every definition.
Custom metrics are defined by your team or your agency in
KPI Studio. They cover figures your business needs that a managed collection does not carry, or calculations on top of imported data. Publish the collection as an Insight to use its metrics in widgets. See Build a custom KPI in KPI Studio and Publish a KPI collection as an Insight.
Where do the numbers come from?
Every metric reads from the tables a connection has synced, or from a table you imported. The connection writes what the source delivers, and the metric definition turns it into one number. This has two consequences:
What arrives is what you see. A record that exists twice in the source appears twice here. A field that is empty in the source is empty here.
An interface can deliver data differently from what the source shows on screen. The PMS interface may deliver revenue without VAT, while the PMS screen shows it with VAT. Both are right, because they describe different things. Timing can differ too: A PMS may spread a five-night stay over five days on screen, but deliver the whole amount on the check-out day.
If you are unsure how a field is delivered, ask support.
Troubleshooting
Why are my numbers wrong?
Most of the time the source is set up in a way that produces these numbers. Typical hotel examples are a room category created twice or a reservation entered under two profiles. Another is a virtual category such as Double room for families next to Double room for the same physical room. Indicate receives all of them as separate records. Clean up the categories in the PMS, and the metric follows.
If the source is clean, the definition may be wrong, for example an average where a sum is needed. For a custom metric, open it in
KPI Studio, test it and fix the definition. For a managed metric, contact support.
Why do the numbers differ from my source system?
- Check what the field contains. Revenue with or without VAT, and revenue per night versus revenue on the billing day, are the usual reasons. Open the Catalog of the integration to read the description of the metric.
Why are many values empty or misspelled?
- A free-text field in the source stays free text here, with every typo. A field that is not mandatory in the source is often empty. Fix the entries in the source, because the metric cannot correct them.
Why does a metric have no data at all?
The module behind it is not in use in the source system, so the source produces no data for it. Check in the source whether the feature is active and licensed.
Personal data was switched off when the connection was made, so metrics that need person-related fields stay empty. Open the connection under
Data sources→Connections, check its Settings tab, and reconnect with PII (personally identifiable information) on if you need those fields.The time range is off. Widen it to All time, or use a preset such as Next 30 days for metrics that only hold future values.
How do I get a metric the integration does not have?
- Build it in
KPI Studioon top of the synced tables and publish the collection as an Insight. See Build a custom KPI in KPI Studio.