클라이언트 원격 분석에 사용자 지정 태그를 추가하는 방법에 대한 자습서

아티클
01/08/2025

이 자습서에서는 WebJS 클라이언트가 Azure Monitor에 보내는 원격 분석 데이터에 진단 옵션 태그라는 사용자 지정 데이터 특성을 추가하는 방법을 보여 줍니다. 이 원격 분석은 호출 후 분석에 사용할 수 있습니다.

A/B 테스트가 중요한 이유

A/B 테스트는 제품 개발에서 데이터 정보에 입각한 결정을 내리는 데 필수적인 기술입니다. 개발자는 애플리케이션 출력의 두 가지 변형을 검사하여 호출 안정성 및 품질을 추적하는 특정 메트릭에 따라 어떤 버전이 뛰어난지 식별할 수 있습니다. 이 방법을 사용하면 회사에서 제어된 설정 내에서 다양한 디자인, 콘텐츠 및 기능을 테스트하여 수정으로 인해 측정 가능한 향상된 기능이 생성되도록 할 수 있습니다. 또한 A/B 테스트는 본격적인 출시 전에 증거 기반 인사이트를 제공하여 새로운 기능 또는 전략 도입과 관련된 위험을 줄입니다.

A/B 테스트의 또 다른 주요 이점은 기존 테스트 기술을 통해 분명하지 않을 수 있는 사용자 기본 설정 및 동작을 표시하는 용량입니다. 이러한 테스트의 결과를 분석하면 개발자는 애플리케이션의 두 가지 버전이 최종 사용자가 호출 안정성 및 품질을 개선하는 방법을 더 깊이 이해할 수 있습니다. 이러한 반복적인 테스트 및 최적화 주기는 지속적으로 향상된 문화를 조성하여 개발자가 시장 트렌드를 발전시키는 경쟁력과 적응력을 유지할 수 있도록 지원합니다.

진단 옵션 태그의 이점

사용자 기반의 특정 세그먼트에 문제가 발생할 가능성이 있으며 이러한 문제를 더 잘 식별하고 이해하는 것을 목표로 합니다. 예를 들어 단일 특정 위치에서 Azure Communication Services WebJS를 활용하는 모든 고객이 어려움을 겪고 있다고 상상해 보십시오. 문제가 발생한 사용자를 정확히 파악하기 위해 지정된 위치에서 호출을 시작하는 클라이언트에 진단 옵션 태그를 통합할 수 있습니다. 이 태그 지정을 사용하면 호출 로그를 효과적으로 필터링하고 검사할 수 있습니다. 대상 태그를 적용하면 이 데이터를 보다 효율적으로 분리하고 분석할 수 있습니다. ACS Calling Insights 및 CDC(통화 진단 센터)와 같은 모니터링 도구는 이러한 태그를 추적하고 반복되는 문제 또는 패턴을 식별하는 데 도움이 될 수 있습니다. 태그가 지정된 세션에 대한 지속적인 분석을 통해 사용자 문제에 대한 중요한 인사이트를 얻을 수 있으므로 이를 사전에 해결하고 전반적인 사용자 환경 환경을 향상시킬 수 있습니다.

JavaScript 코드에 진단 옵션 태그를 추가하는 방법

태그를 지정하여 다양한 수준을 추가하는 데 사용할 수 있는 세 가지 선택적 필드가 있습니다. 요구 사항에 대한 원격 분석 추적

appName
appVersion
tags

각 값의 최대 길이는 64자이며 문자 [aA, bB, cC 등], numbers[0-9] 및 기본 기호(대시 "-", 밑줄 "_", period ".", colon ":", number sign "#" )만 지원합니다.

다음은 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, 참가자0001). Mozilla/5.0(Windows NT 10.0; Win64; x64) AppleWebKit/537.36(KHTML, 예: Gecko) Chrome/129.0.0.0 Safari/537.36 Edg/129.0.0.0

참고 항목

클라이언트 API 내에서 'appName', 'appVersion 또는 'tag' 값을 설정하지 않으면 해당 필드의 기본값이 비어 있습니다.

다음 단계

Azure Communication Services 통화 진단 센터에 대한 자세한 내용은 여기를 참조하세요.
음성 및 비디오 통화 인사이트에 대한 자세한 내용은 여기를 참조하세요.
Azure Communication Services 로그를 사용하도록 설정하는 방법에 대한 자세한 내용은 여기를 참조하세요.

다음을 통해 공유