1. Accès au service / Identifiants
1.1. Service Counter 5
Identifiants Institution :
Nom d’utilisateur et mot de passe identiques à vos identifiants de l’espace Freemium : https://freemium.openedition.org/library
Identifiants Consortium :
Demandez vos identifiants par email à l’adresse : assistance-abonnes@openedition.org
1.2. API Sushi
URL documentation : https://counter5.openedition.org/api/doc
Identifiants Institution :
Nom d’utilisateur (
requestor_id) : identique à votre nom d’utilisateur de l’espace Freemium : https://freemium.openedition.org/libraryClé d’authentification (
api_key) : vous pouvez obtenir et régénerer votre clé dans l”espace Freemium :Menu API > Clé d’authentification.
Si elle n’est pas générée ou si vous souhaitez la modifier, cliquez sur Générer une nouvelle clé.
customer_id: identique aurequestor_id.
Identifiants Consortium :
Demandez vos identifiants par email à l’adresse : assistance-abonnes@openedition.org
Routes API
les rapports disponibles au format Counter 5.0 jusqu’à 2024 sont listées ici : https://counter5.openedition.org/api/reports
les rapports disponibles au format Counter 5.1 à partir de 2025 sont listées ici: https://counter5.openedition.org/api/r51/reports
2. Rapports disponibles
Note
Les statistiques sont disponibles au format Counter 5.0 jusqu’à 2024 et au format Counter 5.1 à partir de 2025.
Les différents rapports disponibles sont présentés ci-dessous. Chaque rapport est proposé sous la forme d’un Master Report, paramétrable, et de Standard Views pour lesquelles les Metric Types, les filtres et les attributs sont présélectionnés.
Les Metric Types sont les différentes mesures d’usage définies par Counter. Vous trouverez plus bas une description de chacune.
L’utilisation d’un filtre dans un Master Report permet de limiter le contenu du rapport à un critère particulier. Par exemple le choix d’un filtre YOP=2020 (Year Of Publication) limitera le rapport aux contenus publiés en 2020.
L’utilisation d’un Attribut dans un Master Report permet de distribuer chaque métrique selon cet attribut. Par exemple le choix d’un attribut YOP (Year Of Publication) pour un rapport TR renverra les métriques pour chaque type par année de publication.
2.1. Platform Reports
2.1.1. PR | Platform Master Report
Rapport personnalisable résumant l’activité sur l’ensemble de la plateforme. Il est paramétrable (filtres et attributs).
Type :
Master Report
Metric Types disponibles :
Total_Item_Investigations
Total_Item_Requests
Unique_Item_Investigations
Unique_Item_Requests
Unique_Title_Investigations
Unique_Title_Requests
Searches_Platform
Filtres disponibles :
Data_Type
Access_Method
Attributs disponibles :
Data_Type (5.0 seulement. Au format 5.1, il est systématiquement appliqué)
Access_Method
2.1.2. PR_P1 | Platform Usage
Rapport d’usage de la plateforme OpenEdition distribué par Metric Type.
Type :
Standard View
Metric Types présélectionnés :
Total_Item_Requests
Unique_Item_Requests
Unique_Title_Requests
Filtres présélectionnés :
Access_Method=Regular
Attributs présélectionnés :
aucun
2.2. Title Reports
2.2.1. TR | Title Master Report
Rapport personnalisable détaillant l’activité pour chaque titre, c’est-à-dire pour chaque livre et chaque revue. Il est paramétrable (filtres et attributs).
Type :
Master Report
Metric Types disponibles :
Total_Item_Investigations
Total_Item_Requests
Unique_Item_Investigations
Unique_Item_Requests
Unique_Title_Investigations
Unique_Title_Requests
No_License
Limit_Exceeded
Filtres disponibles :
Data_Type
Section_Type (Counter 5.0 seulement)
YOP
Access_Type
Access_Method
Attributs disponibles :
Data_Type
Section_Type (Counter 5.0 seulement)
YOP
Access_Type
Access_Method
2.2.2. TR_B1 | Book Requests (Excluding OA_Gold)
Rapports sur l’activité en texte intégral pour les livres, hors contenus en Open Access.
Type :
Standard View
Metric Types présélectionnés :
Total_Item_Requests
Unique_Title_Requests
Filtres présélectionnés :
Data_Type=Book
Access_Type=Controlled
Access_Method=Regular
Attributs présélectionnés :
YOP
2.2.3. TR_B2 | Book Access Denied
Rapport comptabilisant les accès refusés aux livres en accès restreint non acquis par l’institution. OpenEdition ne limite pas le nombre d’accès simultanés à une ressource. Le Metric_Type Limit_Exceeded ne renvoie donc aucun résultat.
Type :
Standard View
Metric Types présélectionnés :
No_License
Limit_Exceeded
Filtres présélectionnés :
Data_Type=Book
Access_Method=Regular
Attributs présélectionnés :
YOP
2.2.4. TR_B3 | Book Usage by Access Type
Rapport portant sur l’utilisation des livres indiquant tous les Metric_Types applicables, distribués par Access_Type (Controlled ou OA_Gold).
Type :
Standard View
Metric Types présélectionnés :
Total_Item_Investigations
Total_Item_Requests
Unique_Item_Investigations
Unique_Item_Requests
Unique_Title_Investigations
Unique_Title_Requests
Filtres présélectionnés :
Data_Type=Book
Access_Method=Regular
Attributs présélectionnés :
YOP
Access_Type
2.2.5. TR_J1 | Journal Requests (Excluding OA_Gold)
Rapports sur l’activité en texte intégral pour les revues, hors contenus en Open Access.
Type :
Standard View
Metric Types présélectionnés :
Total_Item_Requests
Unique_Item_Requests
Filtres présélectionnés :
Data_Type=Journal
Access_Type=Controlled
Access_Method=Regular
Attributs présélectionnés :
aucun
2.2.6. TR_J2 | Journal Access Denied
Rapport comptabilisant les accès refusés aux revues en accès restreint non acquis par l’institution. OpenEdition ne limite pas le nombre d’accès simultanés à une ressource. Le Metric_Type Limit_Exceeded ne renvoie donc aucun résultat.
Type :
Standard View
Metric Types présélectionnés :
No_License
Limit_Exceeded
Filtres présélectionnés :
Data_Type=Journal
Access_Method=Regular
Attributs présélectionnés :
aucun
2.2.7. TR_J3 | Journal Usage by Access Type
Rapport portant sur l’utilisation des revues indiquant tous les Metric_Types applicables, distribués par Access_Type (Controlled ou OA_Gold).
Type :
Standard View
Metric Types présélectionnés :
Total_Item_Investigations
Total_Item_Requests
Unique_Item_Investigations
Unique_Item_Requests
Filtres présélectionnés :
Data_Type=Journal
Access_Method=Regular
Attributs présélectionnés :
Access_Type
2.2.8. TR_J4 | Journal Requests by YOP (Excluding OA_Gold)
Rapport comptablisant les accès au texte intégral pour les revues, hors contenus en Open Access, distribué par année de publication.
Type :
Standard View
Metric Types présélectionnés :
Total_Item_Requests
Unique_Item_Requests
Filtres présélectionnés :
Data_Type=Journal
Access_Type=Controlled
Access_Method=Regular
Attributs présélectionnés :
YOP
3. Metric types
3.1. Investigations / Requests
La spécification Counter 5 distingue les consultations d’éléments de contenu selon les types Request et Investigation.
Une Request est un accès à un élement de contenu en texte intégral : un article en HTML ou en PDF, un numéro de revue complet en PDF, un chapitre de livre ou un livre complet, en HTML, PDF ou ePub.
Une Investigation est un accès à un élement de contenu en texte intégral OU à des informations présentant cet élément de contenu : les accès aux sommaires de numéros de revues ou de livres, les accès aux résumés des articles sous barrière mobile, les accès aux résumés des chapitres de livres en accès exclusif. Notez que les accès de type Requests sont aussi comptabilisés dans les Investigations.
Vous pouvez consulter la description complète et illustrée formulée par Counter à l’adresse suivante : https://cop5.countermetrics.org/en/5.1.0.1/03-specifications/03-counter-report-common-attributes-and-elements.html
3.2. Total_Item_Investigations et Total_Item_Requests
Les mesures Total_Item_Investigations et Total_Item_Requests comptabilisent tous les accès à une ressource. Lorsqu’un utilisateur accède à une ressouce (un article, un ouvrage ou un chapitre d’ouvrage…) plusieurs fois au cours d’une session utilisateur, chaque accès à cette ressource est comptabilisé dans Total_Item_*. Les doubles clics éventuels ne sont pas comptabilisés.
3.3. Unique_Item_Investigations et Unique_Item_Requests
Les mesures Unique_Item_Investigations et Unique_Item_Requests comptabilisent le nombre d’éléments de contenu (chapitres, articles, etc.) ayant fait l’objet d’une Request ou d’une Investigation pris en compte une seule fois par session utilisateur.
3.4. Unique_Title_Investigations et Unique_Title_Requests
Les mesures Unique_Title_Investigations et Unique_Title_Requests ne sont applicables que pour les livres. Elles comptabilisent le nombre d’accès uniques à un livre durant une session utilisateur. Ainsi, les accès d’un lecteur à 3 chapitres d’un livre en texte intégral au cours d’une session ne seront comptabilisés qu’une fois dans la mesure Unique_Title_Requests.
3.5. Item et Livres : Différences 5.0 / 5.1
Les Items sont comptabilisés différement pour le téléchargement d’un livre complet.
Téléchargement en PDF ou ePub d’un livre de 10 chapitres
Mertic |
Counter 5.0 |
Counter 5.1 |
|---|---|---|
Total_Item_Requests |
1 |
10 |
Unique_Item_Requests |
1 |
10 |
Unique_Title_Request |
1 |
1 |
Note
Comme précisé dans les spécifications Counter, cette particularité s’applique uniquement aux livres. Elle ne s’applique pas au téléchargement de numéros complets de revues.
3.6. Session utilisateur
Utilisée dans le calcul des mesures Unique_*, la session d’un utilisateur est définie par 3 critères :
l’adresse IP de l’utilisateur ;
le user-agent de l’utilisateur ;
la date + l’heure de la consultation (comprise entre 0 et 23 ; on ne considère pas les minutes et secondes)
Il s’agit d’une approximation de session. En effet, OpenEdition n’enregistre pas les sessions utilisateurs des lecteurs. Cette méthode est valide selon le Code de pratique Counter 5 : 7.3 Counting Unique Items.
3.7. No_License
Comptabilise les accès refusés à une ressource en accès reservé. Sur OpenEdition, il peut s’agir :
d’articles de revues sous barrière mobile ;
d’articles ou de numéros de revues au format PDF ou ePub pour les revues du bouquet Open Access Freemium, pour les institutions non abonnées ;
de livres ou de chapitre de livres en accès exclusif, non acquis par l’institution ;
de livres ou de chapitre de livres au format PDF ou ePub en accès exclusif ou Open Access Freemium, non acquis par l’institution.
3.8. Limit_Exceeded
OpenEdition ne limite pas le nombre d’accès simultanés à une ressource. Le Metric_Type Limit_Exceeded ne renvoie donc aucun résultat.
3.9. Searches_Platform
Recherches effectuées par les utilisateurs et disponible au niveau Platform uniquement.
Sur OpenEdition, cela correspond aux recherches effectuées :
sur OpenEdition Search (https://search.openedition.org) ;
dans le catalogue des revues (https://www.openedition.org/catalogue-journals) ;
dans le catalogue des livres (https://books.openedition.org/catalogue) ;
dans un livre particulier (ex. https://books.openedition.org/oep/8713?q=archive).
4. API Sushi
La documentation de l’API Sushi est disponible à cette adresse : https://counter5.openedition.org/api/doc.
5. Counter 5 et Access_Type
La notion d’Access_Type a évolué entre Counter 5.0 et Counter 5.1, en particulier pour la diffusion Freemium.
5.1. Counter 5.0 Access_Type et diffusion Freemium
Les revues et les livres publiés en Open Access Freemium sont disponibles en libre accès au format HTML et en accès retreint pour les formats PDF et ePub. De ce fait, et suivant les recommandations du Technical Advisory Group Counter :
Les requêtes sur le contenu HTML sont comptabilisées avec un Access_Type=”OA_Gold”.
Les requêtes sur le contenu PDF et ePub sont comptabilisées avec un Access_type=”Controlled”.
Une instition abonnée pourra donc observer dans ses rapports Counter 5, pour une même revue, des consultations ayant pour Access_Type « OA_Gold » (les consultations aux versions HTML) ET des consultations ayant pour Access_Type « Controlled » (les consultations aux versions PDF et ePub).
5.2. Counter 5.1 access_type et diffusion Freemium
Le code de bonnes pratiques COUNTER exige un seul Access_Type pour chaque élément (Item) et recommande d’utiliser le type d’accès le plus restrictif lorsque différentes parties de l’élément peuvent avoir des règles d’accès différentes.
Dans le cas de la diffusion en Open access Freemium, toutes les consultations sont donc qualifiées avec Access_Type = Controlled
5.3. Tableau récupitualtif des Access_Type
Counter 5.0 |
Counter 5.1 |
|
|---|---|---|
Revue à barrière mobile |
||
Articles sous la barrière mobile |
Controlled |
Controlled |
Articles hors barrière mobile |
Controlled |
Open |
Revue en Open Access |
||
Tous les articles |
OA_Gold |
Open |
Revue en Open Access Freemium |
||
Tous les articles au format HTML |
OA_Gold |
Controlled |
Tous les articles au format PDF ou ePub |
Controlled |
Controlled |
Livre en Open Access |
||
Tous les chapitres, tous les formats |
OA_Gold |
Open |
Livre en accès exclusif |
||
Tous les chapitres, tous les formats |
Controlled |
Controlled |
Livre en Open Access Freemuim |
||
Tous les chapitres au format HTML |
OA_Gold |
Controlled |
Tous les chapitres au format PDF ou ePub |
Controlled |
Controlled |
6. Dates et durée de disponibilité des rapports
Les rapports pour un mois donné sont disponibles à partir du 5 du mois suivant.
Les rapports sont disponibles pour une durée de 2 ans plus l’année courante. Ainsi, les rapports de janvier 2024 et de février 2024 seront disponibles jusqu’au 31/12/2026. Il sera impossible de régénérer les rapports une fois la période de disponibilité écoulée. Les données devront donc avoir été moissonnées préalablement.
7. Certification
Le service Counter 5 d’OpenEdition a été certifié pour Counter 5.0 par un audit indépendant en 2021.
La certification pour Counter 5.1 est prévue en 2026.
https://registry.projectcounter.org/platform/9fd59d9f-a669-4756-a4b0-1efeeaf14746