אינטגרציית Shopify

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

יכולות

• סנכרון אוטומטי - מוצרים, הזמנות ולקוחות מסתנכרנים בזמן אמת באמצעות webhooks
• שחזור עגלות נטושות - שמירת כתובות ה-checkout לשימוש בקמפיינים לשחזור
• מעקב בחנות וב-checkout - הפיקסל של Joryio עוקב אחרי צפיות בדפים, במוצרים ובקולקציות, חיפושים, העגלה וכל שלב ב-checkout, בלי קוד בערכת הנושא
• הודעות באתר - ה-app embed של Joryio מציג הודעות Joryio באתר בחנות
• לכידת אימייל - זיהוי קונים מה-checkout, מחשבון החנות שלהם ומטפסים בחנות
• ייחוס UTM - לכידה וייחוס של פרמטרי UTM שיווקיים
• תמיכה בכמה חנויות - חיבור כמה חנויות Shopify ופילוח האירועים לפי חנות

חיבור החנות

מתקינים את Joryio מ-Shopify, ואז מקשרים את החנות לסביבת העבודה שלכם ב-Joryio מתוך הניהול של Shopify. צריך חשבון Joryio - צוות Joryio מקים את החשבונות (קביעת הדגמה).

1. התקינו את Joryio מ-Shopify: דרך קישור ההתקנה שקיבלתם מ-Joryio, או בלחיצה על התקנת Joryio מ-Shopify בדף Shopify ב-Joryio (הגדרות → אינטגרציות → Shopify). Shopify מציגה את ההרשאות ש-Joryio מבקשת - מוצרים, הזמנות, לקוחות, checkouts, הנחות (לקופונים), וגם customer events ו-pixels (read_customer_events, write_pixels), שבעזרתן מתווסף הפיקסל של Joryio לחנות - ומאשרים אותן ב-Shopify
2. Shopify פותחת את Joryio בתוך הניהול של Shopify. חנות שעדיין לא קושרה מציגה החנות הזו עדיין לא מקושרת לחשבון Joryio
3. לחצו על יש לי חשבון - כניסה. Joryio נפתחת בכרטיסייה חדשה
4. היכנסו ל-Joryio. אם Joryio מבקשת את חשבון ה-Joryio שלכם, הזינו את שם החשבון מכתובת הכניסה שלכם (.../a/your-account)
5. בדף קישור חנות Shopify בחרו את סביבת העבודה לחנות ולחצו על קישור החנות לסביבת העבודה הזו. סביבת עבודה שאין לכם בה הרשאה לנהל אינטגרציות, או שכבר מחוברת אליה חנות Shopify אחרת, מופיעה עם הסיבה אבל אי אפשר לבחור בה
6. חזרו לכרטיסייה של הניהול ב-Shopify. תוך כמה שניות היא שואלת לקשר את החנות הזו ל-Joryio? ומציגה את שם סביבת העבודה ואת שם החשבון. בדקו אותם ולחצו על קישור החנות
7. הדף מציג את החיבור. Joryio מייבאת את המוצרים, ההזמנות והלקוחות, נרשמת לעדכונים של Shopify ומוסיפה את הפיקסל אוטומטית
8. הפעילו חלונות קופצים: לחצו על הפעלת Joryio בערכת העיצוב, ואז על שמירה ב-Shopify - ראו הפעלת חלונות קופצים

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

Joryio אף פעם לא מבקשת להקליד את כתובת החנות. אם פותחים את דף Shopify ב-Joryio לפני ש-Joryio הותקנה בחנות, מוצג התקנת Joryio מ-Shopify - מתקינים משם וממשיכים בשלב 2. כבר התקנתם? פתחו את Joryio מ-Apps בניהול של Shopify ולחצו על יש לי חשבון - כניסה.

איפה נשמרים נתוני החנות

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

פתיחת Joryio מ-Shopify

אפשר לפתוח את Joryio מ-Apps בניהול של Shopify בכל עת. בתוך הניהול מוצגים:

• חיבור ו-סנכרון אחרון - אותו מצב שמוצג בדף Shopify ב-Joryio
• הפיקסל של Joryio ו-חלונות קופצים בחנות, עם הפעלת Joryio בערכת העיצוב כל עוד החלונות הקופצים לא פועלים
• פתיחת Joryio - דף Shopify ב-Joryio, בכרטיסייה חדשה

חנות שנותקה מציגה חיבור מחדש - כניסה, שמריץ את אותם שלבי קישור.

חנויות שחוברו לפני ש-Joryio נפתחה בתוך Shopify

חנות שחוברה קודם מתוך Joryio (בהזנת דומיין החנות) נשארת מחוברת: מוצרים, הזמנות, עדכונים שוטפים והפיקסל ממשיכים לעבוד. בפעם הראשונה שמישהו פותח את Joryio מ-Apps בניהול של Shopify של החנות, Joryio מחדשת ברקע את הגישה שלה לחנות - Shopify דורשת גישה מהסוג הזה מכל אפליקציה החל מ-1 בינואר 2027. שום דבר אחר לא משתנה ואין מה לאשר ב-Joryio. פתחו את Joryio מ-Shopify פעם אחת לפני התאריך הזה.

הגדרות סנכרון

לאחר החיבור, הגדירו אילו נתונים לסנכרן:

הגדרה	תיאור	ברירת מחדל
סנכרון מוצרים	ייבוא מוצרים מ-Shopify	מופעל
סנכרון הזמנות	ייבוא הזמנות ועדכון סטטוסים	מופעל
סנכרון לקוחות	ייבוא נתוני לקוחות	מופעל
סנכרון עגלות	מעקב אחר עגלות נטושות	מופעל
ימים היסטוריים	ימי היסטוריית הזמנות לייבוא	60 (90 כשהחנות העניקה גישה לכל ההזמנות)

Shopify מחזירה רק את ההזמנות מ-60 הימים האחרונים, אלא אם החנות העניקה ל-Joryio גישה לכל ההזמנות. עד אז תקופה ארוכה יותר מקוצרת ל-60 ימים, והלשונית הגדרות מציינת זאת.

ההגדרות זמינות דרך הגדרות → אינטגרציות → Shopify → לשונית הגדרות.

מעקב בחנות

כשמחברים את החנות, Joryio מוסיפה אליה את הפיקסל של Joryio - אין מה להתקין. Shopify מריצה את הפיקסל בכל דף בחנות וגם בתוך ה-checkout, כך שגם שלבי ה-checkout נמדדים. אפשר לראות אותו בניהול Shopify תחת Settings → Customer events. כל אירוע נשמר בשמו הסטנדרטי (העמודה נשמר בשם) - אותו שם שבו משתמשות האינטגרציות של WooCommerce ו-Magento וה-SDKs:

אירוע	נשמר בשם	מתי הוא נשלח
צפייה בדף	Page Viewed	כל ביקור בדף, כולל דפי ה-checkout
צפייה במוצר	Product Viewed	דף מוצר, עם הווריאנט המוצג, המחיר ומצב המלאי: in_stock (true או false) ו-stock_status (in_stock או out_of_stock)
צפייה בקולקציה	Product List Viewed	דף קולקציה, עם category_id (מזהה הקולקציה) ו-category_name
חיפוש	Products Searched	חיפוש בחנות, עם מילות החיפוש ב-query
הוספה לעגלה	Product Added	כל הוספה לעגלה, עם הכמות
הסרה מהעגלה	Product Removed	מוצר שהוסר מהעגלה
צפייה בעגלה	Cart Viewed	דף העגלה, עם סכום העגלה והפריטים
התחלת checkout	Checkout Started	הקונה נכנס ל-checkout, עם הסכום והפריטים
שלב ב-checkout	Checkout Step Completed	הקונה השלים שלב ב-checkout: step הוא contact, address או shipping
פרטי תשלום	Payment Info Entered	הקונה שלח את פרטי התשלום
זיהוי	$identify	האימייל של הקונה, מה-checkout, מחשבון מחובר בחנות או מטופס בחנות

אירועי מוצר כוללים product_id, variant_id, quantity, price ו-currency. הזמנות אינן אירוע של הפיקסל: כל הזמנה מגיעה פעם אחת דרך ה-webhooks של ההזמנות ב-Shopify ונשמרת כ-Order Completed, כך שההכנסות לעולם לא נספרות פעמיים.

הודעות באתר והרשמות: ה-app embed

חלק מהיכולות צריכות לרוץ בדף החנות עצמו, ואת זה הפיקסל לא יכול לעשות. ה-app embed של Joryio טוען את ה-SDK של Joryio לווב בחנות, כך ש:

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

ב-Shopify רק בעל החנות יכול להפעיל app embed - ראו הפעלת חלונות קופצים. בהגדרות של ה-embed אפשר לכבות את ההודעות באתר או את לכידת האימייל מטפסים.

הפעלת חלונות קופצים

חלונות קופצים של Joryio (הודעות in-app) מופיעים בחנות רק אחרי שה-app embed של Joryio מופעל בערכת העיצוב. ב-Shopify רק בעל החנות יכול להפעיל אותו:

1. ב-אינטגרציות → Shopify → חיבור, אתרו את חלונות קופצים בחנות
2. לחצו על הפעלת Joryio בערכת העיצוב. Shopify פותחת את עורך ערכת העיצוב כש-Joryio כבר מופעל תחת App embeds
3. לחצו על שמירה

כדי לעשות זאת ידנית: ב-Shopify עברו אל Online Store → Themes → Customize → App embeds, הפעילו את Joryio ולחצו על שמירה. עושים זאת פעם אחת לכל ערכת נושא שמפרסמים.

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

הגדרות הודעות in-app

ה-embed טוען את ה-SDK מהכתובת https://sdk.joryio.com/web/1/joryio.min.js (הגרסה העדכנית ביותר של 1.x, אותו קובץ שהתוסף ל-WooCommerce והתוסף ל-Magento טוענים); קריאות הנתונים שלו נשלחות לשרת Joryio של החנות. בעורך ערכת העיצוב, ל-embed של Joryio יש את ההגדרות האלה:

הגדרה	ברירת מחדל	מה היא עושה
In-app messages	מופעל	מציג בחנות את הודעות ה-in-app שלכם מ-Joryio
Allow HTML in-app messages	מופעל	מציג גם הודעות שנבנו בעורך ה-HTML. הן מוצגות במסגרת מוגנת בחנות שלכם: סקריפטים שנכתבו בהן לא רצים, וההודעה לא יכולה לגשת לדפי החנות או לשלוח בקשות רשת משלה

שום דבר לא נספר פעמיים: ה-SDK חולק עם הפיקסל את מזהה המבקר האנונימי ולא שולח צפיות בדף או תחילות סשן משלו - אירועי הדפים והעגלה מגיעים מהפיקסל.

Web Push לא זמין ב-Shopify

התראות דפדפן צריכות service worker שמוגש מהכתובת של החנות עצמה, בשורש שלה (/joryio-sw.js). Shopify לא מאפשר לאפליקציה לשים קובץ שם: קבצי app embed מוגשים מה-CDN של Shopify, שהוא כתובת אחרת, ו-app proxy עונה רק תחת /apps/... (או /a, /community, /tools) ומסיר את הכותרת שהייתה מאפשרת ל-worker לכסות את כל החנות. לכן ל-embed אין מתג Web Push. Web Push עובד בחנויות WooCommerce ו-Magento.

פרטיות והסכמה

הפיקסל וה-app embed פועלים לפי באנר העוגיות של החנות (הגדרות Customer Privacy של Shopify). הם רצים רק אצל מבקרים שאישרו גם analytics וגם marketing, ומפסיקים לשלוח כשמבקר מבטל את ההסכמה. באזורים שבהם החנות לא מבקשת הסכמה, הם רצים אצל כל המבקרים.

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

חנויות שחוברו לפני אוקטובר 2026

בחנויות האלה הותקן סקריפט מעקב ש-Shopify תפסיק לטעון ב-1 במרץ 2027, ושמעולם לא רץ בתוך ה-checkout. הוא ממשיך לעבוד עד המעבר:

1. ב-אינטגרציות → Shopify → חיבור לחצו על אישור הרשאות חדשות
2. אשרו ב-Shopify את ההרשאות החדשות ל-customer events ול-pixels
3. בחזרה ב-Joryio, הפיקסל מתווסף והסקריפט הישן מפסיק לשלוח אירועים אוטומטית, כך ששום דבר לא נספר פעמיים
4. לחצו על הפעלת Joryio בערכת העיצוב כדי להפעיל את ה-app embed

אם Shopify מבקשת לאשר הרשאות חדשות כשאתם פותחים את Joryio מ-Apps בניהול של Shopify, אשרו אותן שם במקום זאת - Joryio מוסיפה אז את הפיקסל ומכבה את הסקריפט הישן.

הסקריפט הישן עצמו נשאר רשום בחנות עד ש-Shopify מסירה אותו: Shopify מוחקת אותו כשמסירים את האפליקציה, ומפסיקה לטעון אותו ב-1 במרץ 2027. Joryio לא מוחקת אותו - היא רק מפסיקה את שליחת האירועים ממנו.

ייחוס UTM

פרמטרים שיווקיים נלכדים אוטומטית:

• utm_source, utm_medium, utm_campaign
• utm_term, utm_content

פרמטרי ה-UTM נשמרים לאורך הביקור ומצורפים לאירועים שלו.

תמיכה בכמה חנויות

בעת חיבור כמה חנויות Shopify לאותה סביבת עבודה:

1. כל חנות מקבלת ישות App משלה עם SDK key ייחודי
2. כל האירועים מתויגים עם $app_id של החנות
3. סננו אירועים לפי $platform = 'shopify' או לפי $app_id מסוים
4. משתמשים יכולים להיות מקושרים בין חנויות באמצעות אימייל

זיהוי מבקרים לפי האימייל שהם מקלידים

את Recognise visitors by the email they type מגדירים ב-Joryio, תחת אינטגרציות → Shopify → הגדרות. ההגדרה מופעלת כברירת מחדל.

• מופעלת (ברירת מחדל) - אימייל שהמבקר מקליד בקופה או בטופס מזהה את הדפדפן שלו כאיש הקשר עם האימייל הזה: איש הקשר הקיים (זה שהיה פעיל לאחרונה, כשכמה אנשי קשר חולקים את האימייל - ראו בהמשך) או איש קשר חדש. הגלישה הקודמת של המבקר מצטרפת לאיש הקשר הזה, ולא נוצר איש קשר שני עם אותו אימייל. זה מה שרוב החנויות מצפות לו. המחיר: מי שמקליד אימייל של מישהו אחר מזוהה כאותו אדם בדפדפן הזה - למשל, הוא עלול לראות את הודעות ה-in-app והתוכן המותאם אישית של אותו אדם.
• כבויה (זהות קפדנית) - אימייל שהוקלד לעולם לא מזהה את הדפדפן. האימייל של אורח מגיע ל-Joryio עם ההזמנה, וההזמנה עוברת לאיש הקשר עם האימייל הזה. רק לקוח שמחובר לחנות מזוהה בדפדפן.

שינוי נכנס לתוקף תוך כמה דקות.

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

כשכמה אנשי קשר חולקים אימייל

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

איך נתוני החנות מעדכנים איש קשר

הזמנות, checkouts ועדכוני לקוחות מהחנות שלכם מעדכנים את איש הקשר המתאים ב-Joryio:

• טלפון - הזמנות ו-checkouts: הטלפון שקונה מקליד ב-checkout לעולם לא מחליף את הטלפון הקיים של איש קשר, גם כש-Shopify מקשרת את ההזמנה ללקוח - Shopify מצרפת checkout כאורח ללקוח הקיים עם האימייל שהוקלד, כך שהקישור לא מוכיח מי הקונה. הוא רק ממלא את הטלפון כשלאיש הקשר אין טלפון.
• טלפון - רשומת הלקוח ב-Shopify: עדכוני לקוחות מ-Shopify (וייבוא הלקוחות) מעדכנים את הטלפון של איש הקשר.
• השמות מגיעים מרשומת הלקוח ב-Shopify.
• מספר הלקוח בחנות: מספר הלקוח של Shopify על איש הקשר מגיע מרשומת הלקוח ב-Shopify (עדכוני לקוחות וייבוא הלקוחות), לעולם לא מהזמנה או מ-checkout. כשברשומת הלקוח יש אימייל אחר, המספר עובר לאיש הקשר עם האימייל הזה.
• ההזמנה שומרת את הטלפון שהוקלד ב-checkout בכתובת החיוב והמשלוח שלה, בלי קשר למה שקורה לאיש הקשר.
• הסכמה ל-SMS שניתנה ב-checkout עם מספר אחר מזה של איש הקשר לא רושמת את המספר של איש הקשר.
• דרכים אחרות לשנות את הטלפון של איש קשר: חשבון הלקוח בחנות, ה-SDK או ה-API מהאתר או מהאפליקציה שלכם (למשל אחרי שהאדם התחבר), ייבוא, או עריכת איש הקשר ב-Joryio.

Webhooks

האינטגרציה רושמת אוטומטית webhooks לעדכונים בזמן אמת:

• הזמנה נוצרה, עודכנה, בוטלה, סופקה
• Checkout נוצר, עודכן (עגלות נטושות)
• מוצר נוצר, עודכן, נמחק
• לקוח נוצר, עודכן

הציגו את ה-webhooks הרשומים דרך הגדרות → אינטגרציות → Shopify → לשונית Webhooks.

התאמה מתוזמנת

עדכונים חיים (webhooks) עלולים ללכת לאיבוד - למשל כשהחנות לא זמינה, או כשמשלוח נכשל יותר מדי פעמים. כל 6 שעות Joryio בודקת בחנות מה השתנה מאז הבדיקה הקודמת ומשלימה את מה שהעדכונים החיים פספסו: הזמנות (כולל החזרים וביטולים), לקוחות, מוצרים, וקופות נטושות מ-24 השעות האחרונות.

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

• הזמנה חסרה שבוצעה ב-24 השעות האחרונות נרשמת כאילו הגיעה בזמן אמת, כך שמסעות שאחרי רכישה עדיין מתחילים. הזמנה חסרה ישנה יותר, והחזר או ביטול של הזמנה ש-Joryio כבר הכירה, נרשמים בלי להתחיל מסעות; Order Refunded ו-Order Cancelled עדיין נרשמים פעם אחת בלבד כל אחד.
• כל חנות נבדקת בזמן משלה, כך שהחנויות לא נקראות כולן בבת אחת, ובדיקה אחת קוראת מספר מוגבל של שינויים; חנות עם יותר שינויים ממשיכה בתוך חצי שעה.
• חנויות מנותקות, בשגיאה או באמצע סנכרון מדולגות עד שהן מחוברות שוב.

התוצאה מוצגת ב-הגדרות → אינטגרציות → Shopify: התאמה אחרונה: 22/10/2026 12:00 - פריטים שהושלמו: 3. אם הבדיקות ממשיכות למצוא שינויים שלא הגיעו בזמן אמת, Joryio מעלה התראה Live updates from Shopify may be failing (פעמון, לוגים וניטור, ומייל למנהלי סביבת העבודה). הנתונים החסרים מושלמים בכל מקרה, אבל כדאי לבדוק את חיבור החנות: מסעות שמגיבים לשינויים האלה מתחילים באיחור.

באותו עמוד מוצגים האירוע האחרון שהתקבל - מתי עדכון חי מהחנות הגיע לאחרונה ל-Joryio (באיחור של דקה לכל היותר) - וסנכרון אחרון, המאוחר מבין הסנכרון המלא האחרון וההתאמה האחרונה. בחנות ששולחת עדכונים חיים, האירוע האחרון שהתקבל מתעדכן גם כשלא רץ סנכרון.

החזרים וביטולים

כל החזר ב-Shopify הופך לאירוע Order Refunded אחד (עם הסכום שהוחזר, הפריטים וההערה), וכל ביטול לאירוע Order Cancelled אחד, כך שמסע יכול להגיב להם. ראו אירועי החזר וביטול.

בקשות פרטיות מ-Shopify

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

הבקשה מ-Shopify	מה Joryio עושה	מה אתם עושים
לקוח ביקש את הנתונים שלו	מוצאת את איש הקשר לפי מזהה הלקוח ב-Shopify או לפי האימייל, ומתחילה ייצוא נתונים בדף Data Subject Requests	כשהייצוא מוכן, הורידו אותו ושלחו אותו ללקוח דרך Shopify, תוך 30 יום. אם ל-Joryio אין שום נתון על הלקוח, ההודעה אומרת זאת
לקוח ביקש שימחקו אותו	מתחילה מחיקה של איש הקשר (פרופיל, אירועים, הודעות; ההזמנות שומרות את הסכומים אבל מאבדות את השם, הכתובות, מזהה הלקוח ב-Shopify, הערת ההזמנה, קישור סטטוס ההזמנה, מספר המעקב והקישור לאיש הקשר) ומסירה פרטים אישיים מההזמנות ש-Shopify מציינת	כלום
נתוני החנות נמחקו (48 שעות אחרי הסרת האפליקציה)	מסירה את החיבור לחנות - ראו הסרת Joryio מ-Shopify	כלום. אם התקנתם את האפליקציה מחדש בתוך 48 השעות, Joryio משאירה את החנות מחוברת

הסרת Joryio מ-Shopify

כשמסירים את האפליקציה, Joryio מפסיקה לקבל נתונים מ-Shopify ומסירה את החיבור. אנשי הקשר והיסטוריית ההזמנות נשארים בסביבת העבודה שלכם ב-Joryio עד שתמחקו אותם או שלקוח יבקש שימחקו את הנתונים שלו; המוצרים מועברים לארכיון.

בפירוט, 48 שעות אחרי ההסרה (כש-Shopify מבקשת מ-Joryio להסיר את נתוני החנות):

• מוסר: החיבור לחנות וההרשאות שלו, עגלות נטושות ו-checkouts מהחנות.
• נשמר: אנשי הקשר, וההזמנות - עדיין מקושרות לאנשי הקשר שלהן ומסומנות כהזמנות מחנות שנותקה - כך שערך חיי הלקוח, RFM, סגמנטים וייחוס ממשיכים לעבוד, למשל אם תעברו ל-WooCommerce או ל-Magento.
• מועבר לארכיון: המוצרים של החנות. הזמנות קודמות עדיין מראות מה נקנה; מוצרים בארכיון אף פעם לא מומלצים, לא מוצעים בבחירות מוצרים ולא משמשים בהודעות על חזרה למלאי או על ירידת מחיר.

התקנה מחדש: התקינו את Joryio מקישור ההתקנה ופתחו אותה מ-Apps. הדף מציע שוב את שלבי הקישור - ראו חיבור החנות. קשרו את החנות לסביבת העבודה שבה הייתה קודם, כדי שאנשי הקשר והיסטוריית ההזמנות שלה יישארו יחד.

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

לאחר חיבור Shopify, לוח התקינות (ב-אינטגרציות → Shopify → חיבור) הוא המקום הראשון שכדאי לבדוק אם נתוני החנות מפסיקים להסתנכרן:

• פרטי חנות - השם, התוכנית, המטבע והדומיין העדכניים שנמשכים מ-Shopify. הצגתם מאשרת שטוקן הגישה עדיין תקף.
• סטטוס webhook - בלשונית Webhooks, כל נושא נדרש מוצג כרשום או כחסר. כפתור Re-register יוצר מחדש כל webhook חסר כדי לחדש את העדכונים בזמן אמת.
• מעקב בחנות - האם הפיקסל של Joryio פעיל, עם אישור הרשאות חדשות או רישום מחדש של המעקב כשהוא לא פעיל, והכפתור הפעלת Joryio בערכת העיצוב עבור ה-app embed. ראו מעקב בחנות.

אם נוצרו פערים בנתונים, רשמו מחדש את ה-webhooks החסרים בלשונית Webhooks, ואז הפעילו ידנית את סנכרן הכל כדי להשלים את החסר.

הסכמה לשיווק

Joryio קורא את ההסכמה לשיווק ש-Shopify שומרת על כל לקוח - הסכמת האימייל וה-SMS שהחנות אוספת בקופה, בטפסים ובממשק הניהול של Shopify - ומחיל אותה על המינוי של איש הקשר ב-Joryio:

ב-Shopify	ב-Joryio
Subscribed (אימייל או SMS)	איש הקשר נרשם לערוץ הזה. מי שביטל את המינוי לא נרשם מחדש - ראו את הטבלה שבהמשך; הוא יכול להירשם מחדש בעצמו דרך מרכז ההעדפות.
Unsubscribed	המינוי של איש הקשר לערוץ הזה מבוטל - אלא אם Joryio רשם שינוי מאוחר יותר לאיש הקשר (למשל, הוא נרשם בטופס של Joryio אחרי שביטל ב-Shopify).
Not subscribed, pending (הרשמה כפולה שעדיין ממתינה לאישור) או ללא הסכמה	אין שינוי.

• זה חל על הייבוא ההיסטורי, על כל עדכון של לקוח והזמנה, ועל ההתראות הייעודיות של Shopify על שינוי הסכמה.
• בהזמנה שהלקוח שלה לא נושא הסכמה, נספרת תיבת השיווק בקופה: סימון רושם, תיבה לא מסומנת לא משנה דבר.
• כל שינוי נרשם בהיסטוריית המינוי של איש הקשר עם המקור (shopify_customer או shopify_checkout), רמת ההסכמה של Shopify (יחידה או מאושרת) והזמן ש-Shopify רשמה את השינוי.
• שינוי הסכמה שמגיע עם הזמנה חדשה או מעודכנת רושם גם את כתובת ה-IP של הקונה ש-Shopify שמר בהזמנה (כתובת ה-IP של הדפדפן), שמוצגת רק לחברי צוות שמורשים לראות מידע אישי. הייבוא ההיסטורי והתראות ההסכמה של לקוחות מ-Shopify לא נושאים כתובת IP - Shopify לא מספק אותה.
• כתובת שנמצאת ברשימת החסימה (החזרה, או ביטול מינוי שנרשם על איש קשר אחר) לא נרשמת.
• Joryio לא כותב הסכמה בחזרה ל-Shopify: ביטול מינוי ב-Joryio לא משנה את רשימת הלקוחות שלך ב-Shopify.

מה עושים הסכמה או ביטול מחנות

מה החנות שולחת	מה Joryio עושה
סימון הסכמה ב-checkout של אורח	רושם איש קשר שעדיין אין לו מינוי בערוץ הזה. אלא אם ההגדרה של החנות שלמטה מופעלת, לעולם לא רושם מחדש מי שביטל את המינוי - ב-checkout כאורח כל אחד יכול להקליד כל כתובת אימייל.
כל הסכמה אחרת מ-Shopify, כולל של לקוח שיש לו חשבון בחנות	כמו סימון של אורח: אלא אם ההגדרה שלמטה מופעלת, לעולם לא רושמת מחדש מי שביטל את המינוי. Shopify משייכת checkout של אורח ללקוח הקיים עם אותו אימייל ולא מודיעה ל-Joryio אם הקונה היה מחובר, כך ש-Joryio לא יכולה להבחין בין בעל החשבון לבין מי שהקליד את האימייל שלו. (WooCommerce ו-Magento כן מודיעות על כך - ראו את הדפים שלהן.)
הסכמה ב-checkout או ברשומת הלקוח, כשההגדרה לאפשר לסימון הסכמה בקופה לרשום מחדש אנשים שהסירו את עצמם מופעלת (כבויה כברירת מחדל)	רושם מחדש איש קשר שביטל את המינוי - גם אחרי checkout כאורח - כשהזמן שהחנות רשמה להסכמה מאוחר מהביטול האחרון שלו. הסיכון: Shopify לא מודיעה ל-Joryio אם הקונה היה מחובר, כך שמי שמקליד בקופה את האימייל של אדם אחר יכול לרשום אותו מחדש; תמיד אפשר לבטל שוב בלחיצה אחת. המקרים שלמטה שלעולם לא מתבטלים עדיין חלים.
תיבה לא מסומנת	אין שינוי - זה אף פעם לא ביטול מינוי.
ביטול בחנות	מבטל את המינוי, אלא אם Joryio תיעדה שינוי מאוחר יותר לאיש הקשר הזה.
לעולם לא מתבטל בהסכמה מחנות, כשההגדרה מופעלת או כבויה	תלונת ספאם, החזרה קשה (hard bounce), חסימה ברמת הארגון, סביבת עבודה אחרת, ביטול שנרשם באיש קשר אחר עם אותו אימייל או טלפון, ו-STOP ב-SMS.

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

חנויות שחוברו לפני אוקטובר 2026

ההתראות על שינוי הסכמה נרשמות ב-Sync All או ב-Re-register הבאים. עד אז ההסכמה עדיין מגיעה עם כל עדכון של לקוח והזמנה.

שחזור עגלות נטושות

כאשר לקוח נוטש את העגלה:

1. כתובת ה-checkout נלכדת
2. ערך העגלה והפריטים נשמרים
3. אימייל הלקוח (אם נלכד) מקושר

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

פתרון בעיות

מוצרים/הזמנות לא מסתנכרנים

• ודאו שהסנכרון מופעל בלשונית הגדרות
• ודאו שה-webhooks רשומים בלשונית Webhooks
• נסו לבצע סנכרון ידני באמצעות כפתור "סנכרן הכל"

"Shopify has not approved this app's access to protected customer data"

• Shopify מוסרת נתוני לקוחות (לקוחות, ופרטי הלקוח בהזמנות) רק לאפליקציות שאושרו לנתוני לקוחות מוגנים. עד אז Shopify מסרבת לקריאות האלה, ו-Last Error בעמוד האינטגרציה מציין את האובייקט שנדחה
• את האישור מבקש מפתח האפליקציה ב-Shopify Dev Dashboard (או ב-Partner Dashboard): האפליקציה -> API access -> Protected customer data. אחרי האישור לחצו Sync All
• ישות אחת שנדחתה לא עוצרת את השאר: מוצרים, הזמנות וקופות נטושות ממשיכים להסתנכרן, וה-webhooks (הזמנות ועגלות בזמן אמת) נרשמים לפני שהסנכרון מתחיל. הסטטוס נשאר Error עד שסנכרון מסתיים ללא שגיאות, ו-Last Sync מציג את הסנכרון האחרון שהסתיים כך
• עמוד Joryio בתוך ניהול Shopify מציג את אותו סטטוס עם סיבה קצרה

הפיקסל לא פעיל

• מוצג אישור הרשאות חדשות: החנות עדיין לא אישרה את הרשאות הפיקסל - ראו חנויות שחוברו לפני אוקטובר 2026
• מוצגת שגיאה: לחצו על רישום מחדש של המעקב. אם היא נשארת, ההודעה מ-Shopify מסבירה למה
• בדקו בניהול Shopify, תחת Settings → Customer events: הפיקסל של Joryio אמור להופיע כמחובר

אימייל לא נלכד

• כתובות אימייל מה-checkout מגיעות דרך ה-webhooks של ה-checkout וההזמנות
• טפסים בחנות וחשבונות מחוברים דורשים שה-app embed יהיה מופעל - ראו ה-app embed
• מבקר שלא אישר analytics ו-marketing אינו נמדד

בעיות חיבור

• ודאו שלאפליקציית Shopify יש את ההרשאות הנדרשות
• פתחו את Joryio מ-Apps בניהול של Shopify. חנות שנותקה מציגה חיבור מחדש - כניסה, שמקשר אותה שוב - ראו פתיחת Joryio מ-Shopify

צפיות במוצרים או הוספה לעגלה חסרות

• הפיקסל רץ בערכות נושא של Online Store וב-checkout של Shopify. חזית headless (Hydrogen או חזית מותאמת אחרת) עשויה לא להריץ פיקסלים של אפליקציות - שלחו אירועים עם Web SDK במקום
• מבקרים שדחו עוגיות analytics או marketing אינם נמדדים
• צפיות במוצרים קוראות את מצב המלאי מהכתובת /products/<handle>.js של החנות. אם ערכת נושא או אפליקציה חוסמות את הכתובת הזו, הצפיות במוצרים מגיעות בלי מצב המלאי