Завершение опроса звонков

Примечание.

Завершение опроса вызовов в настоящее время поддерживается только для нашего пакета SDK javaScript или Web SDK.

Необходимые компоненты

Службы коммуникации Azure предоставляют функции мониторинга и аналитики с помощью обзоров журналов Azure Monitor и метрик Azure Monitor. Для каждого ресурса Azure требуется собственный параметр диагностики, который определяет следующие критерии:

  • Категории журналов и данных метрик, отправленных в назначения, определенные в параметре. Доступные категории зависят от разных типов ресурсов.
  • здесь указываются одно или несколько назначений для отправки журналов. Текущие назначения включают рабочую область Log Analytics, Центры событий и служба хранилища Azure.
  • Один параметр диагностики может определять не более одного назначения каждого типа. Если вы хотите отправить данные в несколько определенных типов назначения (например, две разные рабочие области Log Analytics), создайте несколько параметров. Каждый ресурс может иметь до пяти параметров диагностики.

Внимание

Необходимо включить параметр диагностики в Azure Monitor для отправки данных журнала опросов в рабочую область Log Analytics, Центры событий или учетную запись хранения Azure для получения и анализа данных опроса. Если данные опроса не отправляются в один из этих вариантов, данные опроса не будут храниться и будут потеряны, ниже приведены инструкции по настройке ресурса Azure Monitor для начала создания журналов и метрик для служб коммуникации. Подробные сведения об использовании параметров диагностики во всех ресурсах Azure см. в статье "Включение ведения журнала в параметрах диагностики"

Примечание.

В разделе "Имя параметра диагностики" выберите "Call Survey", чтобы включить журналы для завершения опроса звонков.

Снимок экрана: параметры диагностики для опроса звонков.

Обзор

Реализация журналов комплексных опросов представляет расширенную функциональность в Службы коммуникации Azure (Службы коммуникации Azure), что позволяет Contoso отправлять опросы для сбора субъективных отзывов клиентов об их вызове. Этот подход направлен на дополнение к оценке качества звонков за рамки целевых метрик, таких как аудио и видеобитовая скорость, jitter и задержка, которая может не полностью захватить, имеет ли клиент удовлетворительный или неудовлетворительный опыт. Используя журналы Azure для публикации и проверки данных опроса, Компания Contoso получает аналитические сведения об анализе и идентификации областей, требующих улучшения. Эти результаты опроса служат ценным ресурсом для Службы коммуникации Azure непрерывно отслеживать качество и надежность. Дополнительные сведения об окончании опроса звонков

Завершение опроса звонков — это ценное средство, которое позволяет собирать аналитические сведения о том, как конечные пользователи воспринимают качество и надежность решения для вызова JavaScript/Web SDK. Сопровождающие журналы содержат важные данные, которые помогают оценить взаимодействие конечных пользователей, в том числе:

Общий вызов: ответы указывают, как участник вызова воспринимал их общее качество звонка.

  • Звук: ответы указывают, воспринимает ли пользователь какие-либо проблемы со звуком.
  • Видео: ответы указывают, воспринимает ли пользователь какие-либо проблемы с видео.
  • Общий доступ к экрану: ответы указывают, воспринимает ли пользователь какие-либо проблемы с общим доступом к экрану. Помимо приведенных выше, необязательные теги в ответах предоставляют дополнительные сведения о конкретных типах проблем, связанных с аудио, видео или общим доступом на экране.

Анализируя данные, захваченные в журналах опроса вызовов, можно определить области, требующие улучшения, тем самым повышая общую работу пользователей.

Категории журналов ресурсов

Службы коммуникации предоставляют следующие типы журналов, которые можно включить:

  • Завершение журналов опроса звонков — предоставляет основные сведения, связанные с опросом в конце звонка.

Свойства

Свойство Description
Timegenerated Это поле представляет метку времени (UTC) при создании журнала.
CorrelationId Идентификатор коррелированных событий можно использовать для идентификации связанных событий между несколькими таблицами.
Category Категория журнала для события. Журналы с той же категорией журнала и типом ресурса будут иметь одинаковые поля свойств
ResourceId Полный идентификатор ресурса пользователя
OperationName Операция, связанная с записью журнала
OperationVersion Версия API связана с операцией или версией операции, если имя операции было выполнено с помощью API
CallId Идентификатор вызова, используемого для сопоставления. Можно использовать для идентификации коррелированных событий между несколькими таблицами
ParticipantId Идентификатор участника
SurveyId Идентификатор опроса, отправленного участником. Можно использовать для идентификации коррелированных событий между несколькими таблицами
OverallCallIssues Это поле указывает на любую проблему, связанную с общим вызовом, а его значения — это разделенный запятыми список описаний.
AudioIssues Это поле указывает на любую проблему, связанную с взаимодействием с звуком, а ее значения — это разделенный запятыми список описаний.
VideoIssues Это поле указывает на любую проблему, связанную с интерфейсом видео, а ее значения — это разделенный запятыми список описаний.
ScreenshareIssues Это поле указывает на любую проблему, связанную с интерфейсом общего доступа к экрану, а его значения — это разделенный запятыми список описаний.
OverallRatingScore Это поле представляет общий опыт вызова, оцененный участником
OverallRatingScoreLowerBound Это поле представляет минимальное значение шкалы OverallRatingScore
OverallRatingScoreUpperBound Это поле представляет максимальное значение шкалы OverallRatingScore
OverallRatingScoreThreshold Это поле указывает на значение, указанное выше, которое указывает на лучшее качество.
AudioRatingScore Это поле представляет звуковой интерфейс, оцененный участником
AudioRatingScoreLowerBound Это поле представляет минимальное значение шкалы AudioRatingScore
AudioRatingScoreUpperBound Это поле представляет максимальное значение масштаба AudioRatingScore
AudioRatingScoreThreshold Это поле указывает на значение выше, чем audioRatingScore указывает на лучшее качество.
VideoRatingScore Это поле представляет видеоматериал, оцененный участником
VideoRatingScoreLowerBound Это поле представляет минимальное значение шкалы VideoRatingScore
VideoRatingScoreUpperBound Это поле представляет максимальное значение масштабирования VideoRatingScore
VideoRatingScoreThreshold Это поле указывает, что значение выше, указанное в VideoRatingScore, указывает на лучшее качество.
ScreenshareRatingScore Это поле представляет интерфейс общего доступа к экрану, оцененный участником
ScreenshareLowerBound Это поле представляет минимальное значение масштабирования ScreenshareRatingScore
ScreenshareUpperBound Это поле представляет максимальное значение масштабирования ScreenshareRatingScore
ScreenshareRatingThreshold Это поле указывает на значение, указанное выше, указанное в ScreenshareRatingScore, которое указывает на лучшее качество.

Примеры журналов

Пример общего вызова

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"91c3369f-test-40b0-a4ba-0000003419f9",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/ED463725-1C38-43FC-BD8B-CAC509B41E96/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"CallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"fcc1234f-ce69-ZZZZ-b73f-b036051test4",
        "SurveyId":"a6dd61c4-b924-4885-96a4-a991d4c09e8b",
        "ParticipantId":"91c3369f-test-40b0-a4ba-0000003419f9",
        "OverallCallIssues":"CallCannotJoin",
        "OverallRatingScore":7,
        "OverallRatingScoreLowerBound":0,
        "OverallRatingScoreUpperBound":10,
        "OverallRatingScoreThreshold":5        
    }

}
]

Пример качества звука

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"91c3369f-test-40b0-a4ba-0000003419f9",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/ED463725-1C38-43FC-BD8B-CAC509B41E96/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"EndOfCallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"fcc1234f-ce69-ZZZZ-b73f-b036051test4",
        "SurveyId":"a6dd61c4-xxxx-4885-96a4-a991d4c09e8b",
        "ParticipantId":"91c3369f-test-40b0-a4ba-0000003419f9",
        "AudioIssues":"NoRemoteAudio",      
        "AudioRatingScore":6,
        "AudioRatingScoreLowerBound":0,
        "AudioRatingScoreUpperBound":10,
        "AudioRatingScoreThreshold":4        	
    }
]

Пример качества видео

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"91c3369f-test-40b0-a4ba-0000003419f9",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/ED463725-1C38-43FC-BD8B-CAC509B41E96/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"CallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"fcc87f7f-ce69-eeed-7777-b036051faea4",
        "SurveyId":"a6dd61c4-zzzz-4885-tttt-a991d4c09e8b",
        "ParticipantId":"91c3369f-test-40b0-a4ba-0000003419f9",
        "VideoIssues":"NoVideoReceived",
        "VideoRatingScore":9,
        "VideoRatingScoreLowerBound":0,
        "VideoRatingScoreUpperBound":10,
        "VideoRatingScoreThreshold":7
    }
}
]

Пример для общего доступа к экрану

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"91c3369f-test-40b0-a4ba-0000003419f9",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/ED463725-1C38-43FC-BD8B-CAC509B41E96/RESOURCEGROUPS/ACS-DATALYTICS-SPGW-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-DATALYTICS-ALLTELEMETRY", 
"OperationName":"EndOfCallSurvey", 
"OperationVersion":"0.0"

"properties": 
    {
        "CallId":"1237f7f-ce69-ffff-b73f-b036051f6666",
        "SurveyId":"a6dd6bbb-b924-zzzz-96a4-a991d4c01000",
        "ParticipantId":"91c3369f-test-40b0-a4ba-0000003419f9",
        "ScreenshareIssues":"StoppedUnexpectedly,CannotPresent",
        "ScreenshareRatingScore":2,
        "ScreenshareRatingScoreLowerBound":0,
        "ScreenshareRatingScoreUpperBound":10,
        "ScreenshareRatingScoreThreshold":3
    }
}
]