Hub documentation
تحليلات الناشر
تحليلات الناشر
تُعد هذه الميزة جزءًا من خطط الفريق والمؤسسات.
لوحة تحليلات الناشر
تتبّع جميع نشاطات مستودعاتك عبر نظرة عامة مفصّلة على التنزيلات تعرض إجمالي التنزيلات لجميع النماذج (Models) ومجموعات البيانات (Datasets) التي نشرتها مؤسستك. بدّل بين عرضَي «كل الوقت» (All Time) و«الشهر الماضي» (Last Month) للحصول على رؤى حول مستودعاتك عبر فترات زمنية مختلفة.

تفصيل لكل مستودع
استكشف مقاييس المستودعات الفردية من خلال جدول التفصيل لكل مستودع. استخدم ميزة البحث المدمجة للعثور بسرعة على مستودعات محددة. كما يتضمن كل صف رسمًا بيانيًا للسلاسل الزمنية يوضح اتجاه التحميلات بمرور الوقت.
تصدير تحليلات الناشر بصيغة CSV
حمّل ملف CSV شامل يحتوي على تحليلات لجميع مستودعاتك، بما في ذلك نشاط تنزيل النماذج ومجموعات البيانات.
يمكنك أيضًا الوصول إلى هذه البيانات برمجيًا عبر نقطة النهاية التالية للواجهة البرمجية:
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
"https://huggingface.co/organizations/YOUR_ORG_NAME/settings/publisher-analytics/download-breakdown" \
--output breakdown.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: عدد مرات التنزيل في ذلك اليوم
تُرتَّب السجلات ترتيبًا زمنيًا وتوفر عرضًا يوميًا مفصّلًا لنشاط التنزيل لكل مستودع.
أرقام التنزيل غير مُزالة التكرار حسب المستخدم. إذا كنت بحاجة إلى عدد تنزيلات فريد، فراجع القسم التالي.
محمّلات فريدة وسجلات أكثر تفصيلاً
هذه الميزة إضافة لخطة 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 | تجزئة غير قابلة للعكس لمعرّف المستخدم (إذا كان مصادقًا) |
hashedIp | تجزئة غير قابلة للعكس لعنوان IP (في حالة عدم المصادقة) |
country | رمز ISO للبلد |
region | اسم المنطقة أو المدينة |
userAgent | ترويسة HTTP User-Agent |
بما أنه يتطلب إعداد خط أنابيب مخصص لتصدير البيانات من جانبنا (فهرس Elastic مخصص، إلخ)، فهو متاح فقط كإضافة إلى Enterprise Plus.
Update on GitHub