Skip to content

Commit e649452

Browse files
amagginettiamagginetti
committed
tset
1 parent 570bd93 commit e649452

File tree

1 file changed

+132
-0
lines changed

1 file changed

+132
-0
lines changed

‎articles/communication-services/concepts/voice-video-calling/end-of-call-survey.md

Lines changed: 132 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,132 @@
1+
---
2+
title: Azure Communication Services End of Call Survey overview
3+
titleSuffix: An Azure Communication Services concept document
4+
description: Learn about the End of Call Survey.
5+
author: amagginetti
6+
ms.author: amagginetti
7+
manager: mvivion
8+
9+
services: azure-communication-services
10+
ms.date: 4/03/2023
11+
ms.topic: conceptual
12+
ms.service: azure-communication-services
13+
ms.subservice: calling
14+
---
15+
16+
17+
18+
# End of Call Survey overview
19+
20+
21+
[!INCLUDE [Public Preview](../../includes/public-preview-include-document.md)]
22+
23+
24+
> [!NOTE]
25+
> End of Call Survey is currently supported only for our JavaScript / Web SDK.
26+
27+
28+
The End of Call Survey provides you with a tool to understand how your end users perceive the overall quality and reliability of your JavaScript / Web SDK calling solution.
29+
30+
## Purpose of the End of Call Survey
31+
It’s difficult to determine a customer’s perceived calling experience and determine how well your calling solution is performing without gathering subjective feedback from customers.
32+
33+
You can use the End of Call Survey to collect and analyze customers **subjective** opinions on their calling experience as opposed to relying only on **objective** measurements such as audio and video bitrate, jitter, and latency, which may not indicate if a customer had a poor calling experience. After publishing survey data, you can view the survey results through Azure for analysis and improvements. Azure Communication Services uses these survey results to monitor and improve quality and reliability.
34+
35+
36+
## Survey Structure
37+
38+
The survey is designed to answer two questions from a user’s point of view.
39+
40+
- **Question 1:** How did the users perceive their overall call quality experience?
41+
42+
- **Question 2:** Did the user perceive any Audio, Video, or Screen Share issues in the call?
43+
44+
The API allows applications to gather data points that describe user perceived ratings of their Overall Call, Audio, Video, and Screen Share experiences. Microsoft analyzes survey API results according to the following goals.
45+
46+
### End of Call Survey API Goals
47+
48+
49+
| API Rating Categories | Question Goal |
50+
| ----------- | ----------- |
51+
| Overall Call | Responses indicate how a call participant perceived their overall call quality. |
52+
| Audio | Responses indicate if the user perceived any Audio issues. |
53+
| Video | Responses indicate if the user perceived any Video issues. |
54+
| ScreenShare | Responses indicate if the user perceived any Screen Share issues. |
55+
56+
57+
58+
## Survey Capabilities
59+
60+
61+
62+
### Default survey API configuration
63+
64+
| API Rating Categories | Cutoff Value* | Input Range | Comments |
65+
| ----------- | ----------- | -------- | -------- |
66+
| Overall Call | 2 | 1 - 5 | Surveys a calling participant’s overall quality experience on a scale of 1-5 where 1 indicates an imperfect call experience and 5 indicates a perfect call. The cutoff value of 2 means that a customer response of 1 or 2 indicates a less than perfect call experience. |
67+
| Audio | 2 | 1 - 5 | A response of 1 indicates an imperfect audio experience and 5 indicates no audio issues were experienced. |
68+
| Video | 2 | 1 - 5 | A response of 1 indicates an imperfect video experience and 5 indicates no video issues were experienced. |
69+
| Screenshare | 2 | 1 - 5 | A response of 1 indicates an imperfect screen share experience and 5 indicates no screen share issues were experienced. |
70+
71+
72+
second conversion
73+
74+
| **API Rating Categories** | **Cutoff Value\*** | **Input Range** | **Comments** |
75+
|---------------------------|--------------------|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
76+
| Overall Call | 2 | 1 - 5 | Survey’s a calling participant’s overall quality experience on a scale of 1-5 where 1 indicates an imperfect call experience and 5 indicates a perfect call. The cutoff value of 2 means that a customer response of 1 or 2 indicates a less than perfect call experience. |
77+
| Audio | 2 | 1 – 5 | A response of 1 indicates an imperfect audio experience and 5 indicates no audio issues were experienced. |
78+
| Video | 2 | 1 – 5 | A response of 1 indicates an imperfect video experience and 5 indicates no video issues were experienced. |
79+
| Screenshare | 2 | 1 – 5 | A response of 1 indicates an imperfect screen share experience and 5 indicates no screen share issues were experienced. |
80+
81+
82+
83+
- ***Note:** A question’s indicated cutoff value in the API is the threshold that Microsoft uses when analyzing your survey data. When you customize the cutoff value or Input Range, Microsoft analyzes your survey data according to your customization.
84+
85+
### Additional survey tags
86+
| Rating Categories | Optional Tags |
87+
| ----------- | ----------- |
88+
| Overall Call | `CallCannotJoin` `CallCannotInvite` `HadToRejoin` `CallEndedUnexpectedly` `OtherIssues` |
89+
| Audio | `NoLocalAudio` `NoRemoteAudio` `Echo` `AudioNoise` `LowVolume` `AudioStoppedUnexpectedly` `DistortedSpeech` `AudioInterruption` `OtherIssues` |
90+
| Video | `NoVideoReceived` `NoVideoSent` `LowQuality` `Freezes` `StoppedUnexpectedly` `DarkVideoReceived` `AudioVideoOutOfSync` `OtherIssues` |
91+
| Screenshare | `NoContentLocal` `NoContentRemote` `CannotPresent` `LowQuality` `Freezes` `StoppedUnexpectedly` `LargeDelay` `OtherIssues` |
92+
93+
94+
95+
### End of Call Survey Customization
96+
You can choose to collect each of the four API values or only the ones you find most important. For example, you can choose to only ask customers about their overall call experience instead of asking them about their audio, video, and screen share experience. You can also customize input ranges to suit your needs. The default input range is 1 to 5 for Overall Call, and 0 to 1 for Audio, Video, and Screenshare. However, each API value can be customized from a minimum of 0 to maximum of 100.
97+
98+
You can choose to collect each of the four API values or only the ones
99+
you find most important. For example, you can choose to only ask
100+
customers about their overall call experience instead of asking them
101+
about their audio, video, and screen share experience. You can also
102+
customize input ranges to suit your needs. The default input range is 1
103+
to 5 for Overall Call, <span class="mark">Audio</span>, Video, and
104+
Screenshare. However, each API value can be customized from a minimum of
105+
0 to maximum of 100.
106+
107+
### Customization options
108+
109+
110+
| API Rating Categories | Cutoff Value* | Input Range |
111+
| ----------- | ----------- | -------- |
112+
| Overall Call | 0 - 100 | 0 - 100 |
113+
| Audio | 0 - 100 | 0 - 100 |
114+
| Video | 0 - 100 | 0 - 100 |
115+
| Screenshare | 0 - 100 | 0 - 100 |
116+
117+
- ***Note**: A question’s indicated cutoff value in the API is the threshold that Microsoft uses when analyzing your survey data. When you customize the cutoff value or Input Range, Microsoft analyzes your survey data according to your customization.
118+
119+
## Store and view survey data:
120+
121+
> [!IMPORTANT]
122+
> You must enable a Diagnostic Setting in Azure Monitor to send the log data of your surveys to a Log Analytics workspace, Event Hubs, or an Azure storage account to receive and analyze your survey data. If you do not send survey data to one of these options your survey data will not be stored and will be lost. To enable these logs for your Communications Services, see: **[Enable logging in Diagnostic Settings](../analytics/enable-logging.md)**
123+
124+
You can only view your survey data if you have enabled a Diagnostic Setting to capture your survey data.
125+
126+
## Next Steps
127+
128+
- Learn how to use the Log Analytics workspace, see: [Log Analytics Tutorial](../../../../articles/azure-monitor/logs/log-analytics-tutorial.md)
129+
130+
- Create your own queries in Log Analytics, see: [Get Started Queries](../../../../articles/azure-monitor/logs/get-started-queries.md)
131+
132+

0 commit comments

Comments
 (0)