קבלת נתוני לקוח

בזרימות עבודה שמשתמשות בנתוני לקוח, ניתן להשתמש בפעולה קבלת נתוני לקוח כדי לאחזר מידע על לקוחות מהחנות שלך.

תצורה

שדות

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

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

מחרוזת שאילתה

זוהי שאילתה לדוגמה לקבלת לקוחות שעודכנו ביום האחרון:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

המשתנה updated_at הוא מסנן שזמין בשאילתת לקוחות וניתן להשתמש בו מספר פעמים או לשלב אותו עם משתנים אחרים. משתנה ה-Liquid‏ scheduledAt זמין בזרימות עבודה שהשתמשו בטריגר זמן מתוזמן. תג ה-Liquid‏ date_minus הוא תג Flow מיוחד שמאפשר להחסיר זמן מתאריך.

כאשר מבצעים שאילתת נתונים, כדאי לדעת:

  • רשימה של מסננים זמינים עבור לקוחות
  • שאילתות חייבות להיות לפי תחביר מסוים
  • הערכים של שדות השאילתה לא תמיד מתועדים. במקרים מסוימים, ניתן למצוא את הערכים על ידי עיון בתיעוד ה-API. לחלופין, לרוב אפשר למצוא את ערכי השדות בכתובות ה-URL במנהל כאשר מסננים. לדוגמה, כדי למצוא ערכים מסוימים של שאילתת הזמנות, יש לסנן את דף ההזמנות במנהל, ולאחר מכן לבדוק את כתובת ה-URL.
  • ניתן להריץ או לבדוק שאילתה בחנות שלך באמצעות האפליקציה Shopify GraphiQL.
  • חשוב לשים לב למה שקורה אם השאילתה נכשלת. לעיתים קרובות ה-API יחזיר את כל התוצאות (במקום אף אחת).

נתונים שהוחזרו

כל פעולות קבלת נתונים מחזירות רשימה של בין 0 ל-100 משאבים. בהתאם לתרחיש השימוש שלך, ייתכן שתרצה להשתמש בנתונים אלה בדרכים שונות:

  • אם עליך לטפל בכל פריט ברשימה בנפרד, לדוגמה כדי להוסיף תג לכל פריט, תוכל להשתמש בפעולה For each.
  • אם עליך לצבור נתונים, לדוגמה לספור כמה תוצאות הוחזרו, תוכל להשתמש בפעולות Count או Sum.
  • אם עליך להפיק פלט של הרשימה, לדוגמה לשלוח דוא"ל עם כל הפריטים, תוכל להשתמש בנתונים שהוחזרו ישירות בפעולות הבאות.

כדי לגשת לנתונים שהוחזרו בשלבים שלאחר פעולה זו, השתמש במשתנה בשם קבלת נתוני לקוח, שהוא רשימה של לקוחות. תוכל להשתמש במשתנה זה גם בתנאים וגם בפעולות. לדוגמה, תוכל לשלוח את רשימת ההזמנות בפעולה שלח דוא"ל פנימי כך:

{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}

טריגרים

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

פרטי API

תבניות

המרת מטא שדה של לקוח לתגים עבור כל הלקוחות

זרימת עבודה זו תשלים תגים עבור כל הלקוחות שלך על בסיס ערך של מטא שדה. היא רצה כל שעה ומאחזרת עד 100 לקוחות שאין להם תג "processed". עבור כל לקוח, היא בודקת את הערך של מטא שדה custom.test ומוסיפה אותו כתג. זרימת העבודה מוסיפה גם תג "processed" כך שהוא לא יוחזר בריצה המתוזמנת הבאה של זרימת העבודה. כדי להשתמש בזרימת העבודה, יהיה עליך לשנות את מרחב השמות והמפתח של המטא שדה כך שיתאימו למטא שדה בחנות שלך. הצגת התבנית

מחיקת לקוחות לא פעילים

מחיקת לקוחות שנוצרו לפני יותר מ-5 שנים ומעולם לא ביצעו הזמנה. הצגת התבנית