App Center Analytics (React Native)

App Center Analytics 可帮助你了解用户行为和客户参与度,以改进应用。 SDK 会自动捕获会话计数和设备属性,例如模型、OS 版本等。可以定义自己的自定义事件来度量重要的事项。 所有捕获的信息均在 App Center门户中提供,供你分析数据。

如果 尚未在应用程序中 设置 SDK,请遵循入门部分。

会话和设备信息

将 App Center Analytics 添加到应用并启动 SDK 后,它会自动跟踪会话和设备属性,如 OS 版本、模型等。无需编写任何其他代码。

自定义事件

使用最多 20 个属性跟踪自己的自定义事件,以了解用户与应用之间的交互。

启动 SDK 后,使用 trackEvent 方法通过属性跟踪事件。 可以发送 最多 200 个不同的事件名称。 此外,每个事件名称的最大限制为 256 个字符,每个事件属性名称和事件属性值的最大限制为 125 个字符。

// import App Center Analytics at the top of the file.
import Analytics from 'appcenter-analytics';

Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' });

此函数返回 promise,成功案例返回空字符串,错误案例返回错误。

事件的属性是可选的;如果只想跟踪事件,请改为使用以下方法:

Analytics.trackEvent('Video clicked');

在运行时启用或App Center Analytics

可以在运行时启用和App Center Analytics。 如果禁用它,SDK 将不会为应用收集任何其他分析信息。

await Analytics.setEnabled(false);

此函数返回解析为 void 的 promise。

若要再次App Center Analytics,请使用相同的 API,但作为 true 参数传递。

await Analytics.setEnabled(true);

状态在应用程序启动时一直保留于设备的存储中。

检查App Center Analytics 是否已启用

还可以检查是否App Center Analytics。

const enabled = await Analytics.isEnabled();

此函数返回解析为 的 boolean promise。

等待 JS 启用 App Center Analytics

如果要为应用用户收集分析信息,但希望先获取用户权限,可以选择在启动时不启用分析,但等到适当的时间,改为在 JavaScript 中启用它。

  1. 打开项目的 文件 ios/YourAppName/AppDelegate.m ,将 [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:true]; 替换为 [AppCenterReactNativeAnalytics registerWithInitiallyEnabled:false];
  2. 打开项目的 文件 android/app/src/main/res/values/strings.xml ,将 <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ALWAYS_SEND</string> 替换为 <string name="appCenterAnalytics_whenToEnableAnalytics" moduleConfig="true" translatable="false">ENABLE_IN_JS</string>

这意味着,若要将任何信息发送到 App Center (甚至基本会话) ,必须先通过将以下行添加到其代码,在应用中启用 App Center Analytics。

await Analytics.setEnabled(true);

本地存储大小

默认情况下,SDK 在存储中最多存储 10MB 的日志。

无法访问 Internet

没有任何网络连接时,SDK 在本地存储中最多保存 10MB 的日志。 存储已满后,SDK 将开始丢弃旧日志,为新日志提供空间。 设备重新访问 Internet 后,SDK 将每隔 50 秒或每 6 秒发送一次日志。

批处理事件日志

App Center SDK 批量上传日志,如果 SDK 没有要发送的 50 个日志,它仍将在 6 秒后发送日志。 最多可以并行发送 3 个批处理。

重试和退市逻辑

App Center SDK 支持在可恢复网络错误时进行退步重试。 下面是重试逻辑:

  • 每个请求最多尝试 3 次。
  • 每个请求都有自己的重试状态机。
  • 所有传输通道在 1 (次请求耗尽其所有重试) 下一个应用进程之前被禁用。

退市逻辑

  • 50% 随机化,第一次重试 5 到 10 秒,第二次重试 2.5 到 5 分钟,最后尝试 10 到 20 分钟。
  • 如果网络从关闭切换到 (从 wi-fi 切换到移动) ,将重置重试状态,并立即重试请求。