تفصّل الأبعاد المقياس حسب سمة معينة. ليست كل الأبعاد متوافقة مع كل مقياس؛ يمنع Explorer تلقائيًا التركيبات غير المتوافقة (على سبيل المثال، لا يمكن تفصيل Decline rate وShow rate حسب Currency).
الأبعاد التالية قيد التطوير. تظهر في أداة الاختيار لكنها تظهر بحالة ‘Not compatible’ لكل مقياس إلى أن يتم تنفيذها.
عبارة AQL هي سؤال واحد مكوّن من عبارات فرعية. فقط
SELECT ونطاق زمني (SINCE) مطلوبان؛ وكل ما عدا ذلك اختياري. عند تضمين العبارات الاختيارية، يجب أن تظهر بهذا الترتيب:
الكلمات المفتاحية غير حساسة لحالة الأحرف (
SELECT وselect كلاهما يعمل) ولا تنتهي العبارات بفاصلة منقوطة. تُحاط القيم النصية بعلامات اقتباس مزدوجة؛ أما الأرقام والقوائم فلا.SELECTيسرد المقاييس المراد قياسها، مفصولة بفواصل، على سبيل المثالSELECT revenue, impressions, accept_rate.GROUP BYيفصّل تلك المقاييس حسب بُعد واحد أو أكثر، مثلdateأوdeviceأوsurfaceأوfunnel. بدونGROUP BY، تحصل على إجمالي واحد للفترة بأكملها.
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، التي تظهر بين 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.