Partager via


Fin de l’enquête sur les appels

Remarque

L’enquête de fin d’appel est actuellement pris en charge uniquement pour notre SDK JavaScript/Web.

Prérequis

Azure Communications Services fournit des fonctionnalités de surveillance et d’analytique via la vue d’ensemble des journaux Azure Monitor et les métriques Azure Monitor. Chaque ressource Azure requiert son propre paramètre de diagnostic, qui définit les critères suivants :

  • Catégories de journaux et données de métriques envoyées aux destinations définies dans le paramètre. Les catégories disponibles varient en fonction des types de ressources.
  • Une ou plusieurs destinations auxquelles envoyer les journaux. Les destinations actuelles sont l’espace de travail Log Analytics, Event Hubs et le Stockage Azure.
  • Un seul paramètre de diagnostic ne peut pas définir plus d’une destination. Si vous souhaitez envoyer des données à plus d’un type de destination (par exemple, deux espaces de travail Log Analytics), créez plusieurs paramètres. Chaque ressource peut avoir jusqu’à cinq paramètres de diagnostic.

Important

L'activation d'un paramètre de diagnostic dans Azure Monitor est nécessaire pour envoyer les données de journal de vos enquêtes à un espace de travail Log Analytics, à Event Hubs ou encore à un compte de stockage Azure afin de recevoir et d'analyser les données de vos enquêtes. Si vous n’envoyez pas de données d’enquête à une de ces options, vos données d’enquête ne seront pas stockées et seront perdues. Les instructions suivantes permettent de configurer votre ressource Azure Monitor pour commencer à créer des journaux et des métriques pour vos services de communication. Pour obtenir une documentation détaillée sur l’utilisation des paramètres de diagnostic pour toutes les ressources Azure, consultez Activer la journalisation dans les paramètres de diagnostic.

Remarque

Sous le nom du paramètre de diagnostic, sélectionnez « Enquête d’appel » pour activer les journaux pour la fin de l’enquête d’appel.

Capture d’écran des paramètres de diagnostic pour l’enquête d’appel.

Vue d’ensemble

L’implémentation des journaux d’enquête de fin d’appel représente une fonctionnalité augmentée dans Azure Communication Services (Azure Communication Services), ce qui permet à Contoso de soumettre des enquêtes pour recueillir les commentaires subjectifs des clients sur leur expérience d’appel. Cette approche vise à compléter l’évaluation de la qualité des appels au-delà des métriques objectives telles que le débit audio et vidéo, et l’instabilité et la latence, qui ne capturent pas toujours complètement le niveau de satisfaction du client vis-à-vis de son expérience. En exploitant les journaux Azure pour publier et examiner les données d’enquête, Contoso obtient des insights pour l’analyse et l’identification des domaines qui nécessitent des améliorations. Ces résultats de l’enquête sont une ressource précieuse pour Azure Communication Services pour surveiller et améliorer en continu la qualité et la fiabilité. Pour plus d’informations sur Enquête de fin d’appel

L’enquête de fin d’appel est un outil précieux qui vous permet de recueillir des informations sur la façon dont les utilisateurs finaux perçoivent la qualité et la fiabilité de votre solution d’appel SDK Web/JavaScript. Les journaux d’activité associés contiennent des données cruciales qui permettent d’évaluer l’expérience des utilisateurs finaux, notamment :

Appel global : les réponses indiquent comment un participant à un appel a perçu la qualité globale de l’appel.

  • Audio : les réponses indiquent si l’utilisateur a rencontré des problèmes audio.
  • Vidéo : les réponses indiquent si l’utilisateur a rencontré des problèmes vidéo.
  • Partage d’écran : les réponses indiquent si l’utilisateur a rencontré des problèmes de partage d’écran. En plus des balises ci-dessus, les balises facultatives dans les réponses offrent des insights supplémentaires sur des types spécifiques de problèmes liés à l’audio, à la vidéo ou au partage d’écran.

En analysant les données capturées dans les journaux d’enquête de fin d’appel, vous pouvez identifier les zones qui nécessitent une amélioration, ce qui améliore l’expérience utilisateur globale.

Catégories de journaux de ressources

Communication Services propose les types de journaux suivants que vous pouvez activer :

  • L’enquête de fin d’appel : fournit des informations de base relatives à l’enquête de fin d’appel

Propriétés

Property Description
Timegenerated Ce champ représente l’horodatage (UTC) du moment où le journal a été généré
CorrelationId L’ID des événements corrélés peut être utilisé pour identifier les événements corrélés entre plusieurs tables
Category Catégorie de journal de l’événement. Les journaux avec la même catégorie de journal et le même type de ressource auront les mêmes champs de propriétés
ResourceId Identificateur de longueur complète de la ressource de l’utilisateur
OperationName Opération associée à l’enregistrement du journal
OperationVersion La version de l’API est associée à l’opération ou à la version de l’opération si l’operationName a été effectué à l’aide d’une API
CallId Identificateur de l’appel utilisé pour la mise en corrélation. Peut être utilisé pour identifier les événements corrélés entre plusieurs tables
ParticipantId ID du participant
SurveyId Identificateur d’une enquête soumise par un participant. Peut être utilisé pour identifier les événements corrélés entre plusieurs tables
OverallCallIssues Ce champ indique tout problème lié à l’appel global, et ses valeurs sont une liste de descriptions séparées par des virgules
AudioIssues Ce champ indique tout problème lié à l’expérience audio, et ses valeurs sont une liste de descriptions séparées par des virgules
VideoIssues Ce champ indique tout problème lié à l’expérience vidéo, et ses valeurs sont une liste de descriptions séparées par des virgules
ScreenshareIssues Ce champ indique tout problème lié à l’expérience de partage d’écran, et ses valeurs sont une liste de descriptions séparées par des virgules
OverallRatingScore Ce champ représente l’expérience d’appel globale évaluée par le participant
OverallRatingScoreLowerBound Ce champ représente la valeur minimale de l’échelle OverallRatingScore
OverallRatingScoreUpperBound Ce champ représente la valeur maximale de l’échelle OverallRatingScore
OverallRatingScoreThreshold Ce champ indique la valeur au-dessus de laquelle le score OverallRatingScore indique une meilleure qualité
AudioRatingScore Ce champ représente l’expérience audio évaluée par le participant
AudioRatingScoreLowerBound Ce champ représente la valeur minimale de l’échelle AudioRatingScore
AudioRatingScoreUpperBound Ce champ représente la valeur maximale de l’échelle AudioRatingScore
AudioRatingScoreThreshold Ce champ indique la valeur au-dessus de laquelle le score AudioRatingScore indique une meilleure qualité
VideoRatingScore Ce champ représente l’expérience vidéo évaluée par le participant
VideoRatingScoreLowerBound Ce champ représente la valeur minimale de l’échelle VideoRatingScore
VideoRatingScoreUpperBound Ce champ représente la valeur maximale de l’échelle VideoRatingScore
VideoRatingScoreThreshold Ce champ indique la valeur au-dessus de laquelle le score VideoRatingScore indique une meilleure qualité
ScreenshareRatingScore Ce champ représente l’expérience de partage d’écran évaluée par le participant
ScreenshareLowerBound Ce champ représente la valeur minimale de l’échelle ScreenshareRatingScore
ScreenshareUpperBound Ce champ représente la valeur maximale de l’échelle ScreenshareRatingScore
ScreenshareRatingThreshold Ce champ indique la valeur au-dessus de laquelle le score ScreenshareRatingScore indique une meilleure qualité

Exemples de journaux

Exemple pour l’appel global

[
{
"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        
    }

}
]

Exemple pour la qualité de l’audio

[
{
"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        	
    }
]

Exemple pour la qualité de la vidéo

[
{
"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
    }
}
]

Exemple pour le partage d’écran

[
{
"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
    }
}
]