PR Comments

Author: viniciusl-msft

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

@@ -17,12 +17,7 @@ ms.subservice: calling
 
 # End of Call Survey overview
 
-
-> [!NOTE] 
-> End of Call Survey is currently supported only for our JavaScript / Web SDK.
-
-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.
-
+The End of Call Survey provides you with a tool to understand how your end users perceive the overall quality and reliability of your Calling SDK solution.
 
 ## Purpose of the End of Call Survey
 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. 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.

articles/communication-services/tutorials/end-of-call-survey-tutorial.md

@@ -38,4 +38,47 @@ This tutorial shows you how to use the Azure Communication Services End of Call
 
 ::: zone pivot="platform-windows"
 [!INCLUDE [End of Call Survey for Windows](./includes/end-of-call-survey-windows.md)]
-::: zone-end
+::: zone-end
+
+## Collect survey data
+
+> [!IMPORTANT]
+> 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: [End of Call Survey Logs](../concepts/analytics/logs/end-of-call-survey-logs.md)
+
+### View survey data with a Log Analytics workspace
+
+You need to enable a Log Analytics Workspace to both store the log data of your surveys and access survey results. To enable these logs for your Communications Service, see: [End of Call Survey Logs](../concepts/analytics/logs/end-of-call-survey-logs.md).
+
+- You can also integrate your Log Analytics workspace with Power BI, see: [Integrate Log Analytics with Power BI](../../../articles/azure-monitor/logs/log-powerbi.md).
+
+## Best practices
+Here are our recommended survey flows and suggested question prompts for consideration. Your development can use our recommendation or use customized question prompts and flows for your visual interface.
+
+**Question 1:** How did the users perceive their overall call quality experience?
+We recommend you start the survey by only asking about the participants’ overall quality. If you separate the first and second questions, it helps to only collect responses to Audio, Video, and Screen Share issues if a survey participant indicates they experienced call quality issues.
+
+
+- Suggested prompt: “How was the call quality?”
+- API Question Values: Overall Call
+
+**Question 2:** Did the user perceive any Audio, Video, or Screen Sharing issues in the call?
+If a survey participant responded to Question 1 with a score at or below the cutoff value for the overall call, then present the second question.
+
+- Suggested prompt: “What could have been better?”
+- API Question Values: Audio, Video, and Screenshare
+
+### Surveying Guidelines
+- Avoid survey burnout, don’t survey all call participants.
+- The order of your questions matters. We recommend you randomize the sequence of optional tags in Question 2 in case respondents focus most of their feedback on the first prompt they visually see.
+- Consider using surveys for separate Azure Communication Services Resources in controlled experiments to identify release impacts.
+
+
+## Next steps
+
+- Analyze your survey data, see: [End of Call Survey Logs](../concepts/analytics/logs/end-of-call-survey-logs.md)
+
+- Learn more about the End of Call Survey, see: [End of Call Survey overview](../concepts/voice-video-calling/end-of-call-survey-concept.md)
+
+- Learn how to use the Log Analytics workspace, see: [Log Analytics Tutorial](../../../articles/azure-monitor/logs/log-analytics-tutorial.md)
+
+- Create your own queries in Log Analytics, see: [Get Started Queries](../../../articles/azure-monitor/logs/get-started-queries.md)

articles/communication-services/tutorials/includes/end-of-call-survey-web.md

@@ -190,4 +190,4 @@ User responses that were sent using AppInsights are available under your App Ins
    ```
 -  You can rename the query (Advanced Settings -> Step name [example: custom-call-survey])
 -  Finally merge these two queries by surveyId. Create new query (+Add -> Add query).
--  Make suer the `Data source` is Merge and select `Merge type` as needed
+-  Make sure the `Data source` is Merge and select `Merge type` as needed