Sdílet prostřednictvím

Kurz přidání vlastních značek do telemetrie klienta

  • Článek

V tomto kurzu se dozvíte, jak do telemetrických dat, která klient WebJS odesílá do služby Azure Monitor, přidat vlastní atribut dat označovaný jako značka Diagnostické možnosti . Tato telemetrie se dá použít k analýze po volání.

Proč záleží na testování A/B

Testování A/B je základní technika pro rozhodování o datech informovaná při vývoji produktů. Při zkoumání dvou variant výstupu aplikace můžou vývojáři určit, která verze exceluje na základě konkrétních metrik, které sledují spolehlivost a kvalitu volání. Tato metoda umožňuje společnostem testovat různé návrhy, obsah a funkce v rámci řízeného nastavení a zajistit tak, aby všechny úpravy měly za následek měřitelná vylepšení. Kromě toho testování A/B snižuje rizika spojená s zavedením nových funkcí nebo strategií tím, že nabízí přehledy založené na důkazech před úplným spuštěním.

Další klíčovou výhodou testování A/B je jeho schopnost odhalit předvolby a chování uživatelů, které nemusí být zřejmé prostřednictvím tradičních testovacích technik. Analýza výsledků těchto testů umožňuje vývojářům získat hlubší přehled o tom, jak dvě různé verze vaší aplikace vedou k vylepšením koncových uživatelů při volání spolehlivosti a kvality. Tento iterativní cyklus testování a optimalizace kultivuje kulturu neustálého vylepšování a pomáhá vývojářům zůstat konkurenceschopný a přizpůsobitelný pro vývoj trendů trhu.

Výhody značky Diagnostické možnosti

Vezměte v úvahu možnost, že konkrétní segmenty vaší uživatelské základny narazí na problémy a vy se snažíte lépe identifikovat a porozumět těmto problémům. Představte si například, že všichni vaši zákazníci, kteří využívají WebJS služby Azure Communication Services, mají potíže s jedním konkrétním umístěním. Pokud chcete určit, kteří uživatelé mají problémy, můžete začlenit značku diagnostických možností na klientech, kteří iniciují volání v zadaném umístění. Toto označování umožňuje efektivně filtrovat a zkoumat protokoly volání. Použitím cílové značky můžete data oddělit a analyzovat efektivněji. Monitorovací nástroje, jako jsou ACS Calling Insights a Call Diagnostic Center (CDC), můžou pomoct tyto značky sledovat a identifikovat opakované problémy nebo vzory. Prostřednictvím průběžné analýzy těchto označených relací získáte cenné přehledy o problémech uživatelů, abyste je mohli aktivně řešit a vylepšit celkové uživatelské prostředí.

Přidání značky Diagnostické možnosti do kódu JavaScriptu

Existují tři volitelná pole, která můžete použít k označení, aby se přidala různá úroveň. Sledování telemetrie pro vaše potřeby

  • appName
  • appVersion
  • tags

Každá hodnota může mít maximální délku 64 znaků s podporou pouze písmen [aA, bB, cC atd.], číslic[0-9] a základních symbolů (pomlčka "-", podtržítka "_", tečka ".", dvojtečka ":", znak čísla "#" ).

Tady je příklad použití parametrů Možnosti diagnostiky z vaší aplikace WebJS:

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

Jak zobrazit značku

Po přidání hodnot do klientské sady SDK se naplní a zobrazí se v telemetrii a metrikách při volání. Tyto hodnoty se zobrazí jako páry klíč-hodnota připojené k poli uživatelského agenta, které se zobrazí ve schématu protokolu klienta volání.

contoso-healthcare-calling-services/2.1 azsdk-js-communication-calling/1.27.1-rc.10 (contoso_virtual_visits, účastník0001). Mozilla/5.0 (systém 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

Poznámka:

Pokud v rozhraní API klienta nenastavíte hodnotu appName, appVersion nebo tag, bude výchozí hodnota pro toto pole prázdná.

Další kroky