-- cap the number of rows
```
مثال بسيط — إيرادات البيع الإضافي اليومية ومعدل القبول لآخر 30 يومًا:
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
```
الكلمات المفتاحية غير حساسة لحالة الأحرف (`SELECT` و`select` كلاهما يعمل) ولا تنتهي العبارات بفاصلة منقوطة. تُحاط القيم النصية بعلامات اقتباس مزدوجة؛ أما الأرقام والقوائم فلا.
### اختيار ما تقيسه وكيفية تقسيمه
* **`SELECT`** يسرد المقاييس المراد قياسها، مفصولة بفواصل — مثلًا `SELECT revenue, impressions, accept_rate`.
* **`GROUP BY`** يقسّم تلك المقاييس حسب بُعد أو أكثر، مثل `date` أو `device` أو `surface` أو `funnel`. بدون `GROUP BY`، تحصل على إجمالي واحد للفترة بأكملها.
للاطلاع على القائمة الكاملة للمقاييس والأبعاد المتاحة — والتركيبات المسموح بها — راجع [المقاييس المتاحة](#available-metrics) و[الأبعاد المتاحة](#available-dimensions) أعلاه. يمنع المستكشف تلقائيًا التركيبات غير المتوافقة من المقاييس والأبعاد.
#### التصفية باستخدام `WHERE`
يضيّق `WHERE` نطاق البيانات قبل قياسها. اجمع الشروط باستخدام `AND`.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
WHERE device = "mobile"
GROUP BY date
SINCE last_month
GRAIN day
```
**لا يمكن** تصفية `impressions` و`accept_rate` و`rpv` أو تجميعها حسب الجهاز أو المسار أو الموضع أو المنتج — لا يحتوي مصدر تجميعها على عمود من هذا القبيل. إضافة `WHERE device = "mobile"` إلى استعلام يختار أيًا منها تُرفض برسالة `metric "impressions" cannot be filtered by "device"`.
المقارنات المدعومة هي `=` و`!=` و`IN` و`NOT IN` و`>` و`<` و`>=` و`<=`. استخدم قائمة مع `IN` لمطابقة عدة قيم:
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
WHERE surface IN ["PPU", "Checkout"]
```
`experiment` **ليس** حقلًا قابلًا للتصفية — فليس له مصدر تجميع، لذا يُرفض `WHERE experiment IN [...]` برسالة `filters on "experiment" are not supported.` (وهو مدرج ضمن **الأبعاد غير المتاحة** أدناه للسبب نفسه.)
#### التصفية حسب عدة مسارات
يدعم عامل تصفية **funnel** عوامل تشغيل متعددة الاختيار حتى تتمكن من قصر استعلام على مجموعة فرعية من مساراتك:
* **is one of** — يشمل المسارات المحددة فقط (`IN`).
* **is not one of** — يستبعد المسارات المحددة (`NOT IN`).
عند اختيار **is one of** أو **is not one of**، يتغير حقل إدخال القيمة إلى قائمة مربعات اختيار قابلة للتمرير تعرض جميع أسماء مساراتك. حدد أي عدد تحتاجه من المسارات.
عند تجميع النتائج حسب **Funnel** وتطبيق عامل تصفية **is one of**، يعرض المخطط الخطي خطًا واحدًا لكل مسار محدد — حتى إذا حددت أكثر من العدد الافتراضي للسلاسل. لا يُدمج أي مسار محدد في فئة "Other".
### النطاقات الزمنية والمقارنات
يحتاج كل استعلام إلى نطاق زمني، يُضبط باستخدام `SINCE`. استخدم إعدادًا مسبقًا أو نافذة مخصصة.
| الشكل | مثال | المعنى |
| ----------- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| إعداد مسبق | `SINCE last_30d` | نافذة متحركة تنتهي **أمس** (UTC). يُستبعد اليوم الجاري عمدًا، لذا يعني `last_1d` الأمس فقط، ويمتد `this_month` من اليوم الأول حتى الأمس. |
| نافذة مخصصة | `SINCE 2026-07-02 UNTIL 2026-07-05` | نطاق ثابت، باستخدام تواريخ ISO (`YYYY-MM-DD`). |
الإعدادات المسبقة المتاحة: `last_1d` و`last_7d` و`last_30d` و`last_90d` و`this_month` و`last_month` و`this_year`.
* **`GRAIN`** يحدد حجم الفترة للسلاسل الزمنية — `day` أو `week` أو `month`. (يُحلَّل `hour` لكن لا يوجد تجميع يقدم بيانات بالساعة، لذا يُرفض هذا الاستعلام برسالة `group_by / time_grain combination is not supported.`)
* **`COMPARE`** يُظهر فترة ثانية فوق الأولى لترى التغيير بنظرة واحدة. استخدم `previous_period` — النافذة ذات الطول المتساوي السابقة مباشرة. `previous_year` مخفي عمدًا من منتقي المقارنة لأن المستودع لا يحتوي على بيانات من قبل فبراير 2026؛ ويبقى قابلًا للكتابة في AQL فقط حتى تستمر الاستعلامات المحفوظة سابقًا في التحليل.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- A four-day sale vs the four days immediately before it
SELECT revenue, impressions, accept_rate
GROUP BY date
SINCE 2026-07-02 UNTIL 2026-07-05
GRAIN day
COMPARE previous_period
```
تبدأ بيانات التقارير في **فبراير 2026**، لذا فإن نافذة أقدم من ذلك تُرجع نتائج فارغة لكلتا الفترتين. وهذا أيضًا سبب عدم توفر المقارنات السنوية بعد.
### اختيار المخطط والمنطقة الزمنية
عادةً ما تُضبط هذه العبارات الاختيارية تلقائيًا عبر عناصر التحكم المرئية في المستكشف، ولكن يمكنك أيضًا كتابتها مباشرة:
* **`CHART`** يحدد كيفية عرض النتيجة: `scorecard` أو `line_chart` أو `bar_chart` أو `area_chart` أو `funnel_chart` أو `table`.
* **`TIMEZONE`** يحدد المنطقة الزمنية المستخدمة لتجميع التواريخ، كاسم IANA بين علامتي اقتباس — مثلًا `TIMEZONE "America/New_York"`. الافتراضي هو UTC.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT revenue
GROUP BY date
SINCE last_30d
GRAIN day
CHART line_chart
TIMEZONE "America/New_York"
```
لنوع `funnel_chart` متطلبات محددة:
* **وضع المواضع** — جمّع حسب `placement` واختر مقياسًا واحدًا. تُرتَّب المراحل حسب التسلسل القياسي للمواضع (البيع الإضافي الافتراضي ← البيع التنازلي ← عروض بيع إضافي إضافية). يُرسم المقياس الأول فقط؛ وتُذكر المقاييس الإضافية المحددة في حاشية.
* **وضع المقاييس** — اختر مقياسين أو أكثر دون `GROUP BY`. يصبح كل مقياس مرحلة في القمع حسب ترتيب الاستعلام (مثلًا، يعرض `SELECT impressions, conversions` معدل التسرب من مرات الظهور إلى التحويلات). يجب أن تشترك جميع المقاييس في الوحدة نفسها (مثلًا، لا يمكنك خلط مقاييس العملة والنسبة المئوية).
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Placement funnel: conversion drop-off across placements
SELECT conversions
GROUP BY placement
SINCE last_30d
CHART funnel_chart
```
يحتاج وضع المواضع إلى مقياس يمكن فعليًا تقسيمه حسب الموضع. لا يمكن ذلك لـ `impressions` و`accept_rate` و`rpv` — يعرض المخطط القمعي "These metrics can't be grouped by placement" لتلك المقاييس.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Metric funnel: impressions to conversions drop-off
SELECT impressions, conversions
SINCE last_30d
CHART funnel_chart
```
### الفرز والتحديد
* **`ORDER BY`** يفرز النتائج حسب مقياس أو بُعد، باستخدام `ASC` أو `DESC`.
* **`LIMIT`** يحدد عدد الصفوف المُرجعة — مفيد لأسئلة من نوع "أعلى N".
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Top 20 products by upsell revenue this month
SELECT revenue, conversions, avg_conversion_value
GROUP BY product
SINCE this_month
ORDER BY revenue DESC
LIMIT 20
```
### مزيد من الأمثلة
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Daily performance vs the previous period
SELECT revenue, impressions, conversions, accept_rate
GROUP BY date
SINCE last_30d
GRAIN day
COMPARE previous_period
```
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Mobile vs desktop revenue over the last 90 days
SELECT revenue
GROUP BY device
SINCE last_90d
ORDER BY revenue DESC
```
لا يمكن تقسيم `impressions` و`accept_rate` و`rpv` حسب الجهاز — تجميعها هو متجر × سطح × يوم، دون عمود للجهاز. استخدم `revenue` (أو مقياسًا آخر مصدره التحويلات) لمقارنات الأجهزة.
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
-- Which surface is driving the most revenue?
SELECT revenue, impressions, accept_rate
GROUP BY surface
SINCE last_30d
ORDER BY revenue DESC
```
بمجرد الحصول على استعلام يعجبك، احفظه وأضفه إلى تقرير كعنصر واجهة حتى يستمر في التحديث — راجع [إدارة عناصر الواجهة](/ar/aftersell/reports_widgets). لإزالة عنصر واجهة لم تعد بحاجة إليه، حمّله في المستكشف وانقر على **Delete** في شريط العنوان. يؤدي حذف عنصر الواجهة إلى إزالته من كل تقرير يظهر فيه. يظهر زر **Delete** فقط لعناصر الواجهة التي تملكها؛ عناصر الواجهة النموذجية العامة للقراءة فقط.
***
## تصدير النتائج
يعرض المستكشف نتائج استعلامك على الشاشة كبطاقة نتائج أو مخطط أو جدول — ولا ينزّل ملفًا مباشرة من عرض الاستعلام.
للحصول على النتائج كملف، احفظ الاستعلام وأضفه إلى تقرير كـ[عنصر واجهة](/ar/aftersell/reports_widgets). لكل عنصر واجهة زر **Export to CSV** خاص به ينزّل بيانات عنصر الواجهة كملف `.csv`. لعمليات التصدير القياسية من صفحة التحليلات (Excel وCSV)، راجع [تصدير بياناتك](/ar/aftersell/analytics_in_aftersell#exporting-your-data).
***
## دعم المناطق الزمنية
بشكل افتراضي، تعمل الاستعلامات بتوقيت UTC. يمكنك تجاوز المنطقة الزمنية لأي استعلام مباشرة في شريط أدوات المستكشف، بحيث تعكس النتائج المجمّعة حسب التاريخ (التقسيمات اليومية والأسبوعية والشهرية) توقيتك المحلي بدلًا من UTC.
الاستعلامات التي تتضمن **Impressions** أو **Accept Rate** أو **Revenue Per Visit** تجمّع التواريخ دائمًا بتوقيت UTC، بغض النظر عن المنطقة الزمنية التي تحددها. تُستمد هذه المقاييس من تجميع يومي يُبلَّغ عنه فقط بأيام UTC. إذا خلط استعلام أحد هذه المقاييس بمقاييس أخرى، فترجع مجموعة النتائج بأكملها إلى UTC لتبقى فترات التواريخ متوافقة.
### تعيين منطقة زمنية لاستعلام
1. افتح المستكشف في لوحة إدارة Aftersell.
2. في شريط الأدوات، انقر على منتقي **Timezone** (بجوار **Compare**).
3. اختر إحدى المناطق الزمنية المتاحة من القائمة، أو حدد **Account default** لاستخدام المنطقة الزمنية المهيأة في إعدادات التحليلات لديك.
4. شغّل استعلامك. تُجمَّع النتائج باستخدام المنطقة الزمنية المحددة.
تُحفظ المنطقة الزمنية المحددة مع الاستعلام. عند حفظ استعلام وإعادة تحميله، تُستعاد المنطقة الزمنية تلقائيًا.
### المنطقة الزمنية الافتراضية للحساب
إذا كان لديك **Lock reporting timezone** مفعّلًا في إعدادات التحليلات، فإن تحديد **Account default** في شريط الأدوات يستخدم تلك المنطقة الزمنية المقفلة لاستعلامك. يعرض تصنيف شريط الأدوات المنطقة المحددة، مثلًا **Timezone: Account default (Paris (CET))**.
تقبل صفحة إعدادات التحليلات قائمة IANA الكاملة للمناطق الزمنية، لكن التقارير لا تعترف إلا بالمناطق العشر أعلاه. إذا لم تكن منطقتك المقفلة إحداها، فسيتحول **Account default** بصمت إلى UTC — لذا اختر منطقة مقفلة من هذه القائمة إذا أردت أن تتبعها التقارير.
إذا لم يكن **Lock reporting timezone** مفعّلًا، فيرجع **Account default** إلى UTC.
### تحديد منطقة زمنية في AQL
يمكنك أيضًا تحديد منطقة زمنية مباشرة في استعلام AQL باستخدام عبارة `TIMEZONE`، التي تظهر بين `CHART` و`ORDER BY`:
```aql theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
SELECT ...
CHART ...
TIMEZONE "Asia/Tokyo"
ORDER BY ...
```
عند وجودها، تتجاوز هذه العبارة اختيار شريط الأدوات لذلك الاستعلام. تُحفظ المنطقة الزمنية عند حفظ الاستعلام وإعادة تحميله.
### المناطق الزمنية المتاحة
يتضمن منتقي المناطق الزمنية الخيارات التالية:
| المنطقة الزمنية | مثال على الموقع |
| -------------------- | ---------------------- |
| UTC | التوقيت العالمي المنسق |
| America/New\_York | نيويورك (ET) |
| America/Chicago | شيكاغو (CT) |
| America/Denver | دنفر (MT) |
| America/Los\_Angeles | لوس أنجلوس (PT) |
| Europe/London | لندن (GMT/BST) |
| Europe/Paris | باريس (CET/CEST) |
| Asia/Tokyo | طوكيو (JST) |
| Asia/Singapore | سنغافورة (SGT) |
| Australia/Sydney | سيدني (AEST/AEDT) |
هذه مجموعة مغلقة من عشر مناطق. أي منطقة زمنية IANA أخرى في عبارة `TIMEZONE` تُرفض باعتبارها غير مدعومة.
### كيف تؤثر المنطقة الزمنية على نتائج الاستعلام
عند تعيين منطقة زمنية، يستخدم تجميع التواريخ في استعلامك التوقيت المحلي بدلًا من UTC. على سبيل المثال، حدث وقع في `2026-03-29T01:30:00Z` (UTC) يقع في 28 مارس بتوقيت نيويورك (ET) لكن في 29 مارس بتوقيت باريس (CET). يضمن تعيين المنطقة الزمنية الصحيحة أن تتطابق تقسيماتك اليومية والأسبوعية والشهرية مع توقعات تقارير نشاطك التجاري.
الاستعلامات التي لا تتضمن منطقة زمنية — بما في ذلك الاستعلامات المحفوظة سابقًا — تستمر في العمل بتوقيت UTC، لذا لا تتأثر النتائج الحالية.
***
## هل تحتاج إلى مساعدة؟
إذا كانت لديك أسئلة حول المستكشف أو أردت تفعيل الوصول، فتواصل مع فريق دعم Aftersell عبر الدردشة داخل التطبيق.