> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwacks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# تعريفات المقاييس

> كيف تحسب Flock كل رقم في لوحاتك، بالتحديد.

قلّما تتفق أداتا تحليلات على رقم واحد، لأن كل أداة ترسم حدّها الخاص لمعنى "نشط" و"محتفَظ به"
و"دافع". هذه الصفحة تبيّن أين ترسم Flock تلك الحدود، كي تستطيع مقارنة أي رقم في لوحتك بأي أداة
أخرى على أساس واحد. مرّر المؤشر فوق أي رقم في لوحة التحكم لترى الصيغة المختصرة، وهنا الصيغة
الكاملة.

> [!NOTE]
>
> **النطاق:** يُحسب كل مقياس لكل **لعبة**.

ثلاث قواعد يقوم عليها كل ما يلي.

| | |
| - | - |
| **الأيام بتوقيت UTC** | يمتد اليوم من 00:00 إلى 24:00 بتوقيت UTC، أينما كان لاعبوك. |
| **النطاق يشمل يومَي طرفيه** | إذا بلغ النطاق اليوم الحالي، فأرقام اليوم هي ما جرى منه حتى الآن. |
| **اللاعب النشط** | لاعب بدأت له جلسة في ذلك اليوم، أو كان له أي نشاط وهو مسجّل الدخول في ذلك اليوم: تسجيل دخول، أو استدعاء برمز اللاعب، أو بدء جلسة، أو حدث متتبَّع. اللعبة التي لا تبلّغ عن الجلسات يبقى لها لاعبون نشطون. |

## التفاعل

تُقرأ في **Dashboards → User Engagement**.

| المقياس | كيف يُحسب |
| - | - |
| **DAU** | اللاعبون النشطون المختلفون في يوم واحد بتوقيت UTC. تعرض البطاقة آخر يوم في النطاق. |
| **WAU** | اللاعبون النشطون المختلفون في أسبوع يمتد من الاثنين إلى الأحد. الأسبوع الذي يقطعه النطاق تُحسب منه أيامه الواقعة داخل النطاق فقط. |
| **MAU** | اللاعبون النشطون المختلفون في شهر تقويمي، وتُحسب كذلك الأيام الواقعة داخل النطاق فقط. |
| **نسبة DAU/MAU** | قيمة DAU لكل يوم مقسومة على MAU لشهر ذلك اليوم، كنسبة مئوية. تعرض البطاقة المتوسط على النطاق. |
| **اللاعبون الجدد** | اللاعبون الذين أُنشئ حسابهم في Flock في ذلك اليوم. ليس في Flock حدث تثبيت: اللاعب الجديد حساب جديد. |
| **اللاعبون العائدون** | لاعبون أُنشئوا قبل النطاق وكانوا نشطين داخله. |
| **أبرز الأحداث** | أحداث اللعب مرتّبة بعدد اللاعبين المختلفين الذين أرسلوها في النطاق. |

## الجلسات

تُقرأ في **Dashboards → User Engagement**. متى تبدأ الجلسة وتتوقف مؤقتًا وتنتهي مشروح في
[التحليلات والأحداث](https://docs.qwacks.com/ar/guides/analytics-and-events.md#sessions). تُنسب الجلسة إلى اليوم الذي
بدأت فيه.

| المقياس | كيف يُحسب |
| - | - |
| **الجلسات لكل لاعب نشط** | جلسات اليوم مقسومة على DAU لذلك اليوم. |
| **مدة الجلسة** | متوسط طول الجلسات التي بدأت في ذلك اليوم وانتهت. الجلسة التي لم تُنهَ لا تدخل في الحساب. |
| **الأحداث لكل جلسة** | الأحداث المتتبَّعة في اليوم مقسومة على جلسات اليوم. الأحداث التي ترسلها الـSDK من تلقاء نفسها تُحسب أيضًا. |
| **الشاشات لكل جلسة** | متوسط عدد مشاهدات الشاشات المبلَّغ عنها لكل جلسة. |
| **معدل الارتداد** | نسبة جلسات اليوم التي وسمتها الـSDK بأنها ارتداد عند انتهائها: أقصر من حدّ الارتداد، وهو عشر ثوانٍ ما لم تغيّره. |

## الاحتفاظ

تُقرأ في **Dashboards → User Retention**.

يتتبّع الاحتفاظ اللاعبين الذين **لعبوا لأول مرة** داخل النطاق. **اليوم 0** للاعب هو أول يوم
نشط له، واللاعبون الذين يشتركون في اليوم 0 نفسه، أو في أسبوع منه، يشكّلون **مجموعة**.

| المقياس | كيف يُحسب |
| - | - |
| **الاحتفاظ اليوم 1 واليوم 7 واليوم 30** | نسبة المجموعة النشطة في ذلك اليوم بالتحديد بعد اليوم 0. هذا هو التعريف الكلاسيكي، وهو الرقم الرئيسي في البطاقات. |
| **عادوا حتى اليوم N** | نسبة المجموعة التي عادت في أي يوم من اليوم 1 إلى اليوم N. لا تقلّ أبدًا عن الرقم الكلاسيكي. |
| **اللاعبون الجدد** | في هذه الصفحة، اللاعبون الذين وقع أول يوم نشط لهم داخل النطاق. |
| **سجّلوا ولم يلعبوا** | لاعبون أُنشئوا في النطاق بلا أي نشاط إطلاقًا. لا ينتمون إلى أي مجموعة ولا يدخلون في أي رقم احتفاظ. |
| **معدل التوقف** | لكل يوم، نسبة اللاعبين النشطين في الأيام السبعة السابقة له الذين لم يكونوا نشطين فيه. تعرض البطاقة المتوسط على النطاق. |

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

فلترا **المنصة** و**الإصدار** يحسبان الجلسات المطابقة لهما فقط، لأن النشاط مع تسجيل الدخول لا
يحمل أيًّا منهما. يمكن أن يغطي النطاق 180 يومًا على الأكثر.

## تحقيق الدخل

تُقرأ في **Dashboards → User Monetization**، بعملة واحدة في كل مرة. لا تُحوَّل المبالغ بين
العملات أبدًا.

الإيرادات هي كل عملية شراء **مكتملة**، بالمبلغ والعملة اللذين **حُصِّلا** من اللاعب فعلًا.
تُحسب المشتريات التي أكّدها متجر Flock بنفسه والمشتريات التي تبلّغ عنها لعبتك لمبيعات سُوّيت في
مكان آخر، وتعرضهما الصفحة منفصلتين: **مؤكدة من الخادم** و**مبلّغ عنها من اللعبة**.
**المشتريات التجريبية** لا تدخل في الحساب: إيصالات بيئة الاختبار، ومفاتيح الاختبار، ومختبِرو
التراخيص. و**الاسترداد** مبلغ سالب في اليوم الذي وقع فيه، فيُنقص ذلك اليوم ويترك يوم البيع كما
كان.

| المقياس | كيف يُحسب |
| - | - |
| **إجمالي الإيرادات** | مجموع تلك المبالغ بالعملة المختارة على النطاق، شاملًا المبالغ المستردة. |
| **المشتريات والمبالغ المستردة** | عدد المبيعات وعدد الاستردادات في النطاق. |
| **الدافعون** | اللاعبون المختلفون الذين لهم عملية بيع واحدة على الأقل في النطاق. الاسترداد لا يجعل اللاعب دافعًا. |
| **ARPU** | الإيرادات مقسومة على اللاعبين النشطين في النطاق. |
| **ARPPU** | الإيرادات مقسومة على الدافعين. |
| **القيمة الدائمة (LTV)** | كل ما دفعه حتى الآن اللاعبون الذين انضموا في النطاق، مقسومًا على عدد المنضمين. يستمر في الارتفاع بعد انتهاء النطاق. |
| **القيمة الدائمة حسب المجموعة** | الإيرادات لكل لاعب، تراكميًا بحسب اليوم منذ أول لعب، للاعبين الذين لعبوا لأول مرة في كل أسبوع. يُحسب كل عضو، دافعًا كان أم لا، ولا يظهر اليوم إلا بعد أن ينقضي كاملًا. |
| **تحوّل اللاعبين إلى دافعين** | الدافعون مقسومين على اللاعبين النشطين في النطاق. |
| **معدل تكرار الشراء** | نسبة الدافعين الذين لهم عملية بيع ثانية في أي وقت حتى نهاية النطاق. |
| **الوقت حتى أول شراء** | للاعبين الذين وقعت أول عملية بيع لهم بالعملة المختارة داخل النطاق، الوقت من أول نشاط لهم إلى تلك العملية. تعرض البطاقة الوسيط، وبجانبه المتوسط. |
| **أكبر المنفقين** | اللاعبون مرتّبين بما دفعوه في النطاق، بعد طرح المبالغ المستردة. |

الرسوم اليومية تتبع القواعد نفسها لكل يوم: قيمة ARPU ليوم تُقسم على اللاعبين النشطين في ذلك
اليوم، وتحويل اليوم هو نسبة من دفع منهم. وبطاقة **معدل التحويل** في **Dashboards → Home** هي
متوسط تلك النسب اليومية على النطاق، عبر كل العملات.

## مسارات التحويل

تُقرأ في **Dashboards → Funnels**.

**يدخل** اللاعب المسار عند أول حدث له في النطاق يطابق الخطوة الأولى. في الترتيب الافتراضي،
تُحسب كل خطوة لاحقة حين يصل حدثها بعد الخطوة السابقة وضمن النافذة الزمنية للمسار من لحظة
الدخول، وهي يوم واحد ما لم تغيّرها، ويجوز أن تتخللها أحداث أخرى. وفي الترتيب **الصارم** يجب أن
يكون الحدث هو الحدث المتتبَّع التالي مباشرة للاعب، والأحداث التي ترسلها الـSDK من تلقاء نفسها
تُتجاوز. تحويل الخطوة هو نسبة اللاعبين الذين دخلوا المسار وبلغوها.

## ما الذي تغيّر هذا الأسبوع

يُقرأ في أعلى **Dashboards → Home**.

تبدأ الصفحة الرئيسية بسطور قليلة تذكر ما تحرّك: آخر سبعة أيام كاملة بتوقيت UTC مقارنةً بالأيام
السبعة التي قبلها. اليوم الحالي لا يدخل في أي من الأسبوعين، لأنه لم ينتهِ بعد.

| السطر | كيف يُحسب |
| - | - |
| **اللاعبون النشطون** | اللاعبون النشطون المختلفون على مدى الأيام السبعة. |
| **اللاعبون الجدد** | حسابات اللاعبين التي أُنشئت في الأيام السبعة. |
| **الاحتفاظ اليوم 1 واليوم 7** | من اللاعبين الذين وقع يومهم 1 (أو يومهم 7) داخل الأسبوع، نسبة من كانوا نشطين فيه. يُقاس الأسبوعان بالطريقة نفسها، ولهذا قد تختلف هذه الأرقام عن صفحة الاحتفاظ: تلك الصفحة تجمّع اللاعبين حسب اليوم الذي لعبوا فيه لأول مرة. |
| **الإيرادات** | المشتريات المكتملة خلال الأسبوع بعملة واحدة، بالمبلغ المحصَّل فعلًا، مع طرح المبالغ المستردة. لكل عملة من أكبر ثلاث عملات سطر. |
| **حالات الخروج غير الطبيعي** | مرات تشغيل اللعبة التي لم تنتهِ بشكل سليم، وتبلّغ عنها الـSDK عند التشغيل التالي، لكل 100 جلسة بدأت في الأسبوع. التشغيل الذي انتهى واللعبة في الخلفية لا يُحسب. |
| **الخطأ الأكثر تكرارًا** | الخطأ الأكثر تسجيلًا في الأسبوع بين الاستثناءات والأخطاء المنطقية التي تحمل رمزًا، ويُعدّ لكل نوع سجل ورمز معًا، مع عدد الزوج نفسه في الأسبوع السابق. |

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

## لماذا قد يختلف الرقم عن أداة أخرى

| | |
| - | - |
| **حدود اليوم** | تقطع Flock الأيام عند منتصف الليل بتوقيت UTC. الأداة التي تعمل بتوقيتك المحلي تضع المساء نفسه تحت تاريخ آخر. |
| **معنى "نشط"** | تحسب Flock النشاط مع تسجيل الدخول إضافة إلى الجلسات، فقد يكون DAU فيها أعلى من أداة تحسب الجلسات وحدها. |
| **اليوم الحالي غير مكتمل** | النطاق الذي يبلغ اليوم الحالي يعرض ما جرى منه حتى الآن، فتبدو آخر نقطة في الرسم اليومي منخفضة وآخر نقطة في معدل التوقف مرتفعة. الاحتفاظ والقيمة الدائمة حسب المجموعة يستثنيان اليوم الحالي. |
| **البيانات المتأخرة** | تحتفظ الـSDK بالأحداث ونهايات الجلسات على الجهاز ما دام بلا اتصال، وترسلها بوقتها الأصلي عند الاتصال التالي، فقد ترتفع أرقام الأيام القليلة الأخيرة لاحقًا. |
| **طول الجلسة يحتاج إلى نهاية** | تُحسب المدة للجلسات التي أنهتها اللعبة فقط، والوقت الذي تقضيه اللعبة في الخلفية ليس وقت لعب. |
| **الاحتفاظ ينتظر** | قد تعرض أداة أخرى رقم اليوم 7 للاعبين بدؤوا قبل ثلاثة أيام. Flock تتركه فارغًا حتى ينقضي اليوم 7 لهم جميعًا. |
| **دافعون لم يكونوا نشطين قط** | قد تبلّغ اللعبة عن عملية شراء للاعب لم ترَ Flock له أي نشاط. ذلك اللاعب دافع وليس لاعبًا نشطًا، فقد يتجاوز تحويل اليوم 100%. |
| **الفوترة تحسب بطريقة مختلفة** | المستخدمون النشطون شهريًا في تبويب [الاستخدام](https://docs.qwacks.com/ar/qwacks/billing-usage.md) لاستوديوك يُحسبون من الجلسات، عبر كل ألعاب الاستوديو. وفي صفحة الخطط، **مدة حفظ التحليلات** هي المدة التي تُحفظ فيها البيانات، ولا علاقة لها بالاحتفاظ باللاعبين. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.