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

# التقارير

> إنشاء تقارير التحليلات وجدولتها.

تُنشئ **Reports** (`/analytics/reports`) ملفات تحليلات وبيانات مسح قابلة للتنزيل في نقطة زمنية محددة لمجموعة مختارة من رموز QR أو المجلدات أو الوسوم أو الفئات أو المستخدمين، ونطاق تاريخ مختار. وهي النظير لمرة واحدة لـ[تقارير البريد الإلكتروني](/ar/analytics/email-reports)، التي تُسلِّم التقارير وفق جدول متكرر بدلاً من عند الطلب.

<Note>
  لا تظهر Reports في الشريط الجانبي إلا للحسابات التي تملك صلاحية التصدير (خطط Pro وما فوقها).
</Note>

<Frame caption="صفحة Reports دون إنشاء أي تقرير بعد">
  <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/analytics/reports/reports-list.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=736d3088881b3c9aee5414ecdef5fb3a" alt="صفحة Scanova Reports تعرض جدولاً بأعمدة Requested On وGenerated On وRequested By وStatus وAction، وتقريرًا واحدًا في حالة In Progress" width="1440" height="900" data-path="images/v2/analytics/reports/reports-list.png" />
</Frame>

## إنشاء تقرير

<Steps>
  <Step title="فتح درج Create Report">
    من **Analytics > Reports**، اختر **Create Report**. سيفتح هذا درجًا تُعِد فيه التقرير.

    <Frame caption="درج Create Report">
      <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/analytics/reports/create-report-drawer.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=10d62ecb01607c915aec50af48493e4a" alt="درج Scanova Create Report يعرض اختيار الكيان، ومربع اختيار Exclude Bot Traffic، ونطاق تاريخ لفترة زمنية، وأداتَي اختيار صيغة لـ Analytics Report وScan Data Report، ومربع اختيار Save this report" width="1440" height="900" data-path="images/v2/analytics/reports/create-report-drawer.png" />
    </Frame>
  </Step>

  <Step title="تحديد ما يغطيه التقرير">
    ضمن **Select QR Codes, Folders, Tags, Categories or Users**، اختر نوع الكيان من القائمة المنسدلة، ثم اختر العناصر المحددة (أو **Select all**) في **View/Edit Selection**. يمكنك اختياريًا تحديد **Exclude Bot Traffic** لتصفية المسحات غير البشرية.
  </Step>

  <Step title="ضبط الفترة الزمنية">
    اختر **Select Time Period** لفتح أداة اختيار نطاق تاريخ وتحديد تاريخي البداية والنهاية اللذين ينبغي أن يغطيهما التقرير.
  </Step>

  <Step title="اختيار أنواع التقارير والصيغ">
    ضمن **Select Reports and Format**، يمكنك طلب أي من التالي أو كليهما:

    * **Analytics Report** — ملخص مرئي، قابل للتصدير بصيغة **PDF** أو **XLS** أو **XLSX**.
    * **Scan Data Report** — سجلات المسح الأساسية، قابلة للتصدير بصيغة **CSV** أو **XLS** أو **XLSX**.

    لكل منهما قائمة صيغة منسدلة خاصة به، حتى تتمكن من طلب Analytics Report بصيغة PDF وScan Data Report بصيغة CSV في الطلب نفسه.
  </Step>

  <Step title="حفظ الإعداد اختياريًا">
    حدد **Save this report** للاحتفاظ بهذا المزيج من الكيانات والمرشّحات والصيغ حتى تتمكن من إعادة تشغيله لاحقًا دون إعادة إدخال كل شيء — تظهر الإعدادات المحفوظة ضمن **saved reports**، ويمكن الوصول إليها من رابط أعلى الدرج عبر قائمة منسدلة **Select saved reports**.
  </Step>

  <Step title="إنشاء التقرير">
    اختر **Create New Report**. يُغلق الدرج ويظهر صف جديد في جدول Reports بطابع زمني **Requested On** وحالة **Status** تُظهر **In Progress**.
  </Step>
</Steps>

## بعد طلب تقرير

تُتابَع التقارير المطلوبة في جدول بهذه الأعمدة:

* **Requested On** — متى قدّمت الطلب.
* **Generated On** — متى انتهى التقرير من المعالجة (يُعرض كـ `—` أثناء استمرار التوليد).
* **Requested By** — المستخدم الذي طلبه.
* **Status** — مؤشر تقدم، يبدأ بـ **In Progress**.
* **Action** — حيث يمكنك تنزيل الملف المكتمل، أو إلغاء طلب معلَّق.

<Warning>
  أثناء التحقق من هذه الصفحة على حساب اختبار فعلي، ظل تقرير مطلوب (Analytics Report بصيغة PDF + Scan Data Report بصيغة CSV، يغطي جميع رموز QR) في حالة **In Progress** مع استمرار **Generated On** في عرض `—` لعدة دقائق دون اكتمال أو إنتاج رابط تنزيل. قد يكون هذا خاصًا ببيئة الاختبار/التطوير المستخدمة للتحقق بدلاً من سلوك الإنتاج، ولكن إذا رأيت تقريرًا عالقًا في حالة **In Progress** لفترة طويلة، فمن الجدير الإبلاغ عن ذلك للدعم.
</Warning>

## إلى أين تذهب بعد ذلك

* [لوحة تحكم التحليلات](/ar/analytics/dashboard) — اللوحة المباشرة التي تُستمد منها هذه البيانات، مع عمليات تصدير فورية على الشاشة.
* [تقارير البريد الإلكتروني](/ar/analytics/email-reports) — للتقارير التي تُسلَّم تلقائيًا وفق جدول متكرر بدلاً من إنشائها عند الطلب.

## ذات صلة

* [لوحة تحكم التحليلات](/ar/analytics/dashboard) — العرض المباشر وراء كل تقرير يُنشأ هنا.
* [تقارير البريد الإلكتروني](/ar/analytics/email-reports) — النظير المتكرر لهذا التقرير عند الطلب.
* [تنزيل بيانات المستخدمين النهائيين وRSVP](/ar/leads/downloading-data) — آلية تصدير منفصلة، ذات سلوك مختلف، لبيانات العملاء المحتملين والنماذج وRSVP.
