# 你的榜单排名，放在你自己的页面上。

URL: https://storelift.net/zh/badges/
Language: zh
Updated: 2026-10-13

徽章是一张小图片，显示你的应用今天处在什么位置：它在 App Store 类别榜单里的最好排名，或者它的评分和评分数量。可以放进 README、媒体资料包或你的网站；它会跟着每晚的测量更新。

## 两个徽章，都读取最新的测量

这两张图都是示例，由生成你真实徽章的同一段代码绘制。

- **榜单排名** — 在该店面里，你的应用所属类别的 Top Free、Top Grossing 和 Top Paid 三个榜单中的最好排名。标签会写明它来自哪个榜单。前 10 名以内显示绿色，之后显示琥珀色。
- **评分** — 你在该店面的平均评分，以及它基于多少个评分。4.0 起显示绿色，3.0 起显示琥珀色。

## 怎么把它放到我的页面上？

在“设置 › 徽章”里开启徽章。卡片会给出地址和两段可以直接复制的代码，并链接到你的 App Store 页面。

### Markdown（GitHub、GitLab、文档）

```markdown
[![App Store rank](https://storelift.net/v1/badge/<token>/rank.svg)](https://apps.apple.com/app/id<your-app-id>)
```

### HTML（网站、媒体资料包）

```html
<a href="https://apps.apple.com/app/id<your-app-id>"><img src="https://storelift.net/v1/badge/<token>/rank.svg" alt="App Store rank" height="20"></a>
```

### 参数

| | |
|---|---|
| rank.svg / rating.svg | 选择哪个徽章。两者用的是同一个链接，只有文件名不同。 |
| cc | 两个字母的店面代码，例如 cc=de。默认值：你为这个应用追踪的第一个店面。 |
| theme | light（默认）或 dark。 |
| size | sm（默认，高 20 px）或 lg（高 28 px）。 |

## 测量结果是什么，徽章就显示什么

徽章上的每个数字都来自测量。

- **未进入前 100** — 如果应用在该店面所属类别的三个榜单里都没有上榜，徽章会如实写明，并用中性的灰色显示。
- **未测量** — 对于还没有测量过的店面，徽章会显示“not measured”，直到第一次测量完成。
- **你关掉，它就停** — 关闭徽章后，它的链接立即失效。再次开启会生成新的链接，所以每一个有效的链接，都是你自己开启的。

## 常见问题

### 排名来自哪个榜单？

来自你的应用所属的类别，在你选择的店面里。Storelift 读取 Top Free、Top Grossing 和 Top Paid 三个榜单，显示其中最好的一个；标签会写明是哪一个。

### 它多久变一次？

徽章显示的是所选应用和店面现有的榜单或评分记录。与其他结果比较之前，请先在仪表盘里核对对应日期的观测记录。

### 支持 Google Play 吗？

徽章读取的是 App Store 的榜单和评分。Play 的数字在你的仪表盘和 API 里。

### 谁可以开启徽章？

工作区的成员、管理员和所有者，在“设置 › 徽章”里操作。查看者可以看到已开启的徽章。

### 能知道有没有人看它吗？

能。“设置”里的卡片会统计图片从 Storelift 加载了多少次。

### 要花钱吗？

不用。所有套餐都有徽章，包括 Free 套餐，加载徽章也不消耗 API 额度。

## 把数字放到大家本来就在看的地方。

添加你的应用，等第一次测量完成，然后在“设置”里开启徽章。