Revenue Per Visitor (RPV)

The Revenue Per Visitor (RPV) metric measures the average revenue generated per visitor within a specified time period. It helps you understand the efficiency of your traffic in driving revenue.

Metric model

Name
metric
Type
string
Description
Always revenue-per-visitor for this metric.
Name
value
Type
float
Description
Current RPV value.
Name
previous
Type
float
Description
RPV value from the previous period.
Name
change
Type
float
Description
Percent change from previous to current.
Name
formattedValue
Type
string
Description
Human-friendly current RPV.
Name
formattedPrevious
Type
string
Description
Human-friendly previous RPV.
Name
period.id
Type
string
Description
Time period identifier (e.g., 7d).
Name
period.name
Type
string
Description
Label for the selected time period.
Name
periodRange.current.start
Type
string
Description
ISO timestamp for current range start.
Name
periodRange.current.end
Type
string
Description
ISO timestamp for current range end.
Name
periodRange.previous.start
Type
string
Description
ISO timestamp for previous range start.
Name
periodRange.previous.end
Type
string
Description
ISO timestamp for previous range end.
Name
performance.duration
Type
float
Description
Time taken to fetch this metric.
Name
performance.formatted
Type
string
Description
Duration formatted (e.g., 999 ms).

GET/api/metrics/revenue-per-visitor

Retrieve RPV metric

The endpoint returns the revenue-per-visitor metric over a selected time period.

Optional query parameters

Name
period
Type
string
Description
The time range to query. Common options:
- today
- yesterday
- 7d
- 30d
- this_month
View full list of supported periods →

Request

GET

/api/metrics/revenue-per-visitor

curl -G http://localhost:3000/api/metrics/revenue-per-visitor \
  -H "Authorization: Bearer {token}" \
  -d period=7d

Response

{
  "metric": "revenue-per-visitor",
  "value": 0.18,
  "previous": 0.18,
  "change": -2.41,
  "formattedValue": "€ 0,18",
  "formattedPrevious": "€ 0,18",
  "period": {
    "id": "7d",
    "name": "Last 7 days"
  },
  "periodRange": {
    "current": {
      "start": "2025-03-16T08:50:55.027Z",
      "end": "2025-03-23T08:50:55.026Z"
    },
    "previous": {
      "start": "2025-03-09T08:50:55.028Z",
      "end": "2025-03-16T08:50:55.027Z"
    }
  },
  "performance": {
    "duration": 998.54,
    "formatted": "999 ms"
  }
}

Use cases

Benchmark revenue against visitor traffic
Compare RPV across channels or segments
Optimize campaigns for higher visitor value