项目设置
项目的名称、平台、图标、对用户的称呼、环境、已验证的 Apple 和 Android 应用、保留期限和密钥。
一个项目存放一个产品的事件:一个应用,以及它的网站和后端(如果有的话)。每个项目都有一个随机的公开 id,比如 3f9a1c7e20bd,用于在控制台地址和 API 中标识它。这个 id 不透露项目的任何信息。
从项目菜单或命令菜单打开 Project settings。项目所属组织中的每个人都能查看设置;只有所有者才能修改。


名称
在 Lyrelog 各处显示的名称。
平台
所有向这个项目发送事件的来源。用 Add 逐个添加:iOS app、Mac app、Android app、Website 或 Server。一个项目可以同时包含一个应用、它的网站和后端,控制台也可以单独显示每一个(参见平台)。用平台旁边的 × 按钮将其移除。
如果有事件来自尚未配置的平台,这一部分会提示你,并提供添加入口。
每个平台都有各自的详细信息:
| 平台 | 详细信息 |
|---|---|
| iOS app、Mac app | 它在 App Store 中的页面。可以搜索 App Store,或粘贴应用的链接(apps.apple.com/…/id1234567890),并选择要搜索的 App Store country。关联后会从商店页面获取应用的名称、链接和图标。Unlink 可以取消关联。 |
| Android app | 它的包名(com.example.app)或 Google Play 链接。如果应用已上架 Google Play,Lyrelog 会获取它的名称和图标。 |
| Website | 它的地址(example.com)。如果网站有可用的图标,Lyrelog 会获取它。 |
| Server | 它的语言:Node、Python、Go、Java、Kotlin、Swift、Ruby、PHP、.NET、Rust、Elixir 或 Other。 |
App Store、Google Play 和网站的查询由 Lyrelog 的服务器完成。你的浏览器只负责加载图片。
谁在使用?
What to call them:Lyrelog 在每个页面上称呼你的用户时使用的词。可以选择 users、players、customers、members、readers、listeners、students 或 clients,也可以选择 Another word(填写单数和复数形式)。默认为 users。
图标
在 Lyrelog 各处显示在项目旁边。可以用 Use this one 从项目的某个平台获取图标(App Store、Google Play 或 Website,如果它们有的话),也可以上传你自己的图标:拖入或选择一张正方形图片,格式为 PNG、JPEG、WebP 或 GIF,最大 1 MB(不支持 SVG)。Remove 会移除上传的图标。
环境
开发、测试和生产构建都发送到同一个项目,每个事件都会注明它来自哪个环境。Default environment 是控制台默认打开的环境,直到有人在顶栏中选择其他环境为止。除非修改过,否则它是 production;也可以设为默认打开所有环境。这一部分还会说明每个 SDK 如何确定事件的环境(参见环境)。
告警
在 Pro 和 Business 套餐中,出现新类型的错误、某个错误激增或某个版本开始频繁出错时发送邮件。每个人在 Email me 下打开自己想要的告警;所有者决定项目发送哪些告警及其阈值。参见告警。
来自 Apple 应用的已验证事件
项目包含 iOS app 平台时显示。添加你每个 Apple 应用的 App ID,最多 10 个:格式为 Team ID、一个点和 bundle id,例如 ABCDE12345.com.example.app。Team ID 可以在你的 Apple Developer 账户的 Membership 下找到。设置了 App ID 后,Swift SDK(React Native 和 Flutter 底层也是它)会用 Apple 的 App Attest 证明事件来自真实 iPhone、iPad 或 Apple Watch 上你自己的应用,这些事件到达时即为已验证。应用还需要开启 App Attest capability。没有 App ID 时,来自你的应用的事件以未验证状态到达。用 App ID 旁边的 × 按钮将其移除。
下方的 Accept only verified events from the iOS app(默认关闭,且只有设置了 App ID 后才可用)会暂缓接收来自 iOS 应用的未验证事件,直到它们能够证明自身。如果还有用户在使用不带 App Attest 的版本,请保持关闭:它的作用。
来自 Android 应用的已验证事件
项目包含 Android app 平台时显示。添加每个应用的 package,例如 com.example.app(如果 Android app 平台已填写包名,会自动带入),以及签名所用证书的 SHA-256 fingerprint(与 Play Console 中显示的格式相同,AB:CD:...)。对于每个为发送事件的构建签名的证书,都要再添加一次同一个包名:每个包最多 5 个证书,最多 10 个包。设置之后,Android SDK(React Native 和 Flutter 底层也是它)会用 Key Attestation 证明事件来自真实 Android 设备上你自己的应用,这些事件到达时即为已验证。没有设置时,来自你的 Android 应用的事件以未验证状态到达。用证书旁边的 × 按钮将其移除。
下方的 Accept only verified events from the Android app(默认关闭,且只有设置了包名后才可用)会暂缓接收来自 Android 应用的未验证事件,直到它们能够证明自身。如果还有用户在使用不带 Key Attestation 的版本,请保持关闭:它的作用。
事件保留期限
7、14、30、60、90 或 180 天,或者 1 年。更早的事件会自动删除。延长期限会立即生效。缩短期限前会先征求确认,因为早于新期限的事件会在几小时内被永久删除。参见保留期限。
套餐
组织的套餐及本月的事件数。组织内的所有项目共用一个套餐,所以它们的事件数合并计算。参见套餐与用量。
有访问权限的人
项目所属组织中的每个人都能看到该组织的所有项目。这一部分链接到组织页面,所有者可以在那里邀请人员和更改角色。参见组织。
API 密钥
API keys:你的应用用来发送事件的密钥,以及脚本用来读取事件的密钥。创建时填写名称并选择权限范围(Send events、Send events from a server、Read events、Full access),在密钥显示时复制下来,不再需要时将其撤销。每个密钥都会显示上次使用的时间。参见密钥。
详情
项目 id、slug、事件保留多久,以及项目的创建时间。
某个用户的数据
按用户 id 找到你的某个用户,下载其事件或将其删除,以响应隐私请求。这一部分的名称会使用项目的称呼(“A player's data”)。参见某个用户的数据。
危险操作区
只有所有者才能看到。删除项目。