最佳实践

成功接入 DevTools 工具后，可以利用 DevTools 提供的功能辅助增长营销套件 SDK 接入。本文总结了部分利用 DevTools 完成实际开发测试工作中的最佳实践。

在首次接入增长营销套件 SDK 后，开发者一般会对埋点采集上报做验证，包括埋点是否采集成功、内容采集是否符合规范、埋点是否及时上报、数据是否能及时查看等。

使用 DevTools 工具时，开发者可以直接通过 DevTools 显示的接入状态或运行日志进行快速查看埋点采集状态、埋点上报状态、埋点内容等信息。接入信息一目了然。判断增长营销套件SDK接入成功的几个关键信息：

1. SDK 初始化完成

2. 埋点采集成功

3. 埋点上报成功

4. 用户属性等信息正确

开发者在指定的场景下采集约定的埋点时，一般需要对埋点名称、参数名称和类型等信息做调试验证。测试和运营等角色会在特定场景下验证是否采集了正确的埋点内容。

DevTools 提供了实时查看事件（埋点）列表的功能。通过事件列表可以快速且实时查看埋点的完整信息，包含埋点名称、埋点参数名、埋点参数值、埋点的上报状态（含采集成功、上报成功等）。事件列表支持丰富的筛选和搜索功能，可以快速的查找指定的埋点。

在开发新的埋点或测试验收指定埋点时，可以结合 DevTools 提示的异常信息来判断埋点采集的名称和参数是否符合产品定义的规范（在增长分析控制台页面创建的埋点信息）。DevTools 校验埋点规则包含：

• 埋点名称是否合法

• 埋点参数名是否合法

• 埋点参数值类型是否正确

• 埋点参数是否缺失

• 埋点是否是新增未定义的埋点等

在使用 A/B 测试产品进行实验开发时，开发者或测试人员一般需要对不同的实验场景进行验证。

DevTools 提供了实时查询全部实验列表的功能，在实验列表中可以快速检索指定的实验和查看实验的基本信息。实验列表会显示当前设备是否命中了列表中的实验，如果命中后会显示命中的版本名称。

在实验详情中，DevTools 除了显示实验的基本信息和版本信息，同时还支持自定义修改实验命中开关和实验进组版本。开发者和测试人员可以通过使用 DevTools 快速完成实验进组版本切换，然后对不同版本下的业务功能做回归验证。在 DevTools 上修改的实验进组版本仅在当前设备生效，关闭后即可恢复服务端下发的实验配置。

增长营销套件 SDK 在运行时会输出丰富的调试日志，这些日志涵盖了 SDK 运行时各个环节的状态和异常信息，如：

• 初始化状态和参数

• 公共参数采集结果

• 埋点采集状态和参数

• 埋点上报状态和网络请求结果

• 异常和错误信息等

DevTools 支持实时显示 SDK 运行的日志，同时提供了丰富的筛选和搜索功能。浏览日志确认 SDK 运行状态。一般地，调试日志可以帮助开发者排查大多数的埋点采集、埋点上报、数据异常等问题。开发者不仅可以使用 DevTools 自助排查埋点数据相关问题，也可以将全部日志导出并发送给技术支持人员进行辅助排查。