المقاييس المتاحة
الإيرادات والأرباح
التحويلات
التفاعل
أداء المتجر
شبكة Rokt
الأبعاد
بعض تركيبات الأبعاد والمقاييس غير متوافقة. على سبيل المثال، لا يمكن تقسيم Decline rate وShow rate حسب Currency. يمنع المستكشف تلقائيًا التركيبات غير المتوافقة.
الأبعاد المتاحة
الأبعاد التالية عمل قيد الإنجاز. تظهر في المنتقي لكنها غير متاحة بعد كتقسيم. وبدلًا من ذلك، تظهر كـ ‘Not compatible’ لكل مقياس. سيتم تحديث هذا المستند عند اكتمال تنفيذ هذه الأبعاد.
كتابة استعلامات AQL
كيف تُقرأ عبارة AQL
SELECT ونطاق زمني (SINCE)؛ كل ما عدا ذلك اختياري. عند تضمين عبارات اختيارية، يجب أن تظهر بالترتيب الموضح أدناه.
الكلمات المفتاحية غير حساسة لحالة الأحرف (
SELECT وselect كلاهما يعمل) ولا تنتهي العبارات بفاصلة منقوطة. تُحاط القيم النصية بعلامات اقتباس مزدوجة؛ أما الأرقام والقوائم فلا.اختيار ما تقيسه وكيفية تقسيمه
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. (وهو مدرج ضمن الأبعاد غير المتاحة أدناه للسبب نفسه.)
التصفية حسب عدة مسارات
- is one of — يشمل المسارات المحددة فقط (
IN). - is not one of — يستبعد المسارات المحددة (
NOT IN).
النطاقات الزمنية والمقارنات
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مخفي عمدًا من منتقي المقارنة لأن المستودع لا يحتوي على بيانات من قبل فبراير 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 (أو مقياسًا آخر مصدره التحويلات) لمقارنات الأجهزة.تصدير النتائج
.csv. لعمليات التصدير القياسية من صفحة التحليلات (Excel وCSV)، راجع تصدير بياناتك.
دعم المناطق الزمنية
الاستعلامات التي تتضمن Impressions أو Accept Rate أو Revenue Per Visit تجمّع التواريخ دائمًا بتوقيت UTC، بغض النظر عن المنطقة الزمنية التي تحددها. تُستمد هذه المقاييس من تجميع يومي يُبلَّغ عنه فقط بأيام UTC. إذا خلط استعلام أحد هذه المقاييس بمقاييس أخرى، فترجع مجموعة النتائج بأكملها إلى UTC لتبقى فترات التواريخ متوافقة.
تعيين منطقة زمنية لاستعلام
- افتح المستكشف في لوحة إدارة Aftersell.
- في شريط الأدوات، انقر على منتقي Timezone (بجوار Compare).
- اختر إحدى المناطق الزمنية المتاحة من القائمة، أو حدد Account default لاستخدام المنطقة الزمنية المهيأة في إعدادات التحليلات لديك.
- شغّل استعلامك. تُجمَّع النتائج باستخدام المنطقة الزمنية المحددة.
المنطقة الزمنية الافتراضية للحساب
تحديد منطقة زمنية في AQL
TIMEZONE، التي تظهر بين CHART وORDER BY:
المناطق الزمنية المتاحة
هذه مجموعة مغلقة من عشر مناطق. أي منطقة زمنية IANA أخرى في عبارة
TIMEZONE تُرفض باعتبارها غير مدعومة.
كيف تؤثر المنطقة الزمنية على نتائج الاستعلام
2026-03-29T01:30:00Z (UTC) يقع في 28 مارس بتوقيت نيويورك (ET) لكن في 29 مارس بتوقيت باريس (CET). يضمن تعيين المنطقة الزمنية الصحيحة أن تتطابق تقسيماتك اليومية والأسبوعية والشهرية مع توقعات تقارير نشاطك التجاري.
الاستعلامات التي لا تتضمن منطقة زمنية — بما في ذلك الاستعلامات المحفوظة سابقًا — تستمر في العمل بتوقيت UTC، لذا لا تتأثر النتائج الحالية.