퍼블리셔 분석

퍼블리셔 분석 (Publisher Analytics)

조직이 게시한 모든 모델·데이터셋의 총 다운로드를 보여주는 상세 다운로드 개요 대시보드로 모든 리포지토리 활동을 추적할 수 있어요. Team & Enterprise 플랜 전용 기능입니다.

출처: 문서

본문

[!WARNING] 이 기능은 Team & Enterprise 플랜에 포함됩니다.

Publisher Analytics 대시보드 (Publisher Analytics Dashboard)

조직이 게시한 모든 모델·데이터셋의 총 다운로드를 보여주는 상세 다운로드 개요로 모든 리포지토리 활동을 추적하세요. "All Time"과 "Last Month" 보기를 전환해 서로 다른 기간에 걸쳐 리포지토리를 분석할 수 있어요.

리포지토리별 세부 분석 (Per-repo breakdown)

리포지토리별 드릴다운 테이블로 개별 리포지토리의 메트릭을 살펴보세요. 내장 검색 기능으로 특정 리포지토리를 빠르게 찾을 수 있어요. 각 행에는 시간 경과에 따른 다운로드 추이를 보여주는 시계열 그래프도 있습니다.

Publisher Analytics를 CSV로 내보내기 (Export Publisher Analytics as CSV)

모든 리포지토리의 분석(모델·데이터셋 다운로드 활동 포함)이 담긴 종합 CSV 파일을 다운로드하세요.

다음 API 엔드포인트로 이 데이터에 프로그래밍 방식으로 접근할 수도 있어요:

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

응답 구조 (Response Structure)

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

리포지토리 객체 구조 (Repository Object Structure)

CSV의 각 레코드는 다음을 포함합니다:

• repoType: 리포지토리 타입(예: "model", "dataset")
• repoName: 조직을 포함한 전체 리포지토리 이름(예: "huggingface/documentation-images")
• total: 이 리포지토리의 누적 다운로드 수
• timestamp: ISO 8601 형식 날짜(UTC)
• downloads: 해당 일의 다운로드 수

레코드는 시간순으로 정렬되며 각 리포지토리의 일별 다운로드 활동을 세밀하게 보여줍니다.

[!NOTE] 다운로드 수치는 사용자별 중복 제거되지 않습니다. 고유 다운로드 수가 필요하면 다음 섹션을 참고하세요.

고유 다운로더와 더 세밀한 로그 (Unique downloaders and more granular logs)

[!WARNING] 이 기능은 Enterprise Plus 플랜의 애드온(add-on)입니다.

고급 기능으로, Hugging Face는 조직이 게시한 모든 모델·데이터셋에 대한 익명화된 요청 수준 접근 로그를 내보낼 수 있어요. 각 줄은 단일 다운로드 관련 요청을 나타내며, 모델·데이터셋의 다운로드 데이터를 완전히 세밀하게 제공합니다.

이 로그를 수집하고 계산을 실행하는 것은 팀의 책임입니다. 내보내기는 의도적으로 원시 HTTP 상태 코드와 메서드를 포함해서 HEAD, 부분 콘텐츠, 리다이렉트 등의 요청 패턴을 자체 분석 요구에 맞게 분류할 수 있게 합니다.

커스텀 데이터 내보내기 파이프라인(커스텀 Elastic index 등)을 저희 쪽에 구축해야 하므로, 이 기능은 Enterprise Plus 애드온으로만 제공됩니다.

더 알아보기 (Learn more)

Team & Enterprise 플랜에서 Publisher Analytics 대시보드로 조직 모델·데이터셋 다운로드를 추적하고, download-breakdown API로 CSV를 받아 자체 분석에 활용할 수 있어요. 요청 단위의 세밀한 로그(고유 다운로더 포함)는 Enterprise Plus 애드온입니다. 다운로드 통계와 조직 기능 문서를 함께 참고하세요.