Compartilhar via

Pesquisa de final de chamada

  • Artigo

Observação

No momento, o Inquérito de Fim de Chamada tem suporte somente no nosso SDK do JavaScript / Web .

Pré-requisitos

Os Serviços de Comunicação do Azure fornecem recursos de monitoramento e análise por meio da Visão geral de Logs do Azure Monitor e Métricas do Azure Monitor. Cada recurso do Azure requer sua própria configuração de diagnóstico, o que define os seguintes critérios:

  • As categorias de logs e os dados de métrica enviados aos destinos definidos na configuração. As categorias disponíveis irão variar para diferentes tipos de recursos.
  • Um ou mais destinos para enviar os logs. Os destinos atuais incluem o workspace do Log Analytics, os Hubs de Eventos e o Armazenamento do Microsoft Azure.
  • Uma única configuração de diagnóstico pode definir apenas um de cada um dos destinos. Se você quiser enviar dados para mais de um tipo de destino específico (por exemplo, dois workspaces do Log Analytics diferentes), crie várias configurações. Cada recurso pode ter até cinco configurações de diagnóstico.

Importante

Você deve habilitar uma Configuração de Diagnóstico no Azure Monitor para enviar os dados de log de suas pesquisas para um workspace do Log Analytics, Hubs de Eventos ou uma conta de armazenamento do Azure para receber e analisar os dados da pesquisa. Se você não enviar dados da pesquisa para uma dessas opções, seus dados da pesquisa não serão armazenados e serão perdidos. A seguir estão as instruções para configurar seu recurso do Azure Monitor para começar a criar logs e métricas para seus Serviços de Comunicação. Para ver a documentação detalhada sobre como usar Configurações de Diagnóstico em todos os recursos do Azure, consulte Habilitar o registro em log em Configurações de Diagnóstico

Observação

No nome da configuração de diagnóstico, selecione “Pesquisa de chamadas” para habilitar os registros para pesquisa de fim de chamada.

Captura de tela das configurações de diagnóstico para pesquisa de chamadas.

Visão geral

A implementação de registros de pesquisa de fim de chamada representa uma funcionalidade ampliada dentro dos Serviços de Comunicação do Azure (Azure Communication Services), permitindo que a Contoso envie pesquisas para coletar feedback subjetivo dos clientes sobre sua experiência de chamada. Essa abordagem visa complementar a avaliação da qualidade das chamadas além de métricas objetivas, como taxa de bits de áudio e vídeo, jitter e latência, que podem não capturar totalmente se um cliente teve uma experiência satisfatória ou insatisfatória. Ao aproveitar os logs do Azure para publicar e examinar dados de pesquisa, a Contoso obtém insights para análise e identificação de áreas que precisam de melhorias. Os resultados desta pesquisa servem como um recurso valioso para que os Serviços de Comunicação do Azure monitorem e aprimorem continuamente a qualidade e a confiabilidade. Para mais detalhes sobre Pesquisa de fim de chamada

A Pesquisa de Fim de Chamada é uma ferramenta valiosa que permite coletar insights sobre como os usuários finais percebem a qualidade e a confiabilidade da sua solução de chamada JavaScript/Web SDK. Os logs que acompanham contêm dados cruciais que ajudam a avaliar a experiência dos usuários finais, incluindo:

Chamada geral: as respostas indicam como um participante da chamada percebeu a qualidade geral da chamada.

  • Áudio: As respostas indicam se o usuário percebeu algum problema de áudio.
  • Vídeo: as respostas indicam se o usuário percebeu algum problema com o vídeo.
  • Compartilhamento de tela: as respostas indicam se o usuário percebeu algum problema de compartilhamento de tela. Além do acima, as marcas opcionais nas respostas oferecem mais insights sobre tipos específicos de problemas relacionados a áudio, vídeo ou compartilhamento de tela.

Ao analisar os dados capturados nos registros da Pesquisa de Fim de Chamada, você pode identificar áreas que precisam de melhorias, melhorando assim a experiência geral do usuário.

Categorias de log de recursos

Os Serviços de Comunicação seguintes tipos de logs que você pode habilitar:

  • Registros da pesquisa de fim de chamada - fornece informações básicas relacionadas à pesquisa no final da chamada

Propriedades

Propriedade Descrição
Timegenerated Esse campo representa o registro de data e hora (UTC) de quando o log foi gerado
CorrelationId O ID para eventos correlacionados pode ser usado para identificar eventos correlacionados entre várias tabelas
Category A categoria de log do evento. Logs com a mesma categoria de log e tipo de recurso terão os mesmos campos de propriedades
ResourceId O identificador completo do recurso do usuário
OperationName A operação associada ao registro de log
OperationVersion A versão da API está associada à operação ou versão da operação se o operationName foi executado usando uma API
CallId O identificador da chamada usada para correlacionar. Pode ser usado para identificar eventos correlacionados entre várias tabelas
ParticipantId A identificação do participante
SurveyId O identificador de uma pesquisa enviada por um participante. Pode ser usado para identificar eventos correlacionados entre várias tabelas
OverallCallIssues Esse campo indica qualquer problema relacionado à chamada geral e seus valores são uma lista de descrições separadas por vírgulas.
AudioIssues Esse campo indica qualquer problema relacionado à experiência de áudio e seus valores são uma lista de descrições separadas por vírgulas
VideoIssues Esse campo indica qualquer problema relacionado à experiência do vídeo e seus valores são uma lista de descrições separadas por vírgulas
ScreenshareIssues Esse campo indica qualquer problema relacionado à experiência de compartilhamento de tela e seus valores são uma lista de descrições separadas por vírgulas
OverallRatingScore Esse campo representa a experiência geral da chamada avaliada pelo participante
OverallRatingScoreLowerBound Esse campo representa o valor mínimo da escala OverallRatingScore
OverallRatingScoreUpperBound Esse campo representa o valor máximo da escala OverallRatingScore
OverallRatingScoreThreshold Esse campo indica o valor acima do qual o OverallRatingScore indica melhor qualidade
AudioRatingScore Esse campo representa a experiência de áudio avaliada pelo participante
AudioRatingScoreLowerBound Esse campo representa o valor mínimo da escala AudioRatingScore
AudioRatingScoreUpperBound Esse campo representa o valor máximo da escala AudioRatingScore
AudioRatingScoreThreshold Esse campo indica o valor acima do qual o AudioRatingScore indica melhor qualidade
VideoRatingScore Esse campo representa a experiência de vídeo avaliada pelo participante
VideoRatingScoreLowerBound Esse campo representa o valor mínimo da escala VideoRatingScore
VideoRatingScoreUpperBound Esse campo representa o valor máximo da escala VideoRatingScore
VideoRatingScoreThreshold Esse campo indica o valor acima do qual o VideoRatingScore indica melhor qualidade
ScreenshareRatingScore Esse campo representa a experiência de compartilhamento de tela avaliada pelo participante
ScreenshareLowerBound Esse campo representa o valor mínimo da escala ScreenshareRatingScore
ScreenshareUpperBound Esse campo representa o valor máximo da escala ScreenshareRatingScore
ScreenshareRatingThreshold Esse campo indica o valor acima do qual o ScreenshareRatingScore indica melhor qualidade

Exemplos de logs

Exemplo para a chamada geral

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "OverallCallIssues":"CallCannotJoin",
        "OverallRatingScore":7,
        "OverallRatingScoreLowerBound":0,
        "OverallRatingScoreUpperBound":10,
        "OverallRatingScoreThreshold":5        
    }

}
]

Exemplo para a qualidade de áudio

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "AudioIssues":"NoRemoteAudio",      
        "AudioRatingScore":6,
        "AudioRatingScoreLowerBound":0,
        "AudioRatingScoreUpperBound":10,
        "AudioRatingScoreThreshold":4        	
    }
]

Exemplo de qualidade de vídeo

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "VideoIssues":"NoVideoReceived",
        "VideoRatingScore":9,
        "VideoRatingScoreLowerBound":0,
        "VideoRatingScoreUpperBound":10,
        "VideoRatingScoreThreshold":7
    }
}
]

Exemplo para compartilhamento de tela

[
{
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"TimeGenerated":"2023-04-12T14:21:35.0700920Z", 
"CorrelationId":"aaaa0000-bb11-2222-33cc-444444dddddd",
"Category":"CallSurvey", 
"ResourceId":"/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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":"aaaa0000-bb11-2222-33cc-444444dddddd",
        "ScreenshareIssues":"StoppedUnexpectedly,CannotPresent",
        "ScreenshareRatingScore":2,
        "ScreenshareRatingScoreLowerBound":0,
        "ScreenshareRatingScoreUpperBound":10,
        "ScreenshareRatingScoreThreshold":3
    }
}
]