Afficher et configurer des rapports d'utilisation analytique dans SharePoint Server

S’APPLIQUE À :  yes-img-13 2013  yes-img-16 2016  yes-img-19 2019  yes-img-se Subscription Edition  no-img-sop SharePoint in Microsoft 365

L’article précédent de cette série, Use recommendations and popular items on websites with anonymous users in SharePoint Server, expliquait comment afficher des recommandations sur un site web avec des utilisateurs anonymes. Voici les titres des sections de cet article :

Notes

Les exemples de cette série sont basés sur un déploiement SharePoint Server local.

En savoir plus sur l’affichage des données d’utilisation SharePoint site web dans Microsoft 365.

À propos des rapports d’analyse de l’utilisation

Les rapports d'analyse de l'utilisation présentent des statistiques sur les interactions des visiteurs avec le contenu de votre site web, par exemple, l'élément le plus consulté. Les rapports sont organisés par événement Actions utilisateur. Par défaut, la répartition de ce rapport signifie que vous pourrez voir :

  • Le nombre d’affichages par élément

  • Le nombre de suggestions affichées par élément

  • Le nombre de suggestions consultées par élément

SharePoint Server crée deux rapports d’analyse de l’utilisation :

  • Éléments les plus populaires affiche les statistiques des événements d’utilisation pour tous les éléments d’une bibliothèque ou d’une liste

  • Tendances de popularité : affiche les statistiques des événements d’utilisation pour un élément, un site ou une collection de sites

Les rapports sont automatiquement mis à jour toutes les 24 heures, lorsque la tâche d’analyse de l’utilisation est exécutée.

Dans un scénario de publication intersites dans lequel vous affichez le contenu du catalogue sur un site de publication, vous visualisez le rapport Éléments les plus populaires sur votre site de création. Voici les étapes à suivre :

  1. Sur votre site de création, accédez à votre catalogue.

  2. Click the LIST tab -> Most Popular Items.

    Icône des éléments les plus populaires

  3. Sur la page Éléments les plus populaires, accédez au menu pour sélectionner l'événement Actions utilisateur pour lequel vous souhaitez afficher les statistiques.

    Événement Actions utilisateur Pull Down

    Notes

    Vous pouvez afficher des statistiques pour l Recommandations d’utilisation Affiche dans le rapport Afficher les tendances de popularité d’un élément.

Modification de la période Récent d’un événement Actions utilisateur

Sur la page Éléments les plus populaires, deux périodes sont disponibles : Récent et Toujours.

Toujours récent

La période Toujours affiche les statistiques depuis le premier jour où un événement Actions utilisateur a été enregistré. Par défaut, la période Récent est définie sur les 14 derniers jours. Voici les étapes à suivre pour afficher les paramètres par défaut d'un événement Actions utilisateur :

  1. Sur le serveur sur lequel SharePoint Server est installé, ouvrez SharePoint 2013 Management Shell.

    SharePoint 2013 Management Shell

  2. À l'invite de commandes Microsoft PowerShell, tapez les commandes suivantes :

$ssp = Get-SPEnterpriseSearchServiceApplicationProxy
$tenantConfig = $ssp.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object {$_.EventTypeId -eq <EventTypeId>}
$event

EventTypeId est l’affichage numérique des définitions des événements d’utilisation de l’événement d’utilisation que vous souhaitez afficher. Dans l’exemple suivant, nous allons afficher l’événement Views. Par conséquent, nous allons entrer 1.

Période de popularité récente par défaut

La période Récent est définie par la propriété RecentPopularityTimeframe. Nous pouvons modifier la période Récent et la définir sur n'importe quelle valeur entre 1 et 14 jours. Voici la procédure pour modifier la période :

  1. Dans l SharePoint 2016 Management Shell, à l’invite de commandes Microsoft PowerShell, tapez les commandes suivantes :
$ssp = Get-SPEnterpriseSearchServiceApplicationProxy
$tenantConfig = $ssp.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event.RecentPopularityTimeFrame = <TimeFrame>
$tenantConfig.Update($ssp)

EventTypeId est l’affichage numérique des définitions des événements d’utilisation de l’événement d’utilisation que nous voulons modifier. TimeFrame est la nouvelle période que nous voulons définir pour l’événement d’utilisation.

Dans l’exemple suivant, pour modifier l’heure Des affichages récents à une semaine, entrez 1 et 7.

Définir Récent sur 7

  1. Pour vérifier la modification, à l’invite de commandes Microsoft PowerShell, tapez la commande suivante :
$event

Popularité récente définie sur 7

Vous remarquerez que la valeur du paramètre RecentPopularityTimeframe est passée à 7.

L’affichage des rapports d’utilisation par événement d’utilisation est utile lorsque nous voulons voir comment les visiteurs interagissent avec notre site. Mais de nombreuses fois, nous voulons restreindre le rapport à un attribut ou une catégorie spécifique, par exemple tous les éléments en solde ou tous les ordinateurs portables. Pour affiner le rapport, nous pouvons utiliser le langage KQL (Keyword Query Language) Si vous ne connaissez pas KQL, ne vous inquiétez pas. Vous pouvez aisément affiner votre rapport Éléments les plus populaires sans avoir une connaissance approfondie de la syntaxe KQL.

Dans notre catalogue Contoso, nous avons une colonne de site appelée RetOnSale. Pour chaque élément, la valeur de RetOnSale indique si l’élément est en solde ou pas.

Colonne de retour sur ventes

Pour affiner le rapport Éléments les plus populaires afin d'afficher uniquement les éléments en solde, nous allons utiliser la propriété gérée qui représente la colonne de site RetOnSale . Dans notre scénario Contoso, il s’agit de RetOnSale (voir Comment trouver un nom de propriété gérée).

Dans le schéma de recherche, nous pouvons voir que la propriété gérée RetOnSale est utilisable dans une requête. Cela signifie que nous pouvons l’utiliser pour affiner le rapport Éléments les plus populaires.

Requête de retour sur ventes

Pour visualiser les statistiques de l’événement Actions utilisateur Affichages pour les éléments en solde, sur la page Éléments les plus populaires, sélectionnez Affichages les plus fréquents et entrez RetOnSale=True.

Rapport de retour sur ventes

Ainsi, seuls les éléments en solde sont affichés.

Vous pouvez également affiner les statistiques d’événement Actions utilisateur sur une catégorie spécifique, par exemple tous les ordinateurs portables. Dans notre scénario Contoso, la colonne de site Catégorie d’élément est utilisée pour spécifier la catégorie de chaque élément.

Colonne de site de catégorie d'élément

Le nom de la propriété gérée de la colonne Catégorie d’élément est owstaxIdProductCatalogItemCategory. La propriété gérée owstaxIdProductCatalogItemCategory est utilisable dans une requête, ce qui signifie que nous pouvons l’utiliser pour affiner le rapport Éléments les plus populaires.

Catégorie d'élément du catalogue de produits owstax ID

Pour voir quels ordinateurs portables sont les plus consultés par les visiteurs, sur la page Éléments les plus populaires, sélectionnez La plupart des affichages, puis entrez owstaxIdProductCatalogItemCategory:Laptops.

Vues Ordinateur portable

En affinant les statistiques de l’événement Actions utilisateur Affichages sur une catégorie spécifique, nous pouvons vérifier que le composant WebPart Éléments populaires fonctionne correctement sur notre site de publication. Par exemple, sur la page Ordinateurs portables, notez que les trois éléments qui sont affichés dans le partie Web Éléments populaires sont les mêmes que ceux affichés pour avoir le plus de vues dans le rapport Éléments les plus populaires que nous venons de restreindre aux ordinateurs portables.

Éléments populaires - Publication et rapports

Il existe deux moyens d'accéder au rapport Tendances de popularité d'un élément :

  • Sur votre catalogue, sélectionnez l'élément pour lequel vous voulez afficher le rapport Tendances de popularité. Dans le ruban, cliquez sur ÉLÉMENTS --> Tendances de popularité.

    Icône Tendances de popularité

  • Sur la page Éléments les plus populaires, cliquez sur Tendances de popularité.

    Lien Tendances de popularité

Ces deux options ouvrent une feuille Microsoft Excel où vous pouvez voir les statistiques quotidiennes et mensuelles de l'élément. Chaque événement Actions utilisateur est affiché dans un onglet séparé.

Rapport Tendances de popularité

À propos du paramètre TailTrimming

Alors que nous sommes sur le sujet des rapports d’analyse de l’utilisation, un paramètre d’événement d’utilisation qui vaut la peine d’être mentionné est TailTrimming. Ce paramètre indique si les chiffres qui sont présentés dans les rapports d'analyse de l'utilisation doivent être mis à jour.

Important

Ce paramètre n’a pas d’impact sur le mode de calcul des suggestions.

Par exemple, pour l’événement Actions utilisateur Affichages, le paramètre TailTrimming par défaut est défini sur 3.

Filtrage de fichier 3

Cela signifie que les rapports d’analyse de l’utilisation seront mis à jour pour un élément lorsque l’élément a été visionisé au moins trois fois au cours des dernières 24 heures. Par exemple, si l’élément Fabrikam Laptop16 M6000 a été affiché deux fois au cours des dernières 24 heures, ces deux affichages ne seront pas affichés dans les rapports d’analyse de l’utilisation. Si, dans les prochaines 24 heures, l’élément Fabrikam Laptop16 M6000 est vu quatre fois, le rapport d’analyse de l’utilisation sera mis à jour avec quatre affichages.

Si le paramètre TailTrimming est défini sur 3, c’est pour éviter d’avoir à mettre à jour les éléments que presque aucun des visiteurs de votre site web ne consultent. En ne mettant pas ces éléments à jour, vous réduisez la charge appliquée à votre système. D’autre part, lorsque le paramètre TailTrimming est défini sur 3, les rapports d’analyse de l’utilisation peuvent être quelque peu imprécis. Dans l’exemple avec Fabrikam Laptop16 M6000, les deux affichages des premières 24 heures ne seront pas affichés dans les rapports analytiques d’utilisation. Le nombre total de vues de Fabrikam Laptop16 M6000 au cours des dernières 48 heures affiche 4, mais en réalité, il a été vu six fois.

Si vous souhaitez que les rapports d’analyse de l’utilisation soient mis à jour quel que soit le nombre minimal de vues au cours des dernières 24 heures, effectuer les tâches suivantes :

  1. Dans l SharePoint 2016 Management Shell, à l’invite de commandes Microsoft PowerShell, tapez les commandes ci-après :
$ssp = Get-SPEnterpriseSearchServiceApplicationProxy
$tenantConfig = $ssp.GetAnalyticsTenantConfiguration([Guid]::Empty)
$event = $tenantConfig.EventTypeDefinitions | where-object { $_.EventTypeId -eq <EventTypeId> }
$event.TailTrimming = <TailTrimming>
$tenantConfig.Update($ssp)

EventTypeId est l’affichage numérique des définitions des événements d’utilisation de l’événement d’utilisation à modifier, et TailTrimming est le nombre minimal de fois que l’événement d’utilisation doit se produire dans les 24 heures pour que les rapports d’analyse de l’utilisation soient mis à jour.

Dans l’exemple suivant, nous voulons que les rapports d’analyse de l’utilisation pour l’événement Actions utilisateur Affichages soient mis à jour si un événement Actions utilisateur Affichages se produit dans les 24 heures. Par conséquent, nous avons saisi 1 et 0.

Modifier le filtrage du fichier

  1. Pour vérifier la modification, à l’invite de commandes Microsoft PowerShell, tapez la commande suivante :
$event

Filtrage de fichier modifié

Notez que la valeur du paramètre TailTrimming a été modifiée pour prendre la valeur 0.

Ainsi, avec cette modification, cette série a pris fin. Nous espérons que vous comprenez désormais mieux le fonctionnement des suggestions et des éléments populaires, et que vous pouvez commencer à les ajouter à votre site web.