حساب متوسط تقييم المنتج المرجح من أعداد النجوم
حوّلوا توزيع المراجعات ذي الخمس نجوم إلى أهم رقمين للمشترين وفرق التجارة الإلكترونية: متوسط التقييم المرجح والعدد الإجمالي للمراجعات.
شغّل الأداة مجانًا
أدخلوا العدد المسجل عند كل مستوى من نجمة واحدة إلى خمس نجوم. تضرب الحاسبة كل عدد في قيمة نجومه، ثم تجمع الدرجات المرجحة وتقسمها على إجمالي المراجعات الكامل. كما تجمع جميع الفئات لإظهار العدد الدقيق للمراجعات الممثلة. الحساب حتمي ولا يحتاج إلى معرّف منتج، ويرفض التوزيع الفارغ بدل عرض تقييم صفري مضلل.
أدخلوا توزيع التقييم الكامل
ابدؤوا بالأعداد الخمسة التي يوفرها متجركم أو ملف التصدير من السوق الإلكترونية أو مزود المراجعات أو قاعدة بيانات التقارير. ضعوا عدد مراجعات النجمة الواحدة في الحقل الأول، ثم افعلوا الأمر نفسه لمراجعات النجمتين والثلاث والأربع والخمس. يجب أن تكون الأعداد أعداداً صحيحة لا تقل عن صفر، لأنها تمثل مراجعات فعلية وليست نسباً مئوية أو درجة محسوبة مسبقاً. أدخلوا صفراً للفئة التي لا تضم مراجعات ولا تحذفوها. يصلح الحساب لمنتج جديد لديه مراجعة واحدة ولمنتج راسخ لديه ملايين المراجعات، ما دام كل عدد ضمن نطاق العدد الصحيح الآمن. استخدموا بيانات تخص المنتج نفسه ونطاق المتغيرات نفسه والقناة نفسها ولحظة التقرير نفسها. إن خلط العدد التاريخي لمراجعات الخمس نجوم بعدد شهري لمراجعات النجمة الواحدة ينتج رقماً صحيحاً من الناحية الحسابية، لكنه لا يصف أي مجتمع حقيقي. إذا كان المصدر يوفر نسباً فقط، فاحصلوا على الأعداد الأصلية متى أمكن، لأن النسب المقربة قد لا تعيد بناء الإجمالي الحقيقي. بعد تجهيز القيم الخمس المتوافقة، أرسلوها معاً بوصفها توزيعاً واحداً.
افهموا طريقة الحساب المرجح
إن أخذ متوسط بسيط لأعداد الفئات الخمس يجيب عن سؤال مختلف. تمنح الحاسبة كل فئة وزنها بحسب عدد النجوم: تضيف كل مراجعة بنجمة واحدة نقطة، وتضيف كل مراجعة بنجمتين نقطتين، ويستمر ذلك حتى خمس نقاط لكل مراجعة بخمس نجوم. تجمع الحاسبة هذه المساهمات للحصول على الدرجة المرجحة، ثم تقسمها على إجمالي المراجعات في الفئات الخمس. فعلى سبيل المثال، تؤثر عشر مراجعات بخمس نجوم في النتيجة خمسة أضعاف تأثير عشر مراجعات بنجمة واحدة، لأنها تضيف خمسين نقطة بدلاً من عشر. يُقرّب المتوسط الناتج إلى ست منازل عشرية كحد أقصى، فيظل الناتج ثابتاً ويحافظ على دقة أكبر من العرض المعتاد في واجهة المتجر. يُعاد إجمالي المراجعات بصورة مستقلة ولا يُستنتج أبداً من المتوسط. إذا كانت الأعداد الخمسة كلها صفراً، فلا يوجد مجتمع مراجعات ولا يكون المتوسط المرجح معرفاً. عندئذ تبلغ القدرة عن إدخال غير صالح بدلاً من اختراع تقييم صفري قد يُفهم خطأً على أنه يعبر عن رأي حقيقي للعملاء.
استخدموا النتيجة بصورة متسقة
يناسب متوسط التقييم فحوص جودة الكتالوج ولوحات المتابعة الداخلية وإثراء خلاصات المنتجات ومطابقة بيانات الأسواق الإلكترونية وقواعد العرض. قرروا بصورة مستقلة كيفية إظهاره في متجركم: يمكن عرض منزلة عشرية واحدة أو منزلتين أو تعبئة النجوم بيانياً، مع الاحتفاظ بالقيمة الأدق للمقارنات. احتفظوا دائماً بإجمالي المراجعات بجوار المتوسط، لأن الثقة والمعنى التجاري يختلفان كثيراً بين تقييم يستند إلى مراجعتين والتقييم نفسه إذا استند إلى عشرين ألف مراجعة. عند مقارنة القنوات، احسبوا كل قناة أولاً من فئاتها الخمس الخاصة. وللحصول على تقييم شامل، اجمعوا أعداد الفئات المتناظرة أولاً ثم شغّلوا التوزيع الموحد؛ فحساب متوسط متوسطات القنوات مباشرة قد يمنح قناة قليلة المراجعات وزناً زائداً. في مسارات العمل المؤتمتة، احفظوا وقت المصدر ومفتاح المنتج مع النتيجة، حتى وإن لم يكونا من مدخلات هذا الحساب. الاستخدام في المتصفح مجاني، وتبلغ تكلفة طلب API واحد $0.002. تستخدم الطريقتان الحساب الحتمي نفسه، لذلك تعطي الأعداد نفسها النتائج نفسها دائماً.
حالات الاستخدام
إنشاء ملخص لواجهة المتجر
حوّلوا فئات التقييم الخمس المحفوظة للمنتج إلى المتوسط وإجمالي المراجعات المعروضين بجوار اسمه.
تدقيق تقارير الأسواق الإلكترونية
أعيدوا حساب تقييم معلن من أعداد النجوم المصدرة واكتشفوا الملخصات التي لا تطابق توزيعها.
دمج قنوات المراجعات
اجمعوا فئات النجوم المتناظرة من عدة قنوات، ثم احسبوا تقييماً مرجحاً بصورة صحيحة للمجتمع الموحد.
الأسئلة الشائعة
ما تكلفة الحساب؟
يمكنكم تشغيله مجاناً في المتصفح على هذه الصفحة. تبلغ تكلفة كل طلب API مقدار $0.002.
لماذا لا يمكن إدخال خمسة أعداد تساوي صفراً؟
لا يوجد متوسط معرف لمجتمع يخلو من المراجعات. إن إعادة الصفر توحي خطأً بأن العملاء منحوا المنتج تقييماً قدره صفر نجمة.
هل يجوز أن يكون عدد النجوم كسرياً؟
لا. تمثل الأعداد مراجعات منفردة، ولذلك يجب أن تكون أعداداً صحيحة غير سالبة.
كيف يُقرّب المتوسط؟
تُقرّب النتيجة إلى ست منازل عشرية كحد أقصى للحفاظ على الدقة والثبات. ويمكن لمتجركم تطبيق تقريب مختلف عند العرض.
كيف ندمج تقييمات عدة متاجر؟
اجمعوا أعداد النجمة الواحدة معاً، ثم أعداد النجمتين، وهكذا. احسبوا التقييم من الفئات الخمس المدمجة بدلاً من حساب متوسط تقييمات المتاجر.
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/ecom/review-rating-average \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"one_star_count":4,"two_star_count":6,"three_star_count":10,"four_star_count":30,"five_star_count":50}'const res = await fetch("https://api.kit.forhosting.com/ecom/review-rating-average", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"one_star_count": 4,
"two_star_count": 6,
"three_star_count": 10,
"four_star_count": 30,
"five_star_count": 50
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/ecom/review-rating-average",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"one_star_count": 4,
"two_star_count": 6,
"three_star_count": 10,
"four_star_count": 30,
"five_star_count": 50
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/ecom/review-rating-average", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"one_star_count":4,"two_star_count":6,"three_star_count":10,"four_star_count":30,"five_star_count":50}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"one_star_count":4,"two_star_count":6,"three_star_count":10,"four_star_count":30,"five_star_count":50}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/ecom/review-rating-average", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"one_star_count": 4,
"two_star_count": 6,
"three_star_count": 10,
"four_star_count": 30,
"five_star_count": 50
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "ecom.review_rating_average",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |