你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
有关将自定义标记添加到客户端遥测的教程
本教程介绍如何将自定义数据属性（称为“诊断选项”标记）添加到由 WebJS 客户端发送至 Azure Monitor 的遥测数据。 此遥测可用于通话后的分析。
为何 A/B 测试非常重要
A/B 测试是用于在产品开发中以数据为依据做出决策的重要技术。 通过检查应用程序输出的两种变体，开发人员可以根据用于跟踪通话可靠性和质量的特定指标来确定哪个版本更胜一筹。 此方法使公司能够在受控的设置中测试不同的设计、内容和功能，确保任何修改都会实现可衡量的增强。 此外，A/B 测试通过在全面推出之前提供基于证据的见解，来降低推出新功能或策略所造成的相关风险。
A/B 测试的另一个主要好处是能够揭示传统测试技术可能无法发现的用户偏好和行为。 通过分析这些测试的结果，开发人员可以更深入地了解应用程序的两个不同版本如何为最终用户带来通话可靠性和质量改善。 这种迭代性的测试和优化周期培养了持续增强的文化，可帮助开发人员保持竞争力并适应不断变化的市场趋势。
“诊断选项”标记的优势
考虑一下特定用户群遇到问题的可能性，你的目标是更好地识别和理解这些问题。 例如，假设在单个特定位置使用 Azure 通信服务 WebJS 的所有客户都会面临困难。 若要查明遇到问题的用户，你可以为在指定位置发起通话的客户端添加“诊断选项”标记。 使用此标记可以有效地筛选和检查通话日志。 通过应用有针对性的标记，可以更高效地隔离和分析这些数据。 ACS 的通话见解和通话诊断中心 (CDC) 等监视工具可以帮助跟踪这些标记，并识别重复出现的问题或模式。 通过对这些标记的会话进行持续分析，可以深入了解用户遇到的问题，从而主动解决这些问题并增强整体用户体验。
如何将“诊断选项”标记添加到 JavaScript 代码
可以使用三个可选字段来提供标记，以根据需求添加各种级别的 遥测跟踪。
appNameappVersiontags
每个值的最大长度为 64 个字符，仅支持字母 [aA、bB、cC 等]、数字 [0-9] 和基本符号（短划线“-”、下划线“_”、句点“.”、冒号“:”、井号“#”）。
以下示例演示如何在 WebJS 应用程序中使用“诊断选项”参数：
const callClient = new CallClient({
diagnostics: {
appName: 'contoso-healthcare-calling-services',
appVersion: '2.1',
tags: ["contoso_virtual_visits",`#clientTag:participant0001}`]
}
});
如何查看标记
将值添加到客户端 SDK 后，这些值就会被填充，并在通话时出现在遥测和指标中。 这些值显示为键值对，附加到通话客户端日志架构中显示的用户代理字段
contoso-healthcare-calling-services/2.1 azsdk-js-communication-calling/1.27.1-rc.10 (contoso_virtual_visits, participant0001). Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36 Edg/129.0.0.0
注意
如果未从客户端 API 中为“appName”、“appVersion”或“tag”设置值，则该字段的默认值将为空。