# الإحصائيات والتحليلات

تأتي لوحة DZBuild بالإحصائيات التي يحتاجها معظم التجار — بلا إعداد. للتحليل الأعمق، تستطيع تغذية البيانات إلى Google Analytics أو Looker Studio أو مستودعك عبر API.

## أين توجد الإحصائيات[​](#أين-توجد-الإحصائيات "رابط مباشر إلى أين توجد الإحصائيات")

افتح [`/dashboard`](https://dzbuild.com/dashboard) — الإحصائيات موجودة في **الصفحة الرئيسية** للوحة التحكم، أسفل أزرار النطاق الزمني. لا توجد صفحة `/dashboard/analytics` ولا مدخل "الإحصائيات" في القائمة الجانبية إلا إذا كانت إضافة Advanced Analytics مفعّلة.

العرض الافتراضي هو **آخر 7 أيام**. بعدها تفتح اللوحة على آخر فترة جاهزة اخترتها في ذلك المتصفح (النطاق المخصص لا يُحفَظ). الفترات الجاهزة: اليوم، أمس، 7 أيام، 30 يوماً، هذا الشهر، الشهر الماضي، هذه السنة، إضافة إلى نطاق مخصص حتى 365 يوماً. وبجانب الفترات الجاهزة فلتر للترافيك يحصر أرقام الزوار في كل الزيارات، أو صفحات الهبوط وحدها، أو المتجر وحده؛ أما أرقام الطلبات ومعدل التحويل فتشمل المتجر كله دائماً.

كل مؤشر KPI يعرض شارة نسبة تغيّر تقارن الفترة المختارة بالفترة السابقة لها مباشرة وبنفس طولها.

KPIs العليا:

| المقياس                | التعريف                                                                                                                                                            |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **الإيرادات**          | قيمة البضاعة في الطلبات **المُسلَّمة** فقط: المجموع الفرعي ناقص الخصم، دون الشحن ورسوم الدفع. يُحتسب الطلب في يوم *تسليمه*، لا يوم إنشائه.                         |
| **الربح**              | الإيرادات ناقص تكلفة البضاعة في تلك الطلبات المُسلَّمة (الكمية × سعر تكلفة المنتج). يجب أن تملأ **سعر التكلفة** في منتجاتك — إن كان فارغاً فالربح يساوي الإيرادات. |
| **الطلبات**            | كل طلب أُنشئ خلال الفترة، أياً كانت حالته (بما فيها الملغاة والمرتجعة).                                                                                            |
| **الطلبات المُسلَّمة** | الطلبات التي سُلِّمت داخل الفترة.                                                                                                                                  |
| **الطلبات الملغاة**    | الطلبات المُنشأة في الفترة بحالة `cancelled`.                                                                                                                      |
| **AOV**                | متوسط *إجمالي* الطلب — شاملاً الشحن ورسوم الدفع — عبر الطلبات غير الملغاة وغير المرتجعة.                                                                           |
| **الزوار**             | بصمات الزوار المتمايزة التي زارت المتجر خلال الفترة.                                                                                                               |
| **مشاهدات الصفحات**    | إجمالي عمليات تحميل صفحات المتجر.                                                                                                                                  |
| **العملاء الجدد**      | سجلات العملاء المُنشأة خلال الفترة.                                                                                                                                |
| **معدل التحويل**       | الطلبات ÷ الزوار، معروضاً كنسبة مئوية (باستخدام عدد الطلبات بكل الحالات).                                                                                          |

المؤشرات لا تتطابق حسابياً فيما بينها — وهذا مقصود

تُحسب الإيرادات والطلبات وAOV من ثلاث مجموعات طلبات مختلفة وثلاثة حقول مالية مختلفة. الإيرادات تشمل المُسلَّم فقط وتُنسَب إلى تاريخ *التسليم*؛ الطلبات تحصي كل الحالات وتُنسَب إلى تاريخ *الإنشاء*؛ وAOV يحسب متوسط إجمالي الطلب عبر الطلبات غير الملغاة وغير المرتجعة. لذلك فإن الإيرادات ÷ الطلبات لن تساوي AOV، وAOV × الطلبات لن يساوي الإيرادات.

الرسوم أسفل المؤشرات:

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

جميع الرسوم تحترم منتقي نطاق التواريخ.

### حسابات الفريق لا ترى الأرقام المالية[​](#حسابات-الفريق-لا-ترى-الأرقام-المالية "رابط مباشر إلى حسابات الفريق لا ترى الأرقام المالية")

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

## كيف تُجمَع أرقام الزوار[​](#كيف-تُجمَع-أرقام-الزوار "رابط مباشر إلى كيف تُجمَع أرقام الزوار")

تأتي أعداد الزوار ومشاهدات الصفحات من beacon جافاسكريبت على المتجر. ويسجّل لكل مشاهدة صفحة: بصمة المتصفح ونوع الصفحة ونطاق المُحيل ومصدر الترافيك والجهاز ومعرّف الجلسة.

حدّان يستحقان الانتباه:

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

## إضافة Advanced Analytics (المؤسسات)[​](#إضافة-advanced-analytics-المؤسسات "رابط مباشر إلى إضافة Advanced Analytics (المؤسسات)")

تضيف إضافة **Advanced Analytics** نسخة [Umami](https://umami.is) خاصة يستضيفها DZBuild — بلا كوكيز، ولا تغادر بيانات الزوار DZBuild. متاحة لخطة المؤسسات فقط، وتُدار على `/dashboard/addons/advanced-analytics`.

ما تضيفه فوق الرسوم المدمجة: عدد الزوار اللحظي، تقارير النظرة العامة والجلسات، أفضل الصفحات والمُحيلين، توزيعات الجهاز / المتصفح / نظام التشغيل والدولة، مقارنة الفترات، توزيعات UTM، أحداث مخصصة، مقاييس الأداء — و**تقرير قمع (funnel)** غير موجود في اللوحة المدمجة.

وفي صفحة الإضافة أيضاً زر **عرض كامل** يفتح لوحة Umami الخاصة بك للقراءة فقط: تستطيع تصفّح التقارير المعروضة فيها وفلترتها، لكن لا يمكنك إنشاء تقارير أو تعديلها هناك.

## ربط أدوات خارجية[​](#ربط-أدوات-خارجية "رابط مباشر إلى ربط أدوات خارجية")

### Google Analytics 4[​](#google-analytics-4 "رابط مباشر إلى Google Analytics 4")

ركّبه عبر [البيكسلات](https://dzbuild.com/ar/ar/docs/marketing/pixels.md). يستقبل GA4 نفس أحداث المتجر التي يطلقها DZBuild لـ Facebook (`view_item`، `add_to_cart`، `begin_checkout`، `purchase`)، إضافة إلى `generate_lead` عندما يرسل زائر نموذجاً مخصصاً في صفحة هبوط.

### Google Tag Manager وMixpanel وAmplitude[​](#google-tag-manager-وmixpanel-وamplitude "رابط مباشر إلى Google Tag Manager وMixpanel وAmplitude")

DZBuild **لا** يدفع أحداثاً مسمّاة إلى dataLayer الخاص بـ GTM، لذا فحاوية GTM وحدها لا تمنح GTM ما يبني عليه المشغّلات. لإيصال أحداث التجارة الإلكترونية إلى GTM يجب أن تضيف **أيضاً** بيكسل Google Analytics (أو Google Ads) — عندها يُطلِق المتجر استدعاءات `gtag('event', …)` يستطيع GTM التقاطها كأحداث Google Tag.

أما Mixpanel أو Amplitude، فشغّل وسم Custom HTML في GTM انطلاقاً من أحداث Google Tag تلك، أو من `window.trackPixelEvent`.

### Looker Studio / Power BI / مستودعك[​](#looker-studio--power-bi--مستودعك "رابط مباشر إلى Looker Studio / Power BI / مستودعك")

استخدم [DZBuild API](https://dzbuild.com/ar/ar/api-docs/intro.md) على العنوان `https://api.dzbuild.app/v1`:

* `GET /v1/orders` — تنقّل في الطلبات، فلتر بالتاريخ. و`GET /v1/orders/{id}` لطلب واحد.
* `GET /v1/analytics?range=30d` يعيد أرقام لوحة التحكم: المؤشرات مع نسبة تغيّرها مقارنة بالفترة السابقة، إضافة إلى الطلبات والإيرادات والزوار والأجهزة ومصادر الترافيك وأفضل المنتجات وأفضل الولايات. يقبل `range` الفترات الجاهزة في اللوحة (`today`، `yesterday`، `7d`، `30d`، `this_month`، `last_month`، `this_year`) وقيمته الافتراضية `this_month`؛ و`range=custom&from=YYYY-MM-DD&to=YYYY-MM-DD` يغطي حتى 365 يوماً. تُحذف الإيرادات والربح وAOV ما لم يكن المفتاح تابعاً لمالك المتجر. يحتاج صلاحية `analytics:read`.
* `GET /v1/quotas` يعيد حدود الاستدعاءات الخاصة بمفتاح API، وهي مفيدة لحماية مهمة مجدولة. أما `GET /v1/usage` و`GET /v1/usage/history` فيحصيان استدعاءاتك لـ API، لا مبيعاتك.
* `GET /v1/customers` و`GET /v1/products` و`GET /v1/landing-pages` للربط.

مفاتيح API لخطة Enterprise وحدها

وحده مالك المتجر على خطة **Enterprise** سارية يستطيع إنشاء المفاتيح، من [`/dashboard/api`](https://dzbuild.com/dashboard/api). يرى المالكون الآخرون هناك بطاقة ترقية، ويرى أعضاء الفريق تنبيهاً بأن الصفحة لمالك المتجر وحده. تنشئ المفتاح بنفسك، حتى ثلاثة مفاتيح لكل متجر، ويعمل التوثيق به فوراً.

للبيانات شبه اللحظية، اشترك في webhooks. تنشر الإضافة سبعة مواضيع للطلبات لا غير: `order.created` و`order.confirmed` و`order.processing` و`order.shipped` و`order.delivered` و`order.cancelled` و`order.returned`. راجع [Webhooks](https://dzbuild.com/ar/ar/api-docs/webhooks/overview.md).

## الخصوصية[​](#الخصوصية "رابط مباشر إلى الخصوصية")

DZBuild لا يتتبع العملاء عبر المواقع. البيكسلات في المتصفح (عند تركيبها) تفعل، لكن ذلك بينك وبين مزوّد البيكسل — وCAPI لـ DZBuild يرسل فقط ما تهيّئه في [البيكسلات](https://dzbuild.com/ar/ar/docs/marketing/pixels.md).

DZBuild لا يولّد لك سياسة خصوصية. إن احتجت واحدة، أضفها كصفحة أو صفحة هبوط واربطها بنفسك.

## أسئلة متكررة[​](#أسئلة-متكررة "رابط مباشر إلى أسئلة متكررة")

**س: لماذا يختلف عدد الزوار عندي عن Google Analytics؟** ج: طرق جمع مختلفة. يحصي DZBuild بصمات المتصفح المتمايزة من beacon خاص به ويضع سقفاً للجلسات الثقيلة جداً؛ بينما يحصي GA الجلسات ويطبّق فلترة البوتات الخاصة به.

**س: أين أرى المرتجعات/الإلغاءات؟** ج: فلتر قائمة الطلبات على [`/dashboard/orders`](https://dzbuild.com/dashboard/orders) حسب الحالة، أو استخدم إضافة [إدارة متقدمة للطلبات](https://dzbuild.com/ar/ar/docs/addons/advanced-orders.md). عبر API: `GET /v1/orders?status=returned`.

**س: هل أستطيع تصدير الرسوم؟** ج: لا. لا يوجد اليوم تصدير CSV أو JSON لرسوم اللوحة. لإخراج البيانات الأساسية، استخدم API (`GET /v1/orders`، `GET /v1/analytics`) أو إضافة التصدير إلى Google Sheets.

**س: كم البيانات حية؟** ج: تُخزَّن العدّادات والرسوم مؤقتاً 120 ثانية لكل متجر ونطاق زمني، وإعادة التحميل داخل هذه المدة تعيد الأرقام نفسها. وما دامت الصفحة الرئيسية للوحة مفتوحة، يُضاف الطلب الجديد فوراً إلى عدّاد الطلبات وإلى قائمة آخر الطلبات.