Sdílet prostřednictvím

Shromažďování názorů uživatelů pomocí průzkumu na konci hovoru

  • Článek

Poznámka:

Průzkum ukončení volání se v současné době podporuje jenom pro naši javascriptovou nebo webovou sadu SDK.

V tomto kurzu se dozvíte, jak používat průzkum ukončení volání služeb Azure Communication Services pro JavaScript nebo Web SDK.

Požadavky

  • Účet Azure s aktivním předplatným. Vytvoření účtu zdarma

  • Node.js doporučujeme používat aktivní verze dlouhodobé podpory (LTS).

  • Aktivní prostředek komunikační služby. Vytvořte prostředek komunikační služby. Výsledky průzkumu jsou svázané s jedinými prostředky komunikačních služeb.

  • Aktivní pracovní prostor služby Log Analytics, označovaný také jako protokoly služby Azure Monitor. Viz protokoly ukončení průzkumu volání.

  • K provedení průzkumu s vlastními dotazy pomocí bezplatného textu formuláře potřebujete prostředek App Insight.

Důležité

Průzkum ukončení volání je k dispozici od verze 1.13.1 volající sady SDK. Při pokusu o pokyny nezapomeňte použít tuto verzi nebo novější.

Ukázka využití rozhraní API

Po ukončení volání by se měla použít funkce Ukončit průzkum volání. Uživatelé můžou ohodnotit jakýkoli druh hovoru VoIP, 1:1, skupiny, schůzky, odchozí a příchozí. Jakmile volání uživatele skončí, může aplikace koncovému uživateli zobrazit uživatelské rozhraní, které mu umožní zvolit skóre hodnocení a v případě potřeby vybrat problémy, ke kterým došlo během hovoru z předdefinovaného seznamu.

Následující výsuvné kódy ukazují příklad volání 1:1. Po skončení hovoru může vaše aplikace zobrazit uživatelské rozhraní průzkumu a jakmile uživatel zvolí hodnocení, měla by aplikace volat rozhraní API funkce, aby průzkum odeslal s volbami uživatelů.

Doporučujeme použít výchozí měřítko hodnocení. Průzkum ale můžete odeslat s vlastním měřítkem hodnocení. Ukázkovou aplikaci pro ukázkové využití rozhraní API si můžete prohlédnout.

Ohodnotit pouze volání – bez vlastního škálování

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: { score: 5 }, // issues are optional
}).then(() => console.log('survey submitted successfully'));

OverallRating je povinná kategorie pro všechny průzkumy.

Ohodnotit pouze volání – s vlastním škálováním a problémy

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: {
        score: 1, // my score
        scale: { // my custom scale
            lowerBound: 0,
            upperBound: 1,
            lowScoreThreshold: 0
        },
        issues: ['HadToRejoin'] // my issues, check the table below for all available issues
    }
}).then(() => console.log('survey submitted successfully'));

Ohodnoťte celkový počet, zvuk a video s ukázkovým problémem

call.feature(Features.CallSurvey).submitSurvey({
    overallRating: { score: 3 },
    audioRating: { score: 4 },
    videoRating: { score: 3, issues: ['Freezes'] }
}).then(() => console.log('survey submitted successfully'))

Zpracování chyb, které může sada SDK odeslat

call.feature(Features.CallSurvey).submitSurvey({
   overallRating: { score: 3 }
}).catch((e) => console.log('error when submitting survey: ' + e))

Vyhledání různých typů chyb

Selhání při odesílání průzkumu:

Pokud ověření dat selže nebo průzkum nejde odeslat, rozhraní API vrátí následující chybové zprávy.

  • Vyžaduje se alespoň jedno hodnocení průzkumu.

  • Ve výchozím měřítku X by mělo být 1 až 5. - kde X je jeden z těchto:

    • overallRating.score
    • audioRating.score
    • videoRating.score
    • ScreenshareRating.score

  • {propertyName}: {rating.score} by měl být mezi {rating.scale?. lowerBound} a {rating.scale?. upperBound}.

  • {propertyName}: {rating.scale?. lowScoreThreshold} by měl být mezi {rating.scale?. lowerBound} a {rating.scale?. upperBound}.

  • {propertyName} lowerBound: {rating.scale?. lowerBound} a upperBound: {rating.scale?. upperBound} musí být v rozmezí od 0 do 100.

  • Zkuste to znovu [Službě Azure Communication Services se nepodařilo odeslat průzkum kvůli síti nebo jiné chybě].

Vrátíme všechny kódy chyb se zprávou.

  • Kód chyby 400 (chybný požadavek) pro všechny chybové zprávy s výjimkou jedné.
{ message: validationErrorMessage, code: 400 }
  • Jeden 408 (časový limit) při zahození události:
{ message: "Please try again.", code: 408 }

Všechny možné hodnoty

Výchozí konfigurace rozhraní API průzkumu

Kategorie hodnocení rozhraní API Přímá hodnota* Vstupní oblast Komentáře
Celkový hovor 2 1 - 5 Zkoumá celkové kvality prostředí volajícího účastníka v měřítku 1–5. Odpověď 1 označuje nekonfektní volání a 5 označuje perfektní hovor. Hodnota 2 znamená, že odezva zákazníka 1 nebo 2 značí méně než dokonalé prostředí volání.
Zvuk 2 1 - 5 Odpověď 1 značí nedostupné zvukové prostředí a 5 značí, že nedošlo k žádným problémům se zvukem.
Video 2 1 - 5 Odpověď 1 značí nedostupné video a 5 značí, že nedošlo k žádným problémům s videem.
Sdílení obrazovky 2 1 - 5 Odpověď 1 značí, že dochází k nedostupným funkcím sdílení obrazovky a 5 značí, že nedošlo k žádným problémům se sdílením obrazovky.

Poznámka:

Otazník označená hodnota v rozhraní API je prahová hodnota, kterou Microsoft používá při analýze dat průzkumu. Když přizpůsobíte mezní hodnotu nebo vstupní rozsah, Microsoft analyzuje data průzkumu podle vlastního nastavení.

Další značky průzkumu

Kategorie hodnocení Volitelné značky
Celkový hovor CallCannotJoin CallCannotInvite HadToRejoin CallEndedUnexpectedly OtherIssues
Zvuk NoLocalAudio NoRemoteAudio Echo AudioNoise LowVolume AudioStoppedUnexpectedly DistortedSpeech AudioInterruption OtherIssues
Video NoVideoReceived NoVideoSent LowQuality Freezes StoppedUnexpectedly DarkVideoReceived AudioVideoOutOfSync OtherIssues
Sdílení obrazovky NoContentLocal NoContentRemote CannotPresent LowQuality Freezes StoppedUnexpectedly LargeDelay OtherIssues

Možnosti přizpůsobení

Můžete vybrat, jestli chcete shromáždit všechny čtyři hodnoty rozhraní API, nebo jenom ty, které najdete nejdůležitější. Můžete se například rozhodnout, že se zákazníky zeptáte jenom na celkové prostředí hovoru, a nemusíte se je ptát na zvuk, video a sdílení obrazovky. Vstupní rozsahy můžete také přizpůsobit tak, aby vyhovovaly vašim potřebám. Výchozí vstupní rozsah je 1 až 5 pro celkový hovor, zvuk, video a sdílení obrazovky. Každou hodnotu rozhraní API je však možné přizpůsobit z minimálně 0 na maximálně 100.

Příklady přizpůsobení

Kategorie hodnocení rozhraní API Přímá hodnota* Vstupní oblast
Celkový hovor 0 - 100 0 - 100
Zvuk 0 - 100 0 - 100
Video 0 - 100 0 - 100
Sdílení obrazovky 0 - 100 0 - 100

Poznámka:

Otazník označená hodnota v rozhraní API je prahová hodnota, kterou Microsoft používá při analýze dat průzkumu. Když přizpůsobíte mezní hodnotu nebo vstupní rozsah, Microsoft analyzuje data průzkumu podle vlastního nastavení.

Vlastní otázky

Kromě použití rozhraní API pro průzkum koncového volání můžete vytvořit vlastní otázky k průzkumu a začlenit je do výsledků průzkumů ukončení volání. Níže najdete postup, jak začlenit vlastní dotazy zákazníků do průzkumu a dotazovat se na výsledky rozhraní API pro ukončení průzkumu volání a vlastní dotazy k průzkumu.

  • Vytvoření prostředku App Insight

  • Vložte Aplikace Azure Insights do aplikace Kliknutím sem získáte další informace o inicializaci App Insight pomocí prostého JavaScriptu. Případně můžete pomocí NPM získat závislosti na App Insights. Kliknutím sem získáte další informace o inicializaci App Insight pomocí NPM.

  • Vytvořte v aplikaci uživatelské rozhraní, které bude sloužit vlastním otázkám uživateli a shromáždí jejich vstup, předpokládejme, že vaše aplikace shromáždila odpovědi jako řetězec v improvementSuggestion proměnné.

  • Odešlete výsledky průzkumu do služeb Azure Communication Services a odešlete odpověď uživatelů pomocí App Insights:

    currentCall.feature(SDK.Features.CallSurvey).submitSurvey(survey).then(res => {
// `improvementSuggesstion` contains custom, user response
    if (improvementSuggestion !== '') {
        appInsights.trackEvent({
                name: "CallSurvey", properties: {
                    // Survey ID to correlate the survey
                    id: res.id,
                    // Other custom properties as key value pair
                    improvementSuggestion: improvementSuggestion
                }
            });
     }
});
appInsights.flush();

Odpovědi uživatelů, které byly odeslány pomocí AppInsights, jsou k dispozici v rámci vašeho pracovního prostoru App Insights. Sešity můžete použít k dotazování mezi více prostředky, korelaci hodnocení volání a vlastních dat průzkumu. Postup korelace hodnocení hovorů a vlastních dat průzkumu:

  • Vytvořte nové sešity (prostředek služby Azure Communication Services –> Monitorování –> Sešity –> Nové) a dotazujte se na data průzkumu volání z prostředku Azure Communication Services.
  • Přidat nový dotaz (+Přidat –> Přidat dotaz)
  • Ujistěte se, Data source že je Logs a Resource type je Communication
  • Dotaz můžete přejmenovat (Upřesnit nastavení –> název kroku [příklad: call-survey])
  • Mějte na paměti, že může vyžadovat maximálně 2 hodiny , než se data průzkumu zobrazí na webu Azure Portal. Dotazování na data hodnocení volání 
    ACSCallSurvey
| where TimeGenerated > now(-24h)
  • Přidání dalšího dotazu pro získání dat z App Insights (+Přidat –> Přidání dotazu)
  • Ujistěte se, Data source že je Logs a Resource type je Application Insights
  • Dotazování vlastních událostí 
    customEvents
| where timestamp > now(-24h)
| where name == 'CallSurvey'
| extend d=parse_json(customDimensions)
| project SurveyId = d.id, ImprovementSuggestion = d.improvementSuggestion
  • Dotaz můžete přejmenovat (Upřesnit nastavení –> název kroku [příklad: custom-call-survey])
  • Nakonec tyto dva dotazy sloučíte podle surveyId. Vytvořit nový dotaz (+Přidat –> přidat dotaz).
  • Data source Vyberte možnost Sloučit a podle potřeby vyberte Merge type

Shromažďování dat průzkumu

Důležité

Abyste mohli přijímat a analyzovat data průzkumu, musíte ve službě Azure Monitor povolit nastavení diagnostiky, abyste mohli odesílat data protokolů průzkumů do pracovního prostoru služby Log Analytics, do služby Event Hubs nebo účtu úložiště Azure. Pokud neodešlete data průzkumu do některé z těchto možností, data průzkumu nebudou uložena a budou ztracena. Pokud chcete povolit tyto protokoly pro komunikační služby, přečtěte si téma: Protokoly ukončení průzkumu volání

Zobrazení dat průzkumu pomocí pracovního prostoru služby Log Analytics

Musíte povolit pracovní prostor služby Log Analytics, aby ukládaly data protokolů vašich průzkumů i přístup k výsledkům průzkumu. Pokud chcete povolit tyto protokoly pro službu Communications Service, přečtěte si téma: Protokoly ukončení průzkumu volání.

Osvědčené postupy

Tady jsou naše doporučené toky průzkumu a navrhované výzvy k otázce, které je potřeba vzít v úvahu. Váš vývoj může použít naše doporučení nebo použít přizpůsobené výzvy a toky otázek pro vaše vizuální rozhraní.

Otázka 1: Jak uživatelé vnímali své celkové zkušenosti s kvalitou hovorů? Doporučujeme zahájit průzkum jenom dotazem na celkovou kvalitu účastníků. Pokud oddělíte první a druhou otázku, pomůže vám shromáždit odpovědi jenom na problémy se zvukem, videem a sdílením obrazovky, pokud účastník průzkumu indikuje, že došlo k problémům s kvalitou hovorů.

  • Suggested prompt: "How was the call quality?" (Jak byla kvalita hovoru?
  • Hodnoty otázek rozhraní API: Celkové volání

Otázka 2: V hovoru uživatel vnímal nějaké problémy se zvukem, videem nebo sdílením obrazovky? Pokud účastník průzkumu odpověděl na otázku 1 se skóre v celkovém hovoru nebo pod jeho hodnotou, poté předejte druhou otázku.

  • Navržená výzva: "Co by mohlo být lepší?"
  • Hodnoty otázek rozhraní API: Zvuk, video a sdílení obrazovky

Pokyny pro průzkumy

  • Vyhněte se vyhoření průzkumu, nezjišťujte všechny účastníky hovoru.
  • Záleží na pořadí otázek. V případě, že se respondenti zaměří většinu zpětné vazby na první výzvu, kterou vizuálně vidí, doporučujeme náhodnou sekvenci volitelných značek v otázce 2.
  • Zvažte použití průzkumů pro samostatné prostředky služeb Azure Communication Services v kontrolovaných experimentech k identifikaci dopadů na vydání.

Další kroky