Partager via

Fin de l’enquête sur les appels

  • Article

Remarque

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

Comment utiliser les journaux d’appels

Nous vous recommandons de collecter tous les journaux d’appels disponibles dans une ressource Log Analytics afin de pouvoir surveiller votre utilisation des appels et d’améliorer la qualité des appels, et pour pouvoir recevoir de nouveaux journaux d’Azure Communication Services dès qu’ils sont publiés.

Vous pouvez utiliser deux outils principaux pour surveiller vos appels et améliorer leur qualité.

Nous vous recommandons d’utiliser les tableaux de bord Tableau de bord des insights vocaux et vidéo pour démarrer des investigations de qualité et d’utiliser les diagnostics d’appel si nécessaire pour explorer des appels individuels quand vous avez besoin de détails précis.

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 à l’une de ces options, vos données d’enquête ne seront pas stockées et seront perdues. Vous trouverez ci-dessous des instructions sur la configuration de 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 l’enquête de fin 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

Ce tableau décrit chaque propriété.

Propriété 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
    }
}
]

Forum aux questions

Comment stocker les journaux ?

La section suivante décrit cette exigence.

Les journaux Azure Communication Services ne sont pas stockés dans votre compte Azure par défaut. Vous devez donc commencer à les stocker pour que les outils comme le Tableau de bord des insights vocaux et vidéo et les diagnostics d’appel fonctionnent. Pour collecter les journaux des appels, vous devez activer un paramètre de diagnostic qui dirige les données d’appel vers un espace de travail Log Analytics.

Les données ne sont pas stockées rétroactivement, par conséquent vous commencez à capturer les journaux des appels uniquement après avoir configuré le paramètre de diagnostic.

Pour ajouter des paramètres de diagnostic à votre ressource, suivez les instructions de Activer les journaux via des paramètres de diagnostic dans Azure Monitor. Nous vous recommandons de collecter tous les journaux initialement. Une fois que vous avez compris les fonctionnalités d’Azure Monitor, déterminez les journaux que vous voulez conserver et pendant combien de temps. Quand vous ajoutez votre paramètre de diagnostic, vous êtes invité à sélectionner des journaux. Pour collecter tous les journaux, sélectionnez allLogs.

Le volume de vos données, leur conservation et leur utilisation dans Log Analytics au sein d’Azure Monitor sont facturés via les compteurs de données Azure existants. Nous vous recommandons d’analyser vos stratégies d’utilisation et de conservation des données pour des considérations de coût si nécessaire. Pour plus d’informations, consultez Contrôler les coûts.

Si vous avez plusieurs ID de ressource Azure Communications Services, vous devez activer ces paramètres pour chaque ID de ressource.

Étapes suivantes