Analytics自定义UserType仅同步少量用户问题排查求助

我们正尝试通过区分**卡车司机（Truck Driver）和超级用户（Super Users）**两种用户类型配置Analytics追踪。目前功能虽可运行，但仅为约9位用户设置了用户类型，预期至少覆盖50-80位用户。请问我们遗漏了什么？

已列出的假设：

• 假设1：仅新用户会被设置用户类型，现有用户不会。
• 假设2：存在某种限流机制，但我们的用户规模似乎远未达到触发条件。
• 假设3（已排除）：需要先登出再登录（我们已测试此方法，但无效）。

相关代码 #

Analytics服务代码 #

import { inject, Injectable } from '@angular/core';
import { Analytics, setUserProperties } from '@angular/fire/analytics';
import { CustomParams } from '@firebase/analytics';

@Injectable({
  providedIn: 'root',
})
export class AnalyticsService {
  readonly #analytics = inject(Analytics);

  setUserProperties(properties: CustomParams) {
    setUserProperties(this.#analytics, properties, { global: true });
  }
}

获取UserDetails代码 #

#getUserDetails() {
  return this.#gateway.query('GetUser').pipe(
    tap((userDetails) => {
      if (userDetails.betaUser) {
        this.#analytics.setUserProperties({ user_type: userDetails.superUser ? 'superUser' : 'truckDriver' });
      }
    }),
    tap((userDetails) => this.#userDetails$.next(userDetails)),
    catchError((cause: unknown) => {
      if (cause instanceof HttpErrorResponse && cause.status === StatusCodes.UNAUTHORIZED) {
        this.#handleUnauthorizedError();
      } else {
        this.#handleUnknownError();
      }
      throw new Error('Error while retrieving user details', { cause });
    }),
  );
}

1. 核心限制：仅Beta用户会被设置用户类型 #

从getUserDetails的逻辑可以看到，只有当userDetails.betaUser为真时，才会执行用户类型的设置操作。如果你的50-80位目标用户里大部分不是beta用户，那自然不会被纳入Analytics的用户类型追踪，这是最可能的原因。

2. 验证数据返回准确性 #

• 检查GetUser接口返回的betaUser字段：确认非beta用户的该字段是否被错误标记为false，或者接口是否存在返回值不一致的情况。
• 确认superUser字段的正确性：该字段错误只会影响用户类型的分类，不会导致用户完全不被追踪，但也需要验证其返回值是否符合预期。

3. 检查代码执行时机与异常情况 #

• 添加日志输出：在tap操作中打印用户的betaUser和superUser状态，确认哪些用户进入了设置逻辑，哪些没有。
• 确认getUserDetails的调用时机：检查是否存在某些用户场景（如自动登录、离线登录后同步）下，该方法未被触发的情况。

4. 针对假设的验证 #

• 假设1验证：查看现有用户的betaUser状态，如果他们不是beta用户，自然不会被设置。可以临时移除if (userDetails.betaUser)的判断，测试是否能覆盖更多用户。
• 假设2验证：Firebase Analytics的用户属性设置没有针对普通规模用户的限流规则，你的用户量远未达到触发限流的阈值，这个可能性极低。

快速测试方案 #

临时修改代码，移除betaUser的判断条件，部署后观察Analytics中的用户类型覆盖数量：

tap((userDetails) => {
  // 临时注释betaUser判断，验证覆盖范围
  // if (userDetails.betaUser) {
    this.#analytics.setUserProperties({ user_type: userDetails.superUser ? 'superUser' : 'truckDriver' });
  // }
}),

如果覆盖数量明显提升，说明问题确实出在betaUser的限制上。

内容的提问来源于stack exchange，提问作者Paul Cudles