קבלת נתוני אנליטיקה

הפעולה קבלת נתוני אנליטיקה מריצה שאילתת ShopifyQL ומחזירה את התוצאות לשימוש בתהליך העבודה שלך. ShopifyQL היא שפת שאילתות שנבנתה עבור אנליטיקה של מסחר. אפשר להשתמש בה כדי לצבור מדדים על פני תקופות זמן, להחיל מסננים ולקבץ לפי ממדים כגון מוצר, אוסף או לקוח. הנתונים המוחזרים מפעולה זו זמינים לתנאים ולפעולות הבאים בשלבים שאחרי.

טיפ

השפה ShopifyQL משמשת גם בדוחות שלך ב-Shopify ובפילוח לקוחות. ניתן ללמוד עוד על שאילתות ותחביר של ShopifyQL.

טריגרים

הפעולה קבלת נתוני אנליטיקה תואמת רק לטריגר Scheduled time. נתוני אנליטיקה אינם נכללים בטריגרים מבוססי אירועים.

תצורה

שדות

הפעולה קבלת נתוני אנליטיקה מכילה את השדה הבא:

השדות שבהם נעשה שימוש בפעולה קבלת נתוני אנליטיקה.

שדה	תיאור
שאילתת 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 %}

כדי לעבוד עם כל שורה בנפרד, למשל כדי להחיל פעולה על כל שורה, ניתן להשתמש בפעולה For each loop (iterate) עם getAnalyticsData.rows. כדי לצבור ערכים, למשל לספור שורות או לסכום עמודה, ניתן להשתמש בפעולות Count ו-Sum.

הערה

אם נעשה שימוש בפעולת קבלת נתונים מספר פעמים בתהליך עבודה אחד, יתווסף מספר לשם המשתנה. לדוגמה, בתהליך עבודה שמשתמש בפעולה קבלת נתוני הזמנה פעמיים, המשתנה הראשון עבור הנתונים המוחזרים יהיה getOrderData והמשתנה השני יהיה getOrderData1. לא ניתן להתאים אישית את השם הזה.

הפניה ל-API

למידע נוסף על ה-API שבו נעשה שימוש בפעולה זו, ניתן לעיין בשאילתה shopifyqlQuery ב-GraphQL Admin API.

מורכבות שאילתה

לכל שאילתת ShopifyQL יש עלות מורכבות שמחושבת על סמך הסכמות, העמודות, המסננים וטווח הזמן שבהם השאילתה משתמשת. אם שאילתה חורגת ממגבלת המורכבות, הפעולה נכשלת ולא ניתן להפעיל את תהליך העבודה. כדי להפחית את העלות של שאילתה, אפשר לקצר את טווח הזמן, להסיר עמודות או להסיר צירופים (joins).

לפרטים על אופן חישוב עלות השאילתה והמגבלות הנוכחיות, ניתן לעיין ב-הגבלת קצב ב-ShopifyQL Admin API.