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

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

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

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

التحويلات

التفاعل

أداء المتجر

شبكة Rokt


الأبعاد

تتيح لك الأبعاد تقسيم المقاييس حسب سمة معينة. ليست كل الأبعاد متوافقة مع كل مقياس.
بعض تركيبات الأبعاد والمقاييس غير متوافقة. على سبيل المثال، لا يمكن تقسيم Decline rate وShow rate حسب Currency. يمنع المستكشف تلقائيًا التركيبات غير المتوافقة.

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

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

الأبعاد التالية عمل قيد الإنجاز. تظهر في المنتقي لكنها غير متاحة بعد كتقسيم. وبدلًا من ذلك، تظهر كـ ‘Not compatible’ لكل مقياس. سيتم تحديث هذا المستند عند اكتمال تنفيذ هذه الأبعاد.

كتابة استعلامات AQL

كل استعلام تبنيه في المستكشف هو عبارة AftersellQL (AQL). في معظم الأحيان تبني الاستعلامات بصريًا — باختيار المقاييس والأبعاد وعوامل التصفية ونطاق زمني من القوائم — دون الحاجة أبدًا إلى كتابة AQL يدويًا. للمستخدمين المتقدمين، يتيح المستكشف أيضًا الاستعلام الأساسي كنص قابل للتعديل. هذا القسم هو مرجع ذلك الشكل النصي: ما تعنيه العبارات، والقيم التي تقبلها، وبعض الأمثلة الجاهزة للاستخدام.

كيف تُقرأ عبارة AQL

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

اختيار ما تقيسه وكيفية تقسيمه

  • 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).
عند اختيار is one of أو is not one of، يتغير حقل إدخال القيمة إلى قائمة مربعات اختيار قابلة للتمرير تعرض جميع أسماء مساراتك. حدد أي عدد تحتاجه من المسارات. عند تجميع النتائج حسب 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 مخفي عمدًا من منتقي المقارنة لأن المستودع لا يحتوي على بيانات من قبل فبراير 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 (أو مقياسًا آخر مصدره التحويلات) لمقارنات الأجهزة.
بمجرد الحصول على استعلام يعجبك، احفظه وأضفه إلى تقرير كعنصر واجهة حتى يستمر في التحديث — راجع إدارة عناصر الواجهة. لإزالة عنصر واجهة لم تعد بحاجة إليه، حمّله في المستكشف وانقر على Delete في شريط العنوان. يؤدي حذف عنصر الواجهة إلى إزالته من كل تقرير يظهر فيه. يظهر زر Delete فقط لعناصر الواجهة التي تملكها؛ عناصر الواجهة النموذجية العامة للقراءة فقط.

تصدير النتائج

يعرض المستكشف نتائج استعلامك على الشاشة كبطاقة نتائج أو مخطط أو جدول — ولا ينزّل ملفًا مباشرة من عرض الاستعلام. للحصول على النتائج كملف، احفظ الاستعلام وأضفه إلى تقرير كـعنصر واجهة. لكل عنصر واجهة زر Export to CSV خاص به ينزّل بيانات عنصر الواجهة كملف .csv. لعمليات التصدير القياسية من صفحة التحليلات (Excel وCSV)، راجع تصدير بياناتك.

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

بشكل افتراضي، تعمل الاستعلامات بتوقيت 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:
عند وجودها، تتجاوز هذه العبارة اختيار شريط الأدوات لذلك الاستعلام. تُحفظ المنطقة الزمنية عند حفظ الاستعلام وإعادة تحميله.

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

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

كيف تؤثر المنطقة الزمنية على نتائج الاستعلام

عند تعيين منطقة زمنية، يستخدم تجميع التواريخ في استعلامك التوقيت المحلي بدلًا من UTC. على سبيل المثال، حدث وقع في 2026-03-29T01:30:00Z (UTC) يقع في 28 مارس بتوقيت نيويورك (ET) لكن في 29 مارس بتوقيت باريس (CET). يضمن تعيين المنطقة الزمنية الصحيحة أن تتطابق تقسيماتك اليومية والأسبوعية والشهرية مع توقعات تقارير نشاطك التجاري. الاستعلامات التي لا تتضمن منطقة زمنية — بما في ذلك الاستعلامات المحفوظة سابقًا — تستمر في العمل بتوقيت UTC، لذا لا تتأثر النتائج الحالية.

هل تحتاج إلى مساعدة؟

إذا كانت لديك أسئلة حول المستكشف أو أردت تفعيل الوصول، فتواصل مع فريق دعم Aftersell عبر الدردشة داخل التطبيق.