المقاييس المتاحة
الإيرادات والربح
التحويلات
التفاعل
أداء المتجر
شبكة Rokt
الأبعاد
الأبعاد المتاحة
الأبعاد التالية قيد التطوير. تظهر في أداة الاختيار لكنها تظهر بحالة ‘Not compatible’ لكل مقياس إلى أن يتم تنفيذها.
صيغة عبارات AQL
SELECT ونطاق زمني (SINCE) مطلوبان؛ وكل ما عدا ذلك اختياري. عند تضمين العبارات الاختيارية، يجب أن تظهر بهذا الترتيب:
الكلمات المفتاحية غير حساسة لحالة الأحرف (
SELECT وselect كلاهما يعمل) ولا تنتهي العبارات بفاصلة منقوطة. تُحاط القيم النصية بعلامات اقتباس مزدوجة؛ أما الأرقام والقوائم فلا.SELECT وGROUP BY
SELECTيسرد المقاييس المراد قياسها، مفصولة بفواصل، على سبيل المثالSELECT revenue, impressions, accept_rate.GROUP BYيفصّل تلك المقاييس حسب بُعد واحد أو أكثر، مثلdateأوdeviceأوsurfaceأوfunnel. بدونGROUP BY، تحصل على إجمالي واحد للفترة بأكملها.
التصفية باستخدام WHERE
WHERE نطاق البيانات قبل قياسها. اجمع الشروط باستخدام AND.
= و!= و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يعرض الانخفاض من مرات الظهور إلى التحويلات). يجب أن تشترك جميع المقاييس في الوحدة نفسها.
الفرز والتقييد
ORDER BYيفرز النتائج حسب مقياس أو بُعد، معASCأوDESC.LIMITيحدد الحد الأقصى لعدد الصفوف المُرجعة، وهو مفيد لأسئلة “أفضل N”.
المزيد من الأمثلة
لا يمكن تفصيل
impressions وaccept_rate وrpv حسب الجهاز؛ فتجميعها هو المتجر × السطح × اليوم، دون عمود للجهاز. استخدم revenue (أو مقياسًا آخر مصدره التحويلات) لمقارنات الأجهزة.المناطق الزمنية
الاستعلامات التي تتضمن Impressions أو Accept Rate أو Revenue Per Visit تجمّع التواريخ دائمًا بتوقيت UTC، بغض النظر عن المنطقة الزمنية التي تختارها، لأن مصدرها تجميع يومي يُبلغ عنه بأيام UTC. إذا جمع استعلام أحد هذه المقاييس مع مقاييس أخرى، فإن مجموعة النتائج بأكملها تعود إلى UTC حتى تبقى فترات التواريخ متوافقة.
عبارة TIMEZONE
TIMEZONE، التي تظهر بين CHART وORDER BY:
المناطق الزمنية المتاحة
TIMEZONE) مجموعة مغلقة من عشر مناطق. تُرفض أي منطقة زمنية أخرى من IANA باعتبارها غير مدعومة.
الإعداد الافتراضي للحساب وكيف تؤثر المنطقة الزمنية على النتائج
2026-03-29T01:30:00Z يقع في 28 مارس في نيويورك (ET) لكنه يقع في 29 مارس في باريس (CET). الاستعلامات التي لا تحتوي على منطقة زمنية، بما في ذلك المحفوظة سابقًا، تستمر في العمل بتوقيت UTC.