الحصول على بيانات التحليلات
يُشغّل إجراء الحصول على بيانات التحليلات استعلام ShopifyQL ويُرجع النتائج لاستخدامها في سير عملك. ShopifyQL هي لغة استعلام مصممة لتحليلات التجارة. يمكنك استخدامها لتجميع المقاييس عبر فترات زمنية، وتطبيق الفلاتر، والتجميع حسب أبعاد مثل المنتج، أو المجموعة، أو العميل. البيانات التي يُرجعها هذا الإجراء متاحة للشروط والإجراءات التي تتبع الخطوة.
المُشغّلات
يتوافق إجراء الحصول على بيانات التحليلات فقط مع مُشغّل الوقت المجدول. لا يتم تضمين بيانات التحليلات في المُشغّلات القائمة على الأحداث.
التهيئة
الحقول
يحتوي إجراء الحصول على بيانات التحليلات على الحقل التالي:
| الحقل | الوصف |
|---|---|
| استعلام ShopifyQL | مطلوب. استعلام ShopifyQL المراد تشغيله على بيانات تحليلات متجرك. |
استعلام ShopifyQL
يمكنك كتابة أي استعلام ShopifyQL صالح باستخدام المخططات المدعومة، مثل sales، وsessions، وinventory، وpayments. على سبيل المثال، يُرجع الاستعلام التالي إجمالي المبيعات وعدد العملاء في اليوم الذي يُشغَّل فيه سير العمل:
FROM sales
SHOW total_sales, customers
SINCE todayللحصول على المرجع الكامل للغة، بما في ذلك المخططات والوظائف والبنية المدعومة، راجع وثائق ShopifyQL.
يتم التحقق من صحة الاستعلام عند حفظ سير العمل. لا يمكن تفعيل سير العمل حتى يتم تشغيل الاستعلام بنجاح على متجرك.
البيانات المرجعة
يُرجع إجراء الحصول على بيانات التحليلات الصفوف التي تطابق استعلامك، وهي متاحة كمتغير باسم getAnalyticsData. يتم تخزين الصفوف في getAnalyticsData.rows، حيث يمثل كل صف كائنًا مفتاحه هو أسماء الأعمدة في استعلامك.
يمكنك استخدام هذا المتغير في كل من الشروط والإجراءات التي تتبع الخطوة. على سبيل المثال، لإرسال بريد إلكتروني داخلي يسرد كل صف، يمكنك استخدام Liquid على النحو التالي:
{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}للعمل مع كل صف بشكل فردي، مثل تطبيق إجراء لكل صف، يمكنك استخدام إجراء حلقة لكل صف (التكرار) مع getAnalyticsData.rows. لتجميع القيم، مثل حساب عدد الصفوف أو جمع عمود، يمكنك استخدام إجرائي العدد والمجموع.
مرجع واجهة برمجة التطبيقات (API)
لمزيد من المعلومات حول واجهة برمجة التطبيقات (API) المستخدَمة في هذا الإجراء، راجع استعلام shopifyqlQuery في GraphQL Admin API.
تعقيد الاستعلام
لكل استعلام ShopifyQL تكلفة تعقيد تُحسب بناءً على المخططات والأعمدة وعوامل التصفية والنطاق الزمني الذي يستخدمه الاستعلام. إذا تجاوز الاستعلام حد التعقيد، سيفشل الإجراء ولا يمكن تفعيل سير العمل. لتقليل تكلفة الاستعلام، يمكنك تقصير النطاق الزمني أو إزالة الأعمدة أو إزالة عمليات الربط.
للحصول على التفاصيل حول كيفية حساب تكلفة الاستعلام والحدود الحالية، راجع تقييد المعدل في ShopifyQL Admin API.