# Analytique des éditeurs

> [!WARNING]
> Cette fonctionnalité fait partie des offres Team & Enterprise.

## Tableau de bord d'analyse de l'éditeur

Suivez toute l’activité de vos dépôts grâce à un aperçu détaillé des téléchargements, qui affiche le nombre total de téléchargements pour tous les Models et Datasets publiés par votre organisation. Basculez entre les vues « All Time » et « Last Month » pour obtenir des informations sur vos dépôts sur différentes périodes.

### Répartition par dépôt

Explorez les métriques des dépôts individuels grâce au tableau de détail par dépôt. Utilisez la fonction de recherche intégrée pour localiser rapidement des dépôts spécifiques. Chaque ligne comporte également un graphique en série temporelle qui illustre l’évolution des téléchargements au fil du temps.

## Exporter les analyses de l’éditeur au format CSV

Téléchargez un fichier CSV complet contenant les analyses de l’ensemble de vos dépôts, y compris l’activité de téléchargement des modèles et des jeux de données.

Vous pouvez également accéder à ces données de manière programmatique via le point de terminaison d'API suivant :

```bash
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  "https://huggingface.co/organizations/YOUR_ORG_NAME/settings/publisher-analytics/download-breakdown" \
  --output breakdown.csv
```

### Structure de la réponse

Le fichier CSV est composé des enregistrements de téléchargements quotidiens pour chacun de vos modèles et jeux de données.

```csv
repoType,repoName,total,timestamp,downloads
model,huggingface/CodeBERTa-small-v1,4362460,2021-01-22T00:00:00.000Z,4
model,huggingface/CodeBERTa-small-v1,4362460,2021-01-23T00:00:00.000Z,7
model,huggingface/CodeBERTa-small-v1,4362460,2021-01-24T00:00:00.000Z,2
dataset,huggingface/documentation-images,2167284,2021-11-27T00:00:00.000Z,3
dataset,huggingface/documentation-images,2167284,2021-11-28T00:00:00.000Z,18
dataset,huggingface/documentation-images,2167284,2021-11-29T00:00:00.000Z,7
```

### Structure d'objet du dépôt

Chaque enregistrement du CSV contient :

- `repoType` : le type de dépôt (par exemple, "model", "dataset")
- `repoName` : Nom complet du dépôt, y compris l'organisation (par exemple, "huggingface/documentation-images")
- `total` : Nombre cumulé de téléchargements pour ce dépôt
- `timestamp` : date au format ISO 8601 (UTC)
- `downloads` : Nombre de téléchargements pour ce jour-là

Les enregistrements sont ordonnés chronologiquement et offrent une vue granulaire quotidienne de l'activité de téléchargement pour chaque dépôt.

> [!NOTE]
> Les chiffres de téléchargement ne sont **pas** dédupliqués par utilisateur. Si vous avez besoin de compteurs de téléchargements uniques, reportez-vous à la section suivante.

## Téléchargeurs uniques et journaux plus granulaires

> [!WARNING]
> Cette fonctionnalité est un module complémentaire pour l'offre Enterprise Plus.

En tant que fonctionnalité avancée, Hugging Face peut exporter des journaux d’accès anonymisés au niveau de la requête pour tous les modèles et jeux de données publiés par votre organisation. Chaque ligne représente une requête unique liée à un téléchargement, vous offrant une granularité complète sur les données de téléchargement de vos modèles et jeux de données.

Votre équipe est responsable de l’ingestion de ces journaux et de l’exécution de calculs sur ceux-ci. L’export inclut volontairement les codes de statut HTTP bruts et les méthodes afin que vous puissiez classifier les motifs de requête `HEAD`, contenu partiel, redirection et autres, en fonction de vos propres besoins analytiques.

| Colonne         | Description                                             |
| -------------- | ------------------------------------------------------- |
| `timestamp`    | Horodatage de la requête                                       |
| `status`       | Code de statut HTTP (par exemple `200`, `206`, `302`, `307`, `304`) |
| `method`       | Méthode HTTP (par exemple `GET`, `HEAD`)                 |
| `repoName`     | Nom complet du dépôt (par ex. `nvidia/segformer-b0`)             |
| `repoType`     | Type de dépôt : `model`, `dataset` ou `space`         |
| `hashedUserId` | Hachage non réversible de l'identifiant utilisateur (si authentifié)       |
| `hashedIp`     | Hachage non réversible de l'adresse IP (en cas d'absence d'authentification)  |
| `country`      | Code ISO du pays                                        |
| `region`       | Nom de la région ou de la ville                                     |
| `userAgent`    | En-tête HTTP User-Agent                                  |

Comme cela nécessite la mise en place d'un pipeline d'exportation de données personnalisé de notre côté (index Elastic personnalisé, etc.), cette fonctionnalité n'est disponible qu'en tant qu'option supplémentaire pour Enterprise Plus.