מדריך להטמעת PickUP Plug באתרי eCommerce
פתרון פשוט ונוח לבחירת נקודת איסוף עצמי למשלוח.
בעת ביצוע התשלום ע"י הלקוח, תוצג בפניו אפשרות לאיסוף חבילה בשירות PickUP.
עם הגעת החבילה לנקודה שנבחרה תישלח ללקוח הודעת SMS המודיעה לו כי החבילה ממתינה עבורו בנקודה.
תהליך ההטמעה כולל 4 שלבים עיקריים אותם יש לחבר לתהליך הרכישה של מוצר באתר:
- כפתור Pickup
- התקנת קוד Javascript
- קבלת נתוני נקודה מוחזרת
- הגדרת מיקום גיאוגרפי (ברירת מחדל)
- נסו בעצמכם
כפתור Pickup
על מנת ליצור את הכפתור, יש להעתיק את קוד ה-HTML למקום המיועד:
<div onclick="window.PickupsSDK.onClick();return;" class="ups-pickups ups-pickups-48" ></div><div class="ups-pickups-info"></div>
התקנת קוד Javascript
הטמעת קוד ה-JavaScript ב-Header של העמוד.
את המילה TYPE יש להחליף באחת משלושת האופציות הרלוונטיות:
- all
- stores
- lockers
(function ()
{
var pkp = document.createElement('script');
pkp.type = 'text/javascript'; pkp.async = true;
pkp.src = 'https://pickuppoint.co.il/api/ups-pickups.sdk.TYPE.js';
document.getElementsByTagName('head')[0].appendChild(pkp);
})();
קבלת נתוני נקודה מוחזרת
על מנת לקבל את הפרטים על נקודת האיסוף שנבחרה, יש להירשם על Javascript Event בשם pickups-after_choosen שמחזיר את הנתונים לדף בפורמט JSON
document.body.addEventListener( 'pickups-after-choosen', function(e, data) { var pointDetails = e.originalEvent ? e.originalEvent.detail :e.detail; });
להלן דוגמה של נתונים של נקודת האיסוף:
{ "lat": 31.2651562, "lng": 34.798197, "title": "פיקאפ BGPC מחשבים וסלולר ", "street": "יצחק רגר 112", "city": "באר שבע", "zip": "סניף האוניברסיטה.שעות פתיחה: א'-ה' 09-19 ו' 09-13", "iid": "PKPS627728", "dist": "0.69", "stat": true }
הגדרת מיקום גיאוגרפי (ברירת מחדל)
נקודת ברירת מחדל תיקבע ע"י רישום על – Javascript Event הנקרא pickups-before-open, ובאחת משלושת הדרכים הבאות:
- הזנת קואורדינטות לפי Google Maps
- הזנת כתובת לפי עיר, רחוב ומספר בית
- נקודת GPS של המשתמש
- במידה ולא יושמו סעיפים 1 עד 3, תיפתח המפה ללא מיקום ברירת מחדל
document.body.addEventListener('pickups-before-open', function () { var defLocation = new Object(); defLocation.location = new Object(); defLocation.location.lat = 31.255670; defLocation.location.lng = 34.801147; var json = JSON.stringify(defLocation); window.PickupsSDK.setDefaults(json); });
*במידה והקואורדינטות שגויות ו/או מחוץ לגבולות ישראל (עפ"י הגדרת Google Maps), תילקח נקודה המוגדרת בסעיף 2, ע"י הזנת כתובת.
document.body.addEventListener('pickups-before-open', function () { var defLocation = new Object(); defLocation.location = new Object(); defLocation.location.city = "באר שבע"; defLocation.location.street = "וינגייט"; defLocation.location.house = "59"; var json = JSON.stringify(defLocation); window.PickupsSDK.setDefaults(json); });
*במידה והכתובת בסעיף 2 שגויה ו/או מחוץ לגבולות ישראל (עפ"י הגדרת Google Maps), תילקח נקודה המוגדרת בסעיף 3, ע"י GPS.
document.body.addEventListener('pickups-before-open', function () { window.PickupsSDK.setDefaults(); });
*במידה וקיימת בעייה עם איתור נקודת GPS, לא תיבחר נקודת התחלה בדומה לסעיף 4
נסו בעצמכם
הגדירו נקודת התחלה, לחצו על הכפתור "בחר נקודת איסוף", בחרו נקודה וצפו בתוצאה המוחזרת
בחר נקודת התחלה