Back to Details

revenuecat-charts

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Accessing RevenueCat charts

访问RevenueCat图表

Use the following two tools of the RevenueCat MCP:
  • get-chart-options-schema
    : To understand the available options for each chart, including date resolution, segments, filters, and other selectors
  • get-chart-data
    : To retrieve data for a chart
In general, to avoid clogging the context, start with defined timeframes and larger resolution, then narrow down.
使用RevenueCat MCP的以下两个工具：
  • get-chart-options-schema
    ：了解每个图表的可用选项，包括日期分辨率、细分维度、筛选器和其他选择器
  • get-chart-data
    ：检索图表的数据
一般来说，为避免上下文冗余，先从已定义的时间范围和更大的分辨率开始，再逐步缩小范围。

Interpreting metrics

指标解读

Subscription apps are driven by four forces:
Acquisition - how many new customers are arriving to the app Conversion - how many of those customers are converting into trials or paid paid plans Retention - how long do those customers retain Reactivation - how can you bring back old users
The net movement of an apps revenue will be the result of the combination of these forces. When giving advice, always use benchmark data to make sure you aren't incorrectly diagnosing an issue.
订阅类应用受四个核心因素驱动：
获客 - 有多少新用户进入应用 转化 - 这些用户中有多少转化为试用用户或付费订阅用户 留存 - 用户的留存时长 重新激活 - 如何召回老用户
应用收入的净变化是这四个因素共同作用的结果。提供建议时，务必使用基准数据，确保不会错误诊断问题。

Acquisition

获客

  • Use the New Customers chart to understand how much top of funnel the app is driving.
  • Segmenting New Customers by Country, or Apple Search Ads dimensions can be helpful in informing acquisition
  • 使用“新客户”图表了解应用的漏斗顶部流量情况。
  • 按国家或Apple Search Ads维度细分新客户数据，有助于为获客策略提供依据

Conversion

转化

The definition of conversion may vary depending on what model the app is using. They may be converting to a trial, that then converts into a subscription. Or they may be sending users directly to a subscription.
  • Use the Initial Conversion chart to see how many trial or subscriptions are started.
  • You can then further determine if they are using free trials by comparing that to the New Trials chart
  • The Trial Conversion Rate chart is a helpful chart for understanding the performance of just that trial conversion
转化的定义可能因应用采用的模式而异。应用可能让用户先转化为试用用户，再转化为订阅用户；也可能直接引导用户订阅。
  • 使用“初始转化”图表查看有多少用户开始试用或订阅。
  • 你可以将其与“新试用用户”图表对比，进一步确认应用是否提供免费试用
  • “试用转化率”图表有助于了解试用转化环节的表现

Retention

留存

  • The Churn chart will tell you the % of the active subscriber base that is lost each period. It can be difficult to interpret or benchmark because it is a blend of different periods.
  • When you want to understand the long term retention of different products, look at the Subscription Retention chart
  • “流失率”图表会显示每个周期内流失的活跃订阅用户占比。由于该指标融合了不同周期的数据，解读和基准对比可能较为困难。
  • 若要了解不同产品的长期留存情况，请查看“订阅留存”图表

Reactivation

重新激活

  • The only real way to understand Reactivation is looking at the MRR Movement chart and the Resubscription MRR
  • 了解重新激活情况的唯一有效方式是查看“MRR变动”图表和“重新订阅MRR”数据

Dashboard URL Format

仪表盘URL格式

IMPORTANT: Use this exact structure:
https://app.revenuecat.com/projects/{project_id}/charts/{chart_name}?range={range_value}
  • {project_id}
    — The short hex ID (e.g., 
    56965ae1
    ), NOT the full 
    proj56965ae1
  • {chart_name}
    — Chart name like 
    revenue
    , 
    churn
    , 
    mrr
    , etc.
  • Project ID goes in the path, not as a query parameter
Correct example:
https://app.revenuecat.com/projects/56965ae1/charts/revenue?range=Last+90+days%3A2025-11-16%3A2026-02-13
WRONG — do not use:
https://app.revenuecat.com/charts/revenue?project=proj56965ae1&chart_start=...&chart_end=...
重要提示：请严格使用以下结构：
https://app.revenuecat.com/projects/{project_id}/charts/{chart_name}?range={range_value}
  • {project_id}
    — 短十六进制ID（例如：
    56965ae1
    ），而非完整的
    proj56965ae1
  • {chart_name}
    — 图表名称，如
    revenue
    、
    churn
    、
    mrr
    等
  • Project ID需放在路径中，而非查询参数
正确示例：
https://app.revenuecat.com/projects/56965ae1/charts/revenue?range=Last+90+days%3A2025-11-16%3A2026-02-13
错误示例 — 请勿使用：
https://app.revenuecat.com/charts/revenue?project=proj56965ae1&chart_start=...&chart_end=...

Query Parameters

查询参数

Date Range (
range
) — REQUIRED

日期范围 (
range
) — 必填

The 
range
parameter controls the date range. Format: 
{preset}:{start_date}:{end_date}
You must use this format — do NOT use 
start_date
, 
end_date
, 
chart_start
, or 
chart_end
params.
PresetEncoded Value
Last 7 days
range=Last+7+days%3A2026-02-06%3A2026-02-13
Last 28 days
range=Last+28+days%3A2026-01-16%3A2026-02-13
Last 90 days
range=Last+90+days%3A2025-11-16%3A2026-02-13
Last 365 days
range=Last+365+days%3A2025-02-13%3A2026-02-13
Custom
range=Custom%3A2025-01-01%3A2025-12-31
Note: The 
:
between parts must be URL-encoded as 
%3A
. Spaces become 
+
.
range
参数控制日期范围。格式：
{preset}:{start_date}:{end_date}
必须使用此格式 — 请勿使用
start_date
、
end_date
、
chart_start
或
chart_end
参数。
预设选项编码后的值
最近7天
range=Last+7+days%3A2026-02-06%3A2026-02-13
最近28天
range=Last+28+days%3A2026-01-16%3A2026-02-13
最近90天
range=Last+90+days%3A2025-11-16%3A2026-02-13
最近365天
range=Last+365+days%3A2025-02-13%3A2026-02-13
自定义
range=Custom%3A2025-01-01%3A2025-12-31
注意：各部分之间的
:
必须URL编码为
%3A
，空格需替换为
+
。

Resolution (
resolution
)

分辨率 (
resolution
)

ValueMeaning
day
Daily granularity
week
Weekly granularity
month
Monthly granularity
quarter
Quarterly granularity
year
Yearly granularity
值含义
day
按日粒度展示
week
按周粒度展示
month
按月粒度展示
quarter
按季度粒度展示
year
按年粒度展示

Segment (
segment_by
)

细分维度 (
segment_by
)

Dimension to break down the data by. Common values:
  • country
    — by country
  • store
    — by app store (App Store, Play Store, etc.)
  • product
    — by product identifier
  • platform
    — by platform (iOS, Android, etc.)
  • offering
    — by offering
用于拆分数据的维度，常见值：
  • country
    — 按国家拆分
  • store
    — 按应用商店（App Store、Play Store等）拆分
  • product
    — 按产品ID拆分
  • platform
    — 按平台（iOS、Android等）拆分
  • offering
    — 按套餐拆分

Filters

筛选器

Filters are passed as individual query params with the filter name as key:
FilterExample
country
country=US
store
store=app_store
product_identifier
product_identifier=premium_monthly
platform
platform=iOS
Multiple values for the same filter: 
country=US&country=DE&country=JP
筛选器作为独立的查询参数传递，筛选器名称作为参数键：
筛选器示例
country
country=US
store
store=app_store
product_identifier
product_identifier=premium_monthly
platform
platform=iOS
同一筛选器的多个值：
country=US&country=DE&country=JP

Chart-Specific Selectors

图表专属选择器

Some charts have special selectors:
Conversion/Retention charts:
  • customer_lifetime
    — e.g., 
    30+days
    , 
    60+days
    , 
    90+days
  • conversion_timeframe
    — e.g., 
    7+days
    , 
    14+days
    , 
    30+days
Workflow charts:
  • path
    — workflow path filter
  • workflows_customer_lifetime
    — e.g., 
    initial
部分图表有特殊选择器：
转化/留存图表：
  • customer_lifetime
    — 例如：
    30+days
    , 
    60+days
    , 
    90+days
  • conversion_timeframe
    — 例如：
    7+days
    , 
    14+days
    , 
    30+days
工作流图表：
  • path
    — 工作流路径筛选器
  • workflows_customer_lifetime
    — 例如：
    initial

Constructing a Link

构建链接

To generate a dashboard link:
  1. Start with base: 
    https://app.revenuecat.com/projects/{project_id}/charts/{chart_name}
  2. Add 
    range
    param with date range
  3. Add any filters as query params
  4. Add 
    segment_by
    if segmenting
  5. Add chart-specific selectors as needed
  6. URL-encode all values (spaces → 
    +
    , colons → 
    %3A
    , etc.)
生成仪表盘链接的步骤：
  1. 以基础链接开头：
    https://app.revenuecat.com/projects/{project_id}/charts/{chart_name}
  2. 添加
    range
    参数设置日期范围
  3. 添加所需的筛选器作为查询参数
  4. 如需细分数据，添加
    segment_by
    参数
  5. 根据需要添加图表专属选择器
  6. 对所有值进行URL编码（空格→
    +
    ，冒号→
    %3A
    等）

API to Dashboard Parameter Mapping

API到仪表盘参数的映射

When translating from API parameters to dashboard URLs:
API ParameterDashboard Parameter
start_date
+ 
end_date
range=Custom%3A{start}%3A{end}
(use 
Custom
preset)
segment
segment_by
filters
(JSON array)		Individual query params
selectors
(JSON object)		Individual query params
Note: Do NOT pass 
resolution
as a numeric value. The resolution is typically implied by the range preset or omitted.
将API参数转换为仪表盘URL时：
API参数仪表盘参数
start_date
+ 
end_date
range=Custom%3A{start}%3A{end}
（使用
Custom
预设）
segment
segment_by
filters
（JSON数组）		独立的查询参数
selectors
（JSON对象）		独立的查询参数
注意：请勿将
resolution
作为数值传递。分辨率通常由范围预设隐含，或可省略。

Example: Building a Link

示例：构建链接

User wants: "Revenue chart for last 90 days, segmented by country, filtered to US and Germany"
Calculate dates: if today is 2026-02-13, then 90 days ago is 2025-11-16.
https://app.revenuecat.com/projects/56965ae1/charts/revenue?range=Last+90+days%3A2025-11-16%3A2026-02-13&segment_by=country&country=US&country=DE
User wants: "Churn chart from August 2025 to now"
Use the 
Custom
preset for arbitrary date ranges:
https://app.revenuecat.com/projects/56965ae1/charts/churn?range=Custom%3A2025-08-01%3A2026-02-13
用户需求：“最近90天的收入图表，按国家细分，筛选美国和德国”
计算日期：如果今天是2026-02-13，那么90天前是2025-11-16。
https://app.revenuecat.com/projects/56965ae1/charts/revenue?range=Last+90+days%3A2025-11-16%3A2026-02-13&segment_by=country&country=US&country=DE
用户需求：“2025年8月至今的流失率图表”
对任意日期范围使用
Custom
预设：
https://app.revenuecat.com/projects/56965ae1/charts/churn?range=Custom%3A2025-08-01%3A2026-02-13

Getting Project ID

获取Project ID

The project ID can be found via the API:
  • GET /projects
    — lists all projects with their IDs
  • API returns IDs like 
    proj56965ae1
  • For dashboard URLs, strip the 
    proj
    prefix     — use just 
    56965ae1
    in the path
Project ID可通过API获取：
  • GET /projects
    — 列出所有项目及其ID
  • API返回的ID格式如
    proj56965ae1
  • 对于仪表盘URL，请去掉
    proj
    前缀     — 仅在路径中使用
    56965ae1