Tutorial zum Hinzufügen von benutzerdefinierten Tags zu Ihrer Client-Telemetrie
In diesem Tutorial erfahren Sie, wie Sie den Telemetriedaten, die Ihr WebJS-Client an Azure Monitor sendet, ein benutzerdefiniertes Datenattribut hinzufügen, das als Diagnostic Options-Tag bezeichnet wird. Diese Telemetrie kann für die Analyse nach dem Aufruf verwendet werden.
Warum A/B-Tests wichtig sind
A/B-Tests sind eine wesentliche Technik zum Treffen von datenbasierten Entscheidungen in der Produktentwicklung. Wenn Sie zwei Variationen einer Anwendungsausgabe untersuchen, können Entwickler ermitteln, welche Version sich basierend auf bestimmten Metriken, welche die Anrufzulässigkeit und -qualität nachverfolgen, empfiehlt. Mit dieser Methode können Unternehmen unterschiedliche Designs, Inhalte und Funktionen innerhalb einer kontrollierten Einstellung testen und sicherstellen, dass Änderungen zu messbaren Verbesserungen führen. Darüber hinaus reduzieren A/B-Tests die Risiken, die mit der Einführung neuer Features oder Strategien verbunden sind, indem nachweisbasierte Erkenntnisse vor einem vollständigen Start angeboten werden.
Ein weiterer wichtiger Vorteil von A/B-Tests ist die Fähigkeit, Benutzereinstellungen und Verhaltensweisen aufzudecken, die durch herkömmliche Testmethoden möglicherweise nicht offensichtlich sind. Die Analyse der Ergebnisse dieser Tests ermöglicht es Entwicklern, tiefergehend zu verstehen, wie zwei verschiedene Versionen Ihrer Anwendung zu Verbesserungen bei der Anrufzuverlässigkeit und -qualität führen. Dieser iterative Zyklus von Tests und Optimierung kultiviert kontinuierliche Verbesserungen und hilft Entwicklern, wettbewerbsfähig und anpassungsfähig an sich entwickelnde Markttrends zu bleiben.
Vorteile des Diagnostic Options-Tags
Berücksichtigen Sie die Möglichkeit, dass bestimmte Segmente Ihrer Benutzerbasis Probleme haben. Sie möchten diese Probleme besser identifizieren und verstehen. Stellen Sie sich beispielsweise vor, dass alle Ihre Kunden, die Azure Communication Services WebJS an einem Ort verwenden, Schwierigkeiten haben. Um die Probleme der Benutzer zu lokalisieren, können Sie ein Diagnostic Options-Tag auf Clients integrieren, die einen Anruf an dem angegebenen Ort initiieren. Mit diesem Tagging können Sie Anrufprotokolle effektiv filtern und untersuchen. Durch das Anwenden von gezielten Tags können Sie diese Daten effizienter isolieren und analysieren. Überwachungstools wie ACS Calling Insights und Call Diagnostic Center (CDC) können dabei helfen, diese Tags nachzuverfolgen und wiederkehrende Probleme oder Muster zu identifizieren. Durch die fortlaufende Analyse dieser markierten Sitzungen erhalten Sie wertvolle Einblicke in Benutzerprobleme, sodass Sie sie proaktiv behandeln und die gesamte Benutzererfahrung verbessern können.
So fügen Sie Ihrem JavaScript-Code ein Diagnostic Options-Tag hinzu
Es gibt drei optionale Felder, mit denen Sie taggen können, um verschiedene Ebenen hinzuzufügen. Telemetrieverfolgung für Ihre Anforderungen.
appNameappVersiontags
Jeder Wert kann eine maximale Länge von 64 Zeichen aufweisen, wobei nur Buchstaben [aA, bB, cC usw.], Zahlen [0-9] und einfache Symbole (Strich (-), Unterstrich (_), Punkt (.), Doppelpunkt (:), Rautezeichen (#) unterstützt werden).
Nachfolgend sehen Sie ein Beispiel für die Verwendung der Diagnostic Options Parameter aus Ihrer WebJS-Anwendung:
const callClient = new CallClient({
diagnostics: {
appName: 'contoso-healthcare-calling-services',
appVersion: '2.1',
tags: ["contoso_virtual_visits",`#clientTag:participant0001}`]
}
});
Wie Sie die Protokolle anzeigen
Nachdem Sie ihrem Client-SDK die Werte hinzugefügt haben, werden diese beim Aufrufen in Ihrer Telemetrie und Metrik aufgefüllt und angezeigt. Diese Werte werden als Schlüssel-Wert-Paare angezeigt, die an das Benutzer-Agent-Feld angefügt werden, das im Aufrufclientprotokollschema befindet.
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
Hinweis
Wenn Sie keinen Wert für „appName“, „appVersion“ oder „tag“ aus der Client-API festlegen, bleibt der Standardwert für dieses Feld leer.