平台
一个项目可以同时容纳应用、它的网站和它的后端,控制台也能单独显示其中每一个。
一个项目可以接收来自产品多个部分的事件:一款游戏的 iOS 应用、网站和 API 都可以发往同一个项目。这样就能跨这些部分追踪同一个用户
(按 user_id),而控制台仍然可以一次只显示其中一个部分。
这件事有两个方面:每个事件上的 platform 字段,以及你在项目中设置的平台列表。
每个事件上的平台
每个事件都带有 platform:表示它来自产品的哪个部分。各 SDK 发送的值如下:
| SDK | 平台 |
|---|---|
| Swift | 操作系统:ios、macos、tvos 或 visionos;watchOS 上为 apple |
| Android | android |
| React Native、Flutter | 操作系统,取自底层的原生 SDK:ios 或 android |
| JavaScript | 浏览器中为 web,Node 中为 node |
| Python | python |
| Go | go |
| JVM(Java 和 Kotlin) | jvm |
如果换一个名称更能说明情况,可以在配置中覆盖它,例如后端用 platform: "api",队列消费者用 platform: "worker"。
命名规则与环境相同:小写字母、数字、- 和 _,最多 32 个字符。
当事件到达时没有平台,服务器会根据 SDK 名称和操作系统推导出一个(iOS 上的 lyrelog-swift 为 ios,
带有 os_name: "web" 的 lyrelog-js 为 web),否则直接取操作系统名称。
项目的平台
在 Settings 中,Platforms 部分列出向项目发送事件的各个部分,每个一张卡片,注明它是什么:
| 平台 | 你提供给 Lyrelog 的信息 | Lyrelog 用它做什么 |
|---|---|---|
| iOS 应用、Mac 应用 | 它的 App Store 页面:按名称搜索或粘贴链接 | 显示应用的名称、开发者、评分、版本和 bundle id |
| Android 应用 | 它的 Google Play 包名(com.example.app)或 Play 链接 | 在 Google Play 上查找应用的名称和图标 |
| 网站 | 它的地址(example.com) | 查找网站的图标 |
| 服务器 | 它的语言:Node、Python、Go、Java、Kotlin、Swift、Ruby、PHP、.NET、Rust、Elixir 或 Other | 显示对应的环境规则 |
这样找到的图标可以用作项目的图标(Settings 中的 Icon)。移除一个平台后,它的信息和图标都会被清除。 当 iOS 应用和 Mac 应用都不剩时,App Store 页面信息也会随之移除。
如果最近 30 天的事件来自项目尚未列出的平台,Settings 会提示这一点,并提供 Add them。事件平台与项目平台的对应关系如下:
ios、tvos 和 visionos 对应 iOS 应用,macos 对应 Mac 应用,android 对应 Android 应用,web 对应网站,
api、node、python、go 和 jvm 对应服务器(已知语言时会带上语言)。网站或 Android 应用会以一张待填写的卡片出现,
因为还需要填入它的地址或包名。
只有所有者可以更改平台。
按平台筛选
- 顶栏: 当项目接收来自多个平台的事件时,环境选择器会增加一个 Platform 部分,列出最近 30 天出现过的每个事件平台, 另外还有 All platforms。这个选择按项目记在浏览器中,并作用于每个页面。参见 环境与平台。
- Explorer: Platform 筛选可以取一个或多个值,也可以排除它们(“Platform is not web”)。
两者都按每个事件上的 platform 筛选,而不是按项目的平台列表。