הרחבות ו-Functions של יישומים

יישומים מסוימים מוסיפים תכונות לחנות שלך באמצעות הרחבות ו-Functions. ההרחבות וה-Functions מוגדרות על ידי מפתח היישומים והופכות לזמינות עם התקנת היישום והפעלתו.

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

Functions מאפשרות ליישומים להתאים אישית את לוגיקת העורף (backend) של החנות שלך. לדוגמה, יישום יכול להשתמש ב-Function כדי ליצור סוג של הנחה מותאמת אישית, להתאים את אפשרויות המסירה בשלב התשלום, או להחיל כללי תשלום ספציפיים. ה-Functions מופעלות אוטומטית כחלק מפעילות החנות שלך לאחר שתגדיר את היישום.

אפשר להציג ולנהל הרחבות ופונקציות של היישומים המותקנים דרך הגדרות > יישומים ב-Shopify Admin. בדף האודות של היישום, הכרטיסים הרחבות ו-Functions מציגים את מספר ההרחבות והפונקציות הפעילות כעת ואת האזורים בחנות שבהם הן זמינות. כדי לראות היכן הן פעילות, יש להעביר את הסמן מעל שמות האזורים. לדוגמה: תשלום, חשבונות לקוח, חנות מקוונת או Point of Sale עבור הרחבות, ותשלום, הנחות, תשלומים או שילוח ומסירה עבור פונקציות.

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

אם אתה מפתח יישומים, עיין ב-dev docs של Shopify בנושא הרחבות וב-dev docs של Shopify בנושא Functions לקבלת תיעוד טכני.

הפעלת הרחבות ו-Functions

הפעלה והשבתה של הרחבות ו-Functions מתבצעות באזור של לוח המנהל של Shopify שבו נעשה בהן שימוש. מדף הרחבות או Functions בהגדרות היישום, לחץ על שם של הרחבה או Function כדי לנווט לאזור שבו ניתן לנהל אותה. לאחר הפעלת הרחבה או Function, היא תוצג כפעילה בדף האודות של היישום.

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

הרחבות

ניתן להפעיל הרחבות באזורים הבאים בלוח המנהל של Shopify:

Functions

ניתן להפעיל Functions באזורים הבאים בלוח המנהל של Shopify:

אירועי יישום מהרחבות

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

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

הסבר על תקינות ההרחבות

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

דגשים לגבי תקינות ההרחבות

לפני הצגת תקינות ההרחבות של יישום, יש לעיין בדגשים הבאים:

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

אופן הצגת תקינות ההרחבות

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

  • תקין: לא זוהו כשלי טעינה מתמשכים בהרחבה.
  • אזהרה: יותר מ-5% מטעינות ההרחבה ב-7 הימים האחרונים נכשלו, ושיעור הכשלים נשאר מעל 5% במשך 72 שעות.
  • קריטי: יותר מ-50% מטעינות ההרחבה ב-7 הימים האחרונים נכשלו, ושיעור הכשלים נשאר מעל 50% במשך 48 שעות.
  • אין מספיק נתונים: אין מספיק נתונים למדידת תקינות ההרחבה. מצב זה מוצג כשההרחבה נטענה פחות מ-10 פעמים ב-7 הימים האחרונים, או כשעדיין אין לגרסה הנוכחית שלה היסטוריה מספקת. התקינות נמדדת לכל גרסה של ההרחבה בנפרד, ולכן הרחבה שעודכנה לאחרונה עשויה להציג מצב זה עד שיצטברו בגרסה החדשה לפחות 7 ימי פעילות, גם אם היא נטענת לעיתים קרובות.

להרחבות יש גם דף פרטים שמציג את מצב התקינות ואת המדדים הבאים עבור 7 הימים האחרונים:

  • שיעור הכשלים: החלק היחסי של טעינות ההרחבה שנכשלו.
  • טעינות שנכשלו: מספר הפעמים שבהן טעינת ההרחבה נכשלה בגלל בעיה ביישום.
  • טעינות ההרחבה: מספר הפעמים שההרחבה נטענה.

בדיקת תקינות ההרחבה

  1. ב-Shopify Admin, יש לעבור אל הגדרות > יישומים.

  2. יש ללחוץ על היישום שרוצים לבדוק.

  3. יש ללחוץ על הרחבות.

  4. בכרטיסייה פעילות, יש לבדוק את העמודה תקינות עבור כל הרחבה לתשלום ולחשבונות לקוח.

  5. לא חובה: כדי להציג פרטים נוספים, יש ללחוץ על שם ההרחבה.

טיפול בכשלי טעינה של הרחבות

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

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

פתרון בעיות בשגיאות של Functions

אם מתרחשת שגיאה ב-Function, תוצג אזהרה בכרטיסייה Functions בדף האודות של היישום ובדף של Functions. הכרטיסייה מציגה שגיאות ב-[מספר] אזורים במקום הספירה הרגילה של האזורים הזמינים, והאזהרה מציינת מתי זוהו השגיאות האחרונות.

בדף Functions, פריטי Functions שיש בהם שגיאות יודגשו באמצעות הסמל Warning. אם יש שגיאות ב-Function, צור קשר עם מפתח היישומים לקבלת עזרה. במקרים מסוימים, ייתכן שהשגיאה כבר נפתרה. תוכל גם לשתף את יומני ה-Function כדי לעזור למפתח לפתור את הבעיה.