במדריך הזה נסביר:
- תיאור כללי של תרחישי השימוש הנתמכים בנושא עמלות וזמני אספקה
- הוראות ספציפיות לציון זמן הטיפול בהזמנה ועמלות עבור פידים של שירותים.
- מהי רמת הדיוק הצפויה
דוגמה מלאה של פיד שכוללת את השימוש בזמן הטיפול בהזמנה ובעלויות זמינה בדוגמה של EPA להפניה להזמנה.
עמלות
אנחנו מספקים כמה דרכים שונות להגדרת עמלות, למשל:
- תשלום קבוע: 'דמי משלוח 5$' או 'דמי שירות 5$'
- עמלה באחוזים: "דמי משלוח 5%" או "עמלת שירות 5%"
- טווח עמלות: 'עמלות משלוח 2$-10$' או 'עמלות שירות 3%-6%'
- טווחים פתוחים: "דמי משלוח החל מ-5%" או "עמלות שירות עד 20$"
אפשר לציין את העמלות כדמי משלוח או כדמי שירות. אפשר גם לציין כמה עמלות (למשל, 'עמלת שירות 5%-10%, עמלת משלוח 5$').
לא נתמכים תרחישי שימוש שבהם העמלות משתנות בהתאם למידע על המשתמש.
דוגמאות לעמלות
דמי משלוח ואיסוף עצמי
האפליקציה תומכת בסוגי העמלות `DELIVERY` ו-`SERVICE`.משלוח
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
שירות
{ "fee": { "fee_id": "12345/service_fee", "fee_type": "SERVICE", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
סוגים שונים של עמלות
בהמשך מפורטות כמה דוגמאות קלות לשימוש להגדרת סוג עמלה נבחר.קבוע
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "fixed_amount": { "currency_code": "USD", "units": 10, "nanos": 0 }, "service_ids": ["service/entity002"] } }
אחוז עגלות הקניות
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "cart_percentage": { "base_value": { "currency_code": "USD", "units": 3, "nanos": 500000000 }, "percentage_of_cart_value": 10 }, "service_ids": [ "service/entity002" ] } }
טווח
{ "fee": { "fee_id": "12345/delivery_fee", "fee_type": "DELIVERY", "range_amount": { "min_amount": { "currency_code": "USD", "units": 3, "nanos": 500000000 }, "max_amount": { "currency_code": "USD", "units": 5, "nanos": 600000000 } }, "service_ids": [ "service/entity002" ] } }
ימי אספקה
כדי לוודא שאתם מספקים נתונים מדויקים, אנחנו מאפשרים לציין את שעות הפעילות בכמה פורמטים שונים. בנקודות הבאות מתוארים תרחישי השימוש השונים שנתמכים, וגם כמה דוגמאות לשפה שדומה למה שהמשתמש יראה בחלק החזיתי.
- זמנים קבועים: "Delivers in 30 min" או "Pickup in 15 min"
- טווח זמנים: "משלוח תוך 30 דקות עד שעה" או "איסוף תוך 15-20 דקות"
אפשר לציין את זמן הטיפול במשלוח גם לאיסוף וגם למשלוח באמצעות פורמט משותף (שמתואר בהמשך).
לא נתמכים תרחישי שימוש שבהם נדרש שינוי של זמני ההגעה המשוערים על סמך מידע על המשתמש.
דוגמאות לזמני אספקה
זמן הטיפול בהזמנה לקישורים לפעולה כלול בהודעה של פיד השירותים ETA, כחלק מהשדה FoodOrderingService.
קבוע
{ "service": { "service_id": "service-id", "service_type": "TAKEOUT", "parent_entity_id": "entity-id", "lead_time": { "min_lead_time_duration": "900s" }, "action_link_id": "action-link-id" } },
טווח זמן
{ "service": { "service_id": "service-id", "service_type": "TAKEOUT", "parent_entity_id": "entity-id", "lead_time": { "min_lead_time_duration": "900s" "max_lead_time_duration": "1200s" }, "action_link_id": "action-link-id" } },
חלונות זמן לאספקה
באמצעות ServiceHours, אפשר להגדיר זמני אספקה לחלון זמן ספציפי. ברירת המחדל של
lead_time שמוגדרת ב-FoodOrderingService משמשת
מחוץ לחלונות הזמן של שעות השירות.
lead_time של
2400s תוצג מ-11:00 עד 13:30.
ה
lead_time של 1200s יוצג לפני 11:00 ואחרי 13:30.
{ "data": [ { "service": { "service_id": "merchant-1-service-delivery", "service_type": "DELIVERY", "parent_entity_id": "merchant-1", "lead_time": { "min_lead_time_duration": "1200s" }, "action_link_id": "merchant-1-takeout-delivery-action" } }, { "service_hours": { "hours_id": "merchant-1-advance-hours-delivery", "service_ids": ["merchant-1-service-delivery"], "asap_hours": [ { "time_windows": { "time_windows": { "open_time": { "hours": 11 }, "close_time": { "hours": 13, "minutes": 30 } } }, "lead_time": { "min_lead_time_duration": "2400s" } } ] } } ] }
דיוק העמלות וזמני האספקה
דיוק העמלות
כשאתם מספקים נתוני עמלות של מוֹכרים, אנחנו מצפים שתספקו ייצוג מדויק של העמלות שלכם. חשוב לכלול את כל עמלות המשלוח והשירות שעשויות לחול על הזמנה.
אנחנו מבינים שהעמלות עשויות להשתנות לאורך זמן ובין משתמשים שונים. לכן אנחנו מאפשרים לציין עמלות כטווחים, כולל טווחים פתוחים. במקרים שבהם העמלות עשויות להשתנות באופן משמעותי, חשוב לוודא שהטווח שציינתם כולל את העמלות שהמשתמש עשוי לראות במהלך העסקה.
אם אתם לא בטוחים מה בדיוק נדרש במקרה שלכם, אתם יכולים לפנות לאיש הקשר שלכם ב-Actions Center.
דיוק מועד הטיפול בהזמנה
אנחנו מבינים שהפרטים של זמן אספקת ההזמנה משתנים בהתאם למגוון גורמים. הגורמים האלה כוללים:
- שינויים בזמן הטיפול בהזמנה על סמך גודל ההזמנה
- שינויים בזמן אספקת ההזמנה על סמך הזמן שנדרש להשלמת ההזמנה ולסיום הקנייה
- השהיה בין הרגע שבו מתעדכנים שינויים בזמן הטיפול בהזמנה דרך פידים
- הכתובת למשלוח של המשתמש.
כל אחד מהגורמים האלה עלול לגרום למצב שבו הזמן שמוצג למשתמש בהתחלה לא יהיה הזמן המדויק שיוצג לו בדף התשלום. המטרה של הטמעת זמן האספקה היא לא למנוע את המקרים האלה לחלוטין, אלא לספק למשתמשים מידע ברור כמה שיותר פעמים.
השותפים נדרשים לספק הטמעה שתאפשר להציג למשתמשים את זמן האספקה המדויק כמה שיותר פעמים, על בסיס המאמץ הטוב ביותר. אם יש שונות משמעותית בתזמון בגלל הגורמים האלה, מומלץ לציין טווח של זמנים שכולל את השונות הזו. בנוסף, אם זמן האספקה משתנה בגלל פרטי ההזמנה, צריך להציג את זה בבירור למשתמשים כשהם מגיעים לתהליך ההזמנה.
אם אתם לא בטוחים מה בדיוק נדרש במקרה שלכם, אתם יכולים לפנות לאיש הקשר שלכם ב-Actions Center.
עדכונים בזמן אמת לגבי עמלות וזמני הגעה משוערים
כל שינוי שמתבצע באמצעות העלאה רגילה של פיד יכול להימשך לפחות שעתיים. חשוב במיוחד לשים לב לזה אם אתם מתכננים לשנות את זמני ההגעה המשוערים לעיתים קרובות.
מומלץ מאוד לשותפים להטמיע עדכונים בזמן אמת, שמאפשרים לבצע קריאה ל-API כדי לשנות את פיד השירותים (כולל עמלות וזמני הגעה משוערים) תוך 5 דקות או פחות.