דלג לתוכן הראשי

אינטגרציית Magento

חברו את חנות ה-Magento 2 שלכם באמצעות התוסף Joryio Connect. סנכרנו מוצרים, הזמנות, לקוחות ועגלות, עקבו אחר התנהגות המשתמשים בחנות ושחזרו עגלות נטושות.

יכולות​

  • תוסף מותקן דרך Composer - מודול Magento 2 מקורי, ללא צורך ב-OAuth
  • סנכרון אוטומטי - מוצרים, הזמנות, לקוחות ועגלות מוזרמים ל-Joryio מדי דקה
  • ייבוא היסטורי - מוצרים, לקוחות והזמנות קיימים (90 הימים האחרונים כברירת מחדל) מיובאים בעת החיבור
  • שחזור עגלות נטושות - זיהוי עגלות נטושות ושליחת קישורי שחזור שמחזירים את העגלה
  • מעקב בחנות - צפיות בדפים ובמוצרים, הוספה לעגלה ואירועי checkout
  • זיהוי לקוחות - זיהוי אוטומטי של לקוחות בעת התחברות, הרשמה לניוזלטר ו-checkout
  • ייחוס הכנסות - הזמנות מיוחסות לקמפיין או למסע שהוביל אליהן
  • טריגרים בקטלוג - עדכוני מלאי ומחיר מזינים טריגרים של חזרה למלאי וירידת מחיר

דרישות מקדימות​

  • Magento Open Source או Adobe Commerce 2.4.x
  • גישה לשורת הפקודה בשרת ה-Magento שלכם עם Composer
  • Magento cron מוגדר ופועל - התוסף שולח אירועים באמצעות cron, ולכן זו דרישה הכרחית
  • גישת HTTPS יוצאת משרת ה-Magento שלכם אל Joryio

שלבי הגדרה​

שלב 1: קבלת כתובת השרת ומפתח ה-API​

  1. ב-Joryio, עברו אל הגדרות → אינטגרציות → Magento
  2. העתיקו את כתובת השרת (Server URL)
  3. לחצו על צור מפתח API והעתיקו את המפתח (מתחיל ב-jry_mg_)

שלב 2: התקנת התוסף​

הורידו את קובץ ה-zip של התוסף (joryio-connect-magento2.zip) באמצעות כפתור הורד תוסף בעמוד אינטגרציית Magento בלוח הבקרה, חלצו אותו, ואז הריצו את הפקודות הבאות מתיקיית השורש של Magento:

composer config repositories.joryio path /path/to/joryio-connect
composer require joryio/module-connect
bin/magento module:enable Joryio_Connect
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

לחלופין (ללא composer): חלצו את ה-zip לתיקייה app/code/Joryio/Connect והריצו את אותן פקודות bin/magento.

שלב 3: חיבור​

  1. בממשק הניהול של Magento, עברו אל Stores → Configuration → Joryio
  2. הדביקו את כתובת השרת ואת מפתח ה-API משלב 1
  3. לחצו על התחבר (Connect)

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

בסיום, הסטטוס מחובר מוצג גם בעמוד הניהול של Magento וגם בלוח הבקרה של Joryio.

מה מסתנכרן​

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

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

מעקב בחנות​

התוסף מוסיף סקריפט מעקב קל לחנות שלכם (מופעל כברירת מחדל - אפשר לכבות אותו דרך Stores → Configuration → Joryio). הוא עוקב אחר:

אירועתיאור
צפייה בדףכל ביקור בדף
צפייה במוצרכאשר נצפה דף מוצר
הוספה לעגלהפריטים שנוספו לעגלה
תחילת Checkoutכאשר מתחיל תהליך checkout
זיהוילכידת אימייל

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

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

  1. התוסף עוקב אחר העגלות בזמן שהלקוחות קונים
  2. לאחר 60 דקות של חוסר פעילות (ניתן להגדרה), העגלה מסומנת כנטושה
  3. Joryio מקבלת את העגלה יחד עם כתובת URL לשחזור
  4. השתמשו במסע כדי לשלוח הודעות שחזור הכוללות את קישור השחזור

כאשר לקוח לוחץ על קישור השחזור (https://your-store.com/joryio/cart/restore?token=...), העגלה שלו משוחזרת עם כל הפריטים, והוא יכול להשלים את הרכישה מיד.

פתרון בעיות​

אירועים תקועים / שום דבר לא מגיע ל-Joryio​

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

  • ודאו ש-cron מוגדר: bin/magento cron:install (או בדקו את ה-crontab שלכם)
  • הריצו אותו ידנית לבדיקה: bin/magento cron:run
  • בדקו את var/log/joryio.log בתיקיית השורש של Magento כדי לאתר שגיאות בשליחה

"מפתח API לא תקין" / חוסר התאמה במפתח​

  • המפתח חייב להתחיל ב-jry_mg_ ולהתאים למפתח המוצג כעת ב-הגדרות → אינטגרציות → Magento ב-Joryio
  • יצירת מפתח חדש מבטלת את הישן - הדביקו מחדש את המפתח העדכני בממשק הניהול של Magento ולחצו שוב על התחבר
  • ודאו שוב שכתובת השרת הועתקה במדויק

נתונים היסטוריים חסרים​

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

המעקב לא עובד​

  • בדקו שסקריפט המעקב מופעל ב-Stores → Configuration → Joryio
  • הריצו bin/magento cache:flush לאחר שינוי ההגדרה (full-page cache עלול להציג דפים ישנים מהמטמון)
  • ודאו שהסקריפט נטען בכלי הפיתוח של הדפדפן