Samouczek dotyczący dodawania tagów niestandardowych do telemetrii klienta

W tym samouczku pokazano, jak dodać niestandardowy atrybut danych o nazwie tag Opcje diagnostyczne do danych telemetrycznych wysyłanych przez klienta webJS do usługi Azure Monitor. Ta telemetria może służyć do analizy po wywołaniu.

Dlaczego testowanie A/B ma znaczenie

Testowanie A/B to podstawowa technika podejmowania świadomych danych decyzji w zakresie opracowywania produktów. Sprawdzając dwie odmiany danych wyjściowych aplikacji, deweloperzy mogą zidentyfikować, która wersja wyróżnia się na podstawie określonych metryk śledzenia niezawodności i jakości wywołań. Ta metoda umożliwia firmom testowanie różnych projektów, zawartości i funkcjonalności w kontrolowanym ustawieniu, zapewniając, że wszelkie modyfikacje powodują mierzalne ulepszenia. Ponadto testowanie A/B zmniejsza ryzyko związane z wprowadzeniem nowych funkcji lub strategii, oferując oparte na dowodach szczegółowe informacje przed uruchomieniem na pełną skalę.

Kolejną kluczową zaletą testowania A/B jest możliwość ujawnienia preferencji i zachowań użytkowników, które nie są widoczne za pomocą tradycyjnych technik testowania. Jeśli zdecydujesz się przeprowadzić testowanie A/B, możesz lepiej zrozumieć, w jaki sposób dwie różne wersje aplikacji powodują ulepszenia użytkowników końcowych w wywoływaniu niezawodności i jakości. Ten iteracyjny cykl testowania i optymalizacji kultywuje kulturę ciągłego ulepszania, pomagając deweloperom zachować konkurencyjność i dostosowywać się do zmieniających się trendów rynkowych.

Zalety tagu Opcje diagnostyczne

Rozważ możliwość wystąpienia problemów z określonymi segmentami bazy użytkowników i chcesz lepiej zidentyfikować i zrozumieć te problemy. Załóżmy na przykład, że wszyscy klienci korzystający z usługi Azure Communication Services WebJS w jednej konkretnej lokalizacji mają trudności. Aby wskazać użytkowników, którzy napotykają problemy, możesz dołączyć tag opcji diagnostycznych na klientach inicjujących wywołanie w określonej lokalizacji. Ta tagowanie umożliwia efektywne filtrowanie i analizowanie dzienników wywołujących. Stosując tag docelowy, można segregować i analizować te dane wydajniej. Narzędzia do monitorowania, takie jak ACS Calling Insights i Call Diagnostic Center (CDC), mogą pomóc w śledzeniu tych tagów i identyfikowaniu powtarzających się problemów lub wzorców. Dzięki ciągłej analizie tych oznakowanych sesji uzyskasz cenny wgląd w problemy użytkowników, umożliwiając proaktywne rozwiązywanie problemów i ulepszanie ogólnego środowiska użytkownika.experience.

Jak dodać tag Opcje diagnostyczne do kodu JavaScript

Istnieją trzy opcjonalne pola, których można użyć do tagowania w celu dodania różnych poziomów. Śledzenie telemetrii dla Twoich potrzeb.

• appName
• appVersion
• tags

Każda wartość może mieć maksymalną długość 64 znaków, z obsługą tylko liter [aA, bB, cC itp.], cyfr[0–9] i symboli podstawowych (kreska "-", podkreślenie "_", kropka ".", dwukropek ":", znak numeru "#").

Oto przykład użycia parametrów Opcji diagnostycznych z poziomu aplikacji WebJS:

const callClient = new CallClient({
    diagnostics: {
        appName: 'contoso-healthcare-calling-services',
        appVersion: '2.1',
        tags: ["contoso_virtual_visits",`#clientTag:participant0001}`]
    }
});

Jak wyświetlić tag

Po dodaniu wartości do zestawu SDK klienta są one wypełniane i wyświetlane w telemetrii i metrykach podczas wywoływania. Te wartości są wyświetlane jako pary klucz-wartość dołączone do pola agenta użytkownika, które pojawia się w schemacie dziennika aktualizacji podsumowania wywołań we właściwości DiagnosticOptions.

contoso-healthcare-calling-services/2.1 azsdk-js-communication-calling/1.27.1-rc.10 (contoso_virtual_visits, uczestnik0001). Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, na przykład Gecko) Chrome/129.0.0.0 Safari/537.36 Edg/129.0.0.0

Następne kroki

• Dowiedz się więcej o Centrum diagnostycznym połączeń usług Azure Communication Services tutaj
• Dowiedz się więcej o usłudze Voice and Video calling Insights tutaj
• Dowiedz się więcej na temat włączania dzienników usług Azure Communication Services tutaj