# 发布者分析

> [!WARNING]
> 此功能包含在 Team & Enterprise 套餐中。

## 发布者分析仪表板

通过详细的下载概览跟踪您仓库的所有活动，该概览会显示您组织发布的所有 Models 和 Datasets 的总下载量。在“全部时间”和“上个月”视图之间切换，以获取不同时间段内各仓库的洞察信息。

### 按仓库细分

使用按仓库细分的表格来探索各个仓库的指标。利用内置的搜索功能快速定位特定仓库。每一行还包含一个时间序列图表，展示下载量随时间的变化趋势。

## 将发布者分析导出为 CSV

下载一个包含所有仓库分析数据的综合 CSV 文件，其中包括模型和数据集的下载活动。

你还可以通过以下 API 端点以编程方式访问此数据：

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

### 响应结构

CSV 文件由您每个模型和数据集的每日下载记录组成。

```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
```

### 仓库对象结构

CSV 中的每条记录包含：

- `repoType`：仓库类型（例如 "model"、"dataset"）
- `repoName`：包含组织的完整仓库名称（例如，"huggingface/documentation-images"）
- `total`：该仓库的累计下载次数
- `timestamp`：ISO 8601 格式的日期（UTC）
- `downloads`：当天的下载次数

记录按时间顺序排列，提供每个仓库下载活动的每日粒度视图。

> [!NOTE]
> 下载量数据**未**按用户去重。如需获取唯一的下载次数，请参阅下一节。

## 高级发布者分析：独立下载者及更细粒度的日志

> [!WARNING]
> 此功能是 Enterprise Plus 套餐的附加项。

作为一项高级功能，Hugging Face 可以导出您组织发布的所有模型和数据集的匿名化请求级访问日志。每一行代表一个与下载相关的请求，使您可以完全掌握模型和数据集的下载数据粒度。

您的团队负责摄取这些日志并对其进行计算。导出内容有意包含原始的 HTTP 状态码和方法，以便您根据自身的分析需求对 `HEAD`、部分内容、重定向及其他请求模式进行分类。

| 列         | 描述                                             |
| -------------- | ------------------------------------------------------- |
| `timestamp`    | 请求时间戳                                       |
| `status`       | HTTP 状态码（例如 `200`、`206`、`302`、`307`、`304`） |
| `method`       | HTTP 方法（例如 `GET`、`HEAD`）                 |
| `repoName`     | 完整的仓库名称（例如 `nvidia/segformer-b0`）             |
| `repoType`     | 仓库类型：`model`、`dataset` 或 `space`         |
| `hashedUserId` | 用户 ID 的不可逆哈希值（如果已认证）       |
| `hashedIp`     | IP 地址的不可逆哈希值（如果未通过身份验证）  |
| `country`      | 国家 ISO 代码                                        |
| `region`       | 区域或城市名称                                     |
| `userAgent`    | HTTP User-Agent 请求头                                  |
| `path`         | 仓库或存储桶内的文件路径，从请求 URL 中解析得出（对于不匹配文件路由的请求，该值可能为空） |

由于需要我们在内部搭建自定义数据导出管道（例如自定义 Elastic 索引等），此功能仅作为 Enterprise Plus 的附加组件提供。

