Skip to main content
كل استعلام تنشئه في Explorer هو عبارة AftersellQL (AQL). في معظم الأحيان تُنشئ الاستعلامات بصريًا ولا تكتب AQL يدويًا أبدًا؛ هذه الصفحة هي المرجع للمقاييس والأبعاد التي يمكنك اختيارها، والصيغة النصية لـ AQL، وقواعد المنطقة الزمنية.

المقاييس المتاحة

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

الإيرادات والربح

التحويلات

التفاعل

أداء المتجر

شبكة Rokt

الأبعاد

تفصّل الأبعاد المقياس حسب سمة معينة. ليست كل الأبعاد متوافقة مع كل مقياس؛ يمنع Explorer تلقائيًا التركيبات غير المتوافقة (على سبيل المثال، لا يمكن تفصيل Decline rate وShow rate حسب Currency).

الأبعاد المتاحة

الأبعاد غير المتاحة

الأبعاد التالية قيد التطوير. تظهر في أداة الاختيار لكنها تظهر بحالة ‘Not compatible’ لكل مقياس إلى أن يتم تنفيذها.

صيغة عبارات AQL

عبارة AQL هي سؤال واحد مكوّن من عبارات فرعية. فقط SELECT ونطاق زمني (SINCE) مطلوبان؛ وكل ما عدا ذلك اختياري. عند تضمين العبارات الاختيارية، يجب أن تظهر بهذا الترتيب:
مثال بسيط، إيرادات البيع الإضافي ومعدل القبول اليومي لآخر 30 يومًا:
الكلمات المفتاحية غير حساسة لحالة الأحرف (SELECT وselect كلاهما يعمل) ولا تنتهي العبارات بفاصلة منقوطة. تُحاط القيم النصية بعلامات اقتباس مزدوجة؛ أما الأرقام والقوائم فلا.

SELECT وGROUP BY

  • SELECT يسرد المقاييس المراد قياسها، مفصولة بفواصل، على سبيل المثال SELECT revenue, impressions, accept_rate.
  • GROUP BY يفصّل تلك المقاييس حسب بُعد واحد أو أكثر، مثل date أو device أو surface أو funnel. بدون GROUP BY، تحصل على إجمالي واحد للفترة بأكملها.

التصفية باستخدام WHERE

يضيّق WHERE نطاق البيانات قبل قياسها. اجمع الشروط باستخدام AND.
لا يمكن تصفية impressions وaccept_rate وrpv أو تجميعها حسب الجهاز أو المسار أو الموضع أو المنتج؛ إذ لا يحتوي التجميع المصدر لها على مثل هذا العمود. إضافة WHERE device = "mobile" إلى استعلام يختار أيًا منها تُرفض مع الرسالة metric "impressions" cannot be filtered by "device".
المقارنات المدعومة هي = و!= وIN وNOT IN و> و< و>= و<=. استخدم قائمة مع IN لمطابقة عدة قيم:
experiment ليس حقلًا قابلًا للتصفية؛ إذ لا يوجد له مصدر تجميع، لذا يُرفض WHERE experiment IN [...] مع الرسالة filters on "experiment" are not supported. يدعم عامل تصفية funnel التحديد المتعدد: is one of (IN) يتضمن المسارات المحددة فقط، وis not one of (NOT IN) يستبعدها. عند التجميع حسب Funnel وتطبيق عامل تصفية is one of، يعرض المخطط خطًا واحدًا لكل مسار محدد، دون دمج في “Other”.

النطاقات الزمنية والمقارنات

يحتاج كل استعلام إلى نطاق زمني، يُحدَّد باستخدام SINCE: الإعدادات المسبقة المتاحة: 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 مخفية من أداة اختيار Compare لأن مستودع البيانات لا يحتوي على بيانات قبل فبراير 2026؛ وتبقى قابلة للكتابة في AQL فقط حتى يستمر تحليل الاستعلامات المحفوظة سابقًا.
تبدأ بيانات التقارير في فبراير 2026، لذا فإن أي نافذة أقدم من ذلك تُرجع نتائج فارغة لكلتا الفترتين.

اختيار المخطط

  • CHART يحدد طريقة عرض النتيجة: scorecard أو line_chart أو bar_chart أو area_chart أو funnel_chart أو table.
  • TIMEZONE يحدد المنطقة الزمنية المستخدمة لتجميع التواريخ، كاسم IANA بين علامتي اقتباس، على سبيل المثال TIMEZONE "America/New_York". القيمة الافتراضية هي UTC (انظر المناطق الزمنية).
لنوع funnel_chart متطلبات محددة:
  • وضع الموضع. جمّع حسب placement واختر مقياسًا واحدًا. تُرتَّب المراحل وفق تسلسل المواضع القياسي (البيع الإضافي الافتراضي، ثم البيع البديل، ثم عروض البيع الإضافي الإضافية). يُرسم المقياس الأول فقط؛ ويُشار إلى المقاييس الإضافية في حاشية.
  • وضع المقاييس. اختر مقياسين أو أكثر دون GROUP BY. يصبح كل مقياس مرحلة في المسار بترتيب الاستعلام (على سبيل المثال، SELECT impressions, conversions يعرض الانخفاض من مرات الظهور إلى التحويلات). يجب أن تشترك جميع المقاييس في الوحدة نفسها.
يحتاج وضع الموضع إلى مقياس يمكن تفصيله حسب الموضع. لا يمكن ذلك مع impressions وaccept_rate وrpv؛ إذ يعرض مخطط المسار الرسالة “These metrics can’t be grouped by placement” لها.

الفرز والتقييد

  • ORDER BY يفرز النتائج حسب مقياس أو بُعد، مع ASC أو DESC.
  • LIMIT يحدد الحد الأقصى لعدد الصفوف المُرجعة، وهو مفيد لأسئلة “أفضل N”.

المزيد من الأمثلة

لا يمكن تفصيل impressions وaccept_rate وrpv حسب الجهاز؛ فتجميعها هو المتجر × السطح × اليوم، دون عمود للجهاز. استخدم revenue (أو مقياسًا آخر مصدره التحويلات) لمقارنات الأجهزة.

المناطق الزمنية

افتراضيًا، تعمل الاستعلامات بتوقيت UTC. يمكنك تجاوز المنطقة الزمنية بحيث تعكس النتائج المجمّعة حسب التاريخ التوقيت المحلي (انظر تعيين منطقة زمنية لخطوات شريط الأدوات).
الاستعلامات التي تتضمن Impressions أو Accept Rate أو Revenue Per Visit تجمّع التواريخ دائمًا بتوقيت UTC، بغض النظر عن المنطقة الزمنية التي تختارها، لأن مصدرها تجميع يومي يُبلغ عنه بأيام UTC. إذا جمع استعلام أحد هذه المقاييس مع مقاييس أخرى، فإن مجموعة النتائج بأكملها تعود إلى UTC حتى تبقى فترات التواريخ متوافقة.

عبارة TIMEZONE

حدد منطقة زمنية مباشرةً في AQL باستخدام عبارة TIMEZONE، التي تظهر بين CHART وORDER BY:
عند وجودها، تتجاوز العبارة التحديد في شريط الأدوات لهذا الاستعلام، وتُحفظ عند الحفظ وإعادة التحميل.

المناطق الزمنية المتاحة

تقبل أداة الاختيار (وعبارة TIMEZONE) مجموعة مغلقة من عشر مناطق. تُرفض أي منطقة زمنية أخرى من IANA باعتبارها غير مدعومة.

الإعداد الافتراضي للحساب وكيف تؤثر المنطقة الزمنية على النتائج

إذا كان Lock reporting timezone مفعّلًا في إعدادات التحليلات، فإن اختيار Account default يستخدم تلك المنطقة الزمنية المقفلة (يعرض شريط الأدوات المنطقة المحددة، على سبيل المثال Timezone: Account default (Paris (CET))). تقبل صفحة إعدادات التحليلات قائمة IANA الكاملة، لكن Reports تلتزم فقط بالمناطق العشر المذكورة أعلاه؛ وإذا لم تكن منطقتك المقفلة إحداها، فإن Account default تتحول بصمت إلى UTC. إذا لم يكن Lock reporting timezone مفعّلًا، فإن Account default تعود إلى UTC. عند تعيين منطقة زمنية، يستخدم تجميع التواريخ التوقيت المحلي بدلًا من UTC. على سبيل المثال، الحدث الذي يقع في 2026-03-29T01:30:00Z يقع في 28 مارس في نيويورك (ET) لكنه يقع في 29 مارس في باريس (CET). الاستعلامات التي لا تحتوي على منطقة زمنية، بما في ذلك المحفوظة سابقًا، تستمر في العمل بتوقيت UTC.