RevGlance同步历史
查看数据源是否跟上进度、每次同步改动了什么，以及 Webhook 是否正常工作。
每个会同步的数据源都有自己的同步历史：它当前的状况，以及过去 90 天每次同步的日志。当某个数字看起来过时，或 Webhook 似乎没有工作时，请来这里查看。
在哪里找到
- 在 设置 › 数据源 中，打开数据源的“…”菜单，选择 同步历史。
- 在页面底部的同步状态中，选择数据源下方的 同步历史。
只有会同步的数据源才有，因此示例数据没有。
健康状况
此卡片显示数据源当前的状况。
- 状态 为 已是最新、同步中、晚于计划 或 失败。晚于计划 表示上次同步已超过两小时，或失败的同步正在等待下一次尝试。失败 表示数据源存在错误，错误显示在这些字段下方。部分读取 的同步也算在内。错误会一直保留，直到后续同步读取全部内容。
- 上次同步 是 RevGlance 上次读完该数据源的时间。因错误而停止的同步不会改变它。
- 最新数据 是 RevGlance 从该数据源获得的最新付款或订阅变更的日期。
- Webhook 显示服务商的调用是否到达。请参阅 Webhook 状态。
试用结束后，卡片会提示，新的同步会等到您购买 RevGlance 后才进行。
为什么“最新数据”可能早于“上次同步”
上次同步 说明 RevGlance 何时读取了数据源。最新数据 说明找到的数据有多新。同步可能一切正常，却没有找到更新的数据：
- App Store：Apple 的报告大约晚一天到达。
- Google Play：Google 会在 3 到 7 天内发布报告。
- 任何服务商：什么都没有发生。没有付款或订阅变更的平静时期，日期不会变化。
什么会启动同步
同步日志 的每一行都会说明启动同步的原因：
| 标签 | 发生了什么 |
|---|---|
| Webhook | 服务商调用了 RevGlance，告知有内容变化。 |
| 定时 | 常规同步：有人使用该业务时每小时一次，否则每天一次。 |
| 手动启动 | 有人点击了数据源上的 同步 或 立即同步，或关闭了隐私模式。 |
| 首次同步 | 数据源刚刚连接。 |
| 回到应用 | 有人离开 30 天后回来，且该数据源的上次同步已超过一小时。 |
| 完整重新读取 | RevGlance 重新读取了该数据源的全部历史，我们会在计算规则变更后这样做。您无法自行启动。 |
每个数据源在队列中一次只有一个同步等待。等待期间到达的 Webhook 调用会并入其中，因此 Webhook 行可能少于调用次数。
如何阅读日志
最新的同步排在最前面。每行显示开始时间、启动原因；如果是单次同步，还会显示耗时。
计数
同步改动的每类记录都有自己的计数：付款、订阅变更、客户、试用 和 取消订阅。计数为零时不显示。
- 3 条新内容：本次同步添加的记录。
- 2 条已更新：RevGlance 已有、本次同步改动的记录。
- 4 条已移除：本次同步后消失的记录。
无变更 表示同步没有发现需要处理的内容。启动方式相同、连续无变更的同步会折叠为一行，并说明涵盖多少次以及追溯到何时。这样，每小时的同步不会淹没重要的记录。
同步出现问题时
- 运行中：同步仍在进行。页面会自动更新。
- 部分读取：同步已结束，但服务商的部分内容无法读取。该行显示错误。已读取的内容会保存并计入，下一次同步会再次读取同一段。
- 失败：错误使其停止。该行显示错误，停止前读取的内容会保存并计入。在完成前停止。 表示同步被中断，没有可显示的错误。
RevGlance 会自动重试失败的同步，每次尝试都有单独的一行。失败 行上方有一行没有问题的记录，说明问题已经消失，无需处理。如果 状态 仍显示 失败，错误信息会说明问题所在。
已更正的数字
这里列出同步更正的记录数字，并显示旧值和新值。更正不是客户的操作。
- 完整重新读取 之后：任何有变动的合计，例如 MRR、退款或手续费。
- 某个订阅的 MRR：某个订阅的记录金额已更正。
- 某个取消日期：服务商提供的取消日期与记录不同。
每行最多列出五项，之后显示 以及另外 3 项。
Webhook 状态
所有者和管理员可以在 健康状况 中看到 Webhook 的状态。它有四种情况：
- 上次收到调用 和时间：调用正在到达。无需处理。
- 已设置，但尚未收到调用。 数据源已就绪，但服务商尚未调用。请检查是否已在服务商处添加 Webhook。只有发生变化时才会有调用，因此不活跃的数据源可能会保持此状态一段时间。
- 未设置，新数据需等到下一次定时同步。 尚未保存密钥。在您添加 Webhook 之前，新数据会随每小时或每天的同步到达。
- 调用正被拒绝 和最近一次的时间：服务商能访问 RevGlance，但其调用未通过验证，因此不会启动同步。
除第一种情况外，卡片都会链接到您服务商的分步说明。
调用被拒绝时
连续 3 次调用被拒绝后才会显示警告，因此偶尔一次调用不会触发。此时 设置 › 数据源 中数据源的行上也会显示 Webhook 被拒绝。要检查的内容取决于服务商如何验证其调用：
- Stripe, Polar, Lemon Squeezy, Paddle, Recurly：从服务商处重新复制签名密钥，粘贴到数据源 Webhook 面板的 签名密钥 中。
- Gumroad, App Store, Google Play, Chargebee：确认服务商处 URL 中的
?token=与 签名密钥 中保存的密钥一致，或保存新密钥并更新 URL。 - Braintree, Shopify：没有需要粘贴的密钥。请检查 Webhook 是否添加在该数据源所连接的同一个 Braintree 账户或 Shopify 应用中。
发往未保存密钥的数据源的调用也会被拒绝。保存密钥即可解决。
下一次调用通过或您保存新密钥后，警告会消失。如果密钥仍然错误，再有 3 次调用被拒绝后警告会重新出现。上次调用被拒绝 7 天后，警告也会消失。
保留多久
每次同步在日志中保留 90 天，之后会被删除。移除数据源时，其同步历史也会一并移除。
谁能看到什么
业务中的每个人都可以打开数据源的同步历史，阅读 健康状况 和 同步日志。查看者看不到 Webhook 状态：没有 Webhook 字段、徽章或菜单项。启动同步和保存密钥仅限所有者和管理员。请参阅团队和角色。