App Center Analytics （Android）

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

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

会话和设备信息

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

国家/地区代码

如果设备安装了移动数据调制解调器和 SIM 卡，SDK 会自动报告用户的国家/地区代码。 默认情况下，仅 WiFi 设备不会报告国家/地区代码。 若要设置这些用户的国家/地区代码，必须自行检索用户的位置并使用 setCountryCode: SDK 中的方法：

AppCenter.setCountryCode("en");

AppCenter.setCountryCode("en")

自定义事件

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

启动 SDK 后，使用trackEvent()方法通过属性来跟踪事件。 最多可以发送 200 个不同的事件名称。 此外，还有最大字符限制：

• 每个 event name字符 256 个字符。
• 每 event property name 和 event property value 125 个字符。

Map<String, String> properties = new HashMap<>();
properties.put("Category", "Music");
properties.put("FileName", "favorite.avi");

Analytics.trackEvent("Video clicked", properties);

val properties = hashMapOf("Category" to "Music", "FileName" to "favorite.avi")
Analytics.trackEvent("Video clicked", properties)

事件的属性是完全可选的 – 如果只想跟踪事件，请改用此示例：

Analytics.trackEvent("Video clicked");

Analytics.trackEvent("Video clicked")

事件优先级和持久性

可以跟踪比其他事件重要性更高的业务关键事件。

• 开发人员可以将事件优先级设置为 “正常 ”（Flags.NORMAL 在 API 中）或 “关键 ”（Flags.CRITICAL 在 API 中）。
• 优先级设置为 “关键 ”的事件将首先从存储中检索，并在 正常 事件之前发送。
• 当本地存储已满并且需要存储新事件时，首先会删除优先级最低的最早事件。
• 如果存储充满了具有 严重 优先级的日志，则跟踪具有 正常 优先级的事件将失败，因为 SDK 在这种情况下无法腾出空间。
• 如果使用 崩溃 服务，崩溃日志将设置为 “严重 ”，并共享与事件相同的存储。
• 传输间隔仅适用于 正常 事件， 关键 事件将在 3 秒后发送。

可以使用以下 API 将事件跟踪为 严重事件：

Map<String, String> properties = new HashMap<>();
properties.put("Category", "Music");
properties.put("FileName", "favorite.avi");

Analytics.trackEvent("eventName", properties, Flags.CRITICAL);

// If you're using name only, you can pass null as properties.

val properties = hashMapOf("Category" to "Music", "FileName" to "favorite.avi")
Analytics.trackEvent("Video clicked", properties, Flags.CRITICAL)

// If you're using name only, you can pass null as properties.

暂停和恢复发送日志

当应用需要控制网络带宽以满足更多业务关键需求时，暂停事件传输非常有用。 可以暂停将日志发送到 App Center 后端。 暂停时，仍可以跟踪和保存事件，但不会立即发送事件。 应用在暂停时跟踪的任何事件只有在调用 resume后才会发送。

Analytics.pause();
Analytics.resume();

Analytics.pause()
Analytics.resume()

在运行时启用或禁用 App Center Analytics

可以在运行时启用或禁用 App Center Analytics。 如果禁用它，SDK 不会为应用收集更多分析信息。

Analytics.setEnabled(false);

Analytics.setEnabled(false)

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

Analytics.setEnabled(true);

Analytics.setEnabled(true)

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

此 API 是异步的，可以在 App Center 异步 API 指南中详细了解该 API。

检查是否已启用 App Center Analytics

还可以检查 App Center Analytics 是否已启用。

Analytics.isEnabled();

Analytics.isEnabled()

此 API 是异步的，可以在 App Center 异步 API 指南中详细了解该 API。

管理启动会话

默认情况下，会话 ID 取决于应用程序的生命周期。 如果要手动控制新会话的开始，请执行以下步骤：

• 在 SDK 启动之前调用以下方法：

Analytics.enableManualSessionTracker();

Analytics.enableManualSessionTracker()

• 然后，可以在startSession之后使用 AppCenter.start API。

Analytics.startSession();

Analytics.startSession()

本地存储大小

默认情况下，SDK 将所有事件日志存储到 10 MB。 开发人员可以使用 API 来增加 存储大小 ，SDK 将一直存储日志，直到存储已满。

无 Internet 访问

如果没有网络连接，SDK 在本地存储中最多保存 10 MB 的日志。 存储完成后，SDK 将开始放弃旧日志，为新日志腾出空间。 网络连接返回后，SDK 会在 50 秒或每 6 秒后发送一批日志（默认情况下）。

批处理事件日志

App Center SDK 在 50 批中上传日志，如果 SDK 没有 50 个要发送的日志，它仍将在 6 秒后（默认情况下）发送日志。 最多可以并行发送三批。 传输间隔可以更改：

// Change transmission interval to 10 seconds.
Analytics.setTransmissionInterval(10000);

// Change transmission interval to 10 seconds.
Analytics.setTransmissionInterval(10000)

传输间隔值必须介于 6 秒到 86400 秒（一天）之间，并且必须在服务启动之前调用此方法。

重试和退让逻辑

App Center SDK 支持对可恢复的网络错误进行回退重试。 下面是重试逻辑：

• 每个请求最多尝试 3 次。
• 每个请求都有自己的重试状态机。
• 在一个请求耗尽所有重试后，所有传输通道都会被禁用，直到应用程序进入下一个处理阶段。

退让逻辑

• 50% 随机化，第一次重试 5 到 10 秒，接下来尝试 2.5 到 5 分钟，最后一次尝试介于 10 到 20 分钟之间。
• 如果网络从关机切换到打开（或从 wi-fi 切换到移动设备），则重试状态将重置，并立即重试请求。