ForHosting KIT · أدوات المطورين

حساب معدل الاستجابة للاستبيان من المرسل والمكتمل

يوضح معدل الاستجابة نسبة الأشخاص الذين أكملوا الاستبيان من بين جميع من جرى التواصل معهم.

● Betaمجاني · داخل متصفحك

استخدمها من الويبAPIالبريدTelegramالتطبيق قريبًا

أدخلوا العدد الإجمالي للاستبيانات المرسلة وعدد الاستبيانات المكتملة لتحصلوا على النسبة المئوية فوراً. تطبق الحاسبة الصيغة القياسية بقسمة المكتمل على المرسل، وتتحقق من صلاحية الأعداد، ثم تعيد نتيجة ثابتة تناسب التقارير ولوحات المعلومات ومراجعات الحملات ومسارات البحث المؤتمتة. كما ترفض أن يكون عدد الاستبيانات المرسلة صفراً، إذ لا يمكن تعريف معدل ذي معنى من دون دعوات.

ابدؤوا بعددين ينتميان إلى حملة واحدة

يتطلب معدل الاستجابة المفيد عددين مأخوذين من الحملة نفسها وفترة التوزيع نفسها والجمهور نفسه. ينبغي أن يمثل عدد الاستبيانات المرسلة الدعوات التي تدخل في مقام التقرير، بينما ينبغي أن يقتصر عدد الاستبيانات المكتملة على الردود النهائية المرتبطة بتلك الدعوات. قبل الحساب، حددوا سياسة فريقكم بشأن الرسائل المرتدة والدعوات المكررة والإجابات التجريبية والردود الجزئية والاستبيانات التي أعيد فتحها. تكتسب هذه السياسة أهمية لأن تغيير البسط أو المقام يغير النتيجة حتى عندما تكون العملية الحسابية صحيحة تماماً. أدخلوا أعداداً صحيحة غير سالبة، لا تقديرات أو نصوصاً منسقة. ولا يجوز أن يزيد عدد المكتمل على عدد المرسل. إذا أردتم مقارنة عدة موجات بحثية، فاحسبوا كل موجة على حدة أولاً. بهذه الطريقة تظل الفروق في التوقيت والقناة والجمهور وتصميم الأسئلة ظاهرة، ولا تختفي داخل متوسط قد يحجب ضعف حملة معينة. وسجلوا قواعد العد المختارة بجوار النتيجة حتى يستطيع الزملاء إعادة إنتاجها في وقت لاحق.

افهموا الصيغة والنسبة التي تعيدها الحاسبة

تقسم العملية عدد الاستبيانات المكتملة على عدد الاستبيانات المرسلة، ثم تضرب الناتج في مئة. فعلى سبيل المثال، ينتج عن مئتي استبيان مكتمل من أصل ثمانمئة استبيان مرسل معدل قدره خمسة وعشرون في المئة. تجيب النتيجة عن سؤال محدد: ما نسبة الاستبيانات الموزعة التي انتهت برد مكتمل؟ لكنها لا تقيس مدى تمثيل العينة، ولا جودة التفكير في الإجابات، ولا وصول الأسئلة إلى الفئة المستهدفة. تقرب الحاسبة النسبة النهائية فقط إلى ست خانات عشرية، فتحافظ على تفاصيل مفيدة للحملات الصغيرة والمقارنات اللاحقة وتضمن استقرار مخرجات JSON. يؤدي إدخال صفر في خانة المرسل إلى خطأ، لأن القسمة على صفر لا تصف مشاركة. أما إدخال صفر للمكتمل مع عدد موجب للمرسل فهو صحيح وينتج صفراً في المئة. عند عرض النتيجة، اختاروا دقة تناسب جمهوركم واحتفظوا بالعددين الأصليين إلى جوارها؛ فالنسبة نفسها المبنية على عشر دعوات ليست بقوة الدليل المبني على عشرة آلاف دعوة.

استخدموا المعدل للتشخيص لا للحكم على الجودة

يصبح معدل الاستجابة أكثر فائدة عندما تقارنونه بصورة متسقة بين موجات الاستبيان أو قنوات الدعوة أو رسائل التذكير أو شرائح الجمهور. قد يدعو انخفاضه إلى مراجعة عنوان الرسالة وطول الاستبيان وسهولة استخدامه على الهاتف والحوافز وتوقيت التواصل وجودة قائمة العناوين. وقد يشير ارتفاعه إلى نجاح التغييرات، لكن ينبغي تفسيره أيضاً بالاقتران مع جودة الإجابات وتركيبة العينة. لا تقارنوا معدلات أعدت بقواعد عد مختلفة من دون توضيح الفرق. فقد يستبعد فريق الدعوات غير القابلة للتسليم، بينما يبقيها فريق آخر ضمن عدد المرسل، وبذلك يستخدمان مقامين غير متساويين. في التقارير التشغيلية، احفظوا قيمتي الإدخال والنسبة المحسوبة معاً، وسجلوا فترة التقرير وقواعد الإدراج في نظامكم. تستطيع الأتمتة استدعاء هذه القدرة مقابل $0.002 لكل طلب. ولا يعتمد الحساب على الشبكة أو العشوائية أو الوقت الحالي، لذلك تعطي المدخلات المتطابقة مخرجات متطابقة دائماً، وهو ما يلائم لوحات المتابعة وفحوص الجودة وملخصات التجارب وسجلات البحث القابلة لإعادة الإنتاج.

حالات الاستخدام

مراجعة حملة تواصل

احسبوا نسبة الاستبيانات الموزعة التي تحولت إلى ردود مكتملة بعد انتهاء الحملة.

مقارنة موجات الاستبيان

طبقوا الصيغة نفسها على كل موجة لمقارنة تغير المشاركة وفق معيار ثابت.

تغذية لوحة معلومات بحثية

أنشئوا حقلاً موثوقاً لمعدل الاستجابة من أعداد المرسل والمكتمل المخزنة ضمن مسار تقارير مؤتمت.

الأسئلة الشائعة

كيف يحسب معدل الاستجابة للاستبيان؟

اقسموا عدد الاستبيانات المكتملة على عدد الاستبيانات المرسلة، ثم اضربوا الناتج في مئة لإظهاره كنسبة مئوية.

ماذا يحدث إذا كان عدد المرسل صفراً؟

يعيد الحساب خطأ يفيد بعدم صلاحية الإدخال، لأن المعدل لا يمكن تعريفه عندما يكون المقام صفراً.

هل يمكن أن يزيد المكتمل على المرسل؟

لا. ترفض الحاسبة هذا الإدخال لأن كل استبيان مكتمل يجب أن يقابل استبياناً مدرجاً ضمن العدد المرسل.

هل تدخل الردود الجزئية ضمن المكتمل؟

أدخلوها فقط إذا كانت سياسة التقارير لديكم تصنفها مكتملة. حددوا السياسة قبل إدخال العدد وطبقوها باستمرار.

ما تكلفة الحساب المؤتمت؟

تبلغ تكلفة كل طلب API مقدار $0.002. ويمكن استخدام الصيغة الحتمية نفسها في التقارير الدورية.

للمطوّرين — الوصول عبر API

كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.

الـEndpoint

POSThttps://api.kit.forhosting.com/biz/survey-response-rate-calc

صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.

استدعِ الخدمة من بيئتك

curl -X POST https://api.kit.forhosting.com/biz/survey-response-rate-calc \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"surveys_sent":800,"surveys_completed":236}'

const res = await fetch("https://api.kit.forhosting.com/biz/survey-response-rate-calc", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "surveys_sent": 800,
    "surveys_completed": 236
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/biz/survey-response-rate-calc",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "surveys_sent": 800,
    "surveys_completed": 236
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/biz/survey-response-rate-calc", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"surveys_sent":800,"surveys_completed":236}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"surveys_sent":800,"surveys_completed":236}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/biz/survey-response-rate-calc", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

مثال على الطلب

{
  "surveys_sent": 800,
  "surveys_completed": 236
}

مثال على الاستجابة

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "biz.survey_response_rate_calc",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.

الأسعار

لكل طلب$0.002

السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.

الأخطاء

HTTP	الرمز	المعنى
`401`	`unauthorized`	مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك.
`402`	`insufficient_balance`	رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة.
`404`	`unknown_type`	نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب.
`429`	`rate_limited`	تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة.

اطّلع على توثيق KIT الكامل ←