抢先体验仅限邀请,SDK 尚未发布。申请邀请
跳到正文
文档

平台

一个项目可以同时容纳应用、它的网站和它的后端,控制台也能单独显示其中每一个。

一个项目可以接收来自产品多个部分的事件:一款游戏的 iOS 应用、网站和 API 都可以发往同一个项目。这样就能跨这些部分追踪同一个用户 (按 user_id),而控制台仍然可以一次只显示其中一个部分。

这件事有两个方面:每个事件上的 platform 字段,以及你在项目中设置的平台列表。

每个事件上的平台

每个事件都带有 platform:表示它来自产品的哪个部分。各 SDK 发送的值如下:

SDK平台
Swift操作系统:ios、macos、tvos 或 visionos;watchOS 上为 apple
Androidandroid
React Native、Flutter操作系统,取自底层的原生 SDK:ios 或 android
JavaScript浏览器中为 web,Node 中为 node
Pythonpython
Gogo
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 筛选,而不是按项目的平台列表。