本教程将逐步介绍以下内容:
- 对支持哪些费用和履单时间用例的简要说明
- 关于如何为 Service Feed 指定订单履行时间和费用的具体说明。
- 对准确性的期望
如需查看展示履单时间和费用使用情况的完整 Feed 示例,请参阅订单重定向 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" ] } }
履单时间
我们允许使用多种不同格式来指定可用时间,以确保您提供准确的数据。以下几点介绍了支持的不同用例,以及一些类似于用户在前端看到的示例语言。
- 固定时间:“30 分钟后送达”或“15 分钟后取货”
- 时间范围:“30 分钟 - 1 小时内送达”或“15-20 分钟后取货”
您可以使用通用格式(如下所述)为自提和送货指定履单时间。
不支持需要根据用户信息更改加大型文字广告的用例。
履单时间示例
操作链接的订单履行时间包含在服务 Feed 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
时,可以为特定时间范围设置履单时间。当非服务时间窗口时,系统会使用 FoodOrderingService
中设置的默认 lead_time
。
2400s
的 lead_time
将在上午 11:00 到下午 1:30 之间显示。1200s
的 lead_time
将在上午 11:00 之前和下午 1: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" } } ] } } ] }
费用和履单时间准确性
费用准确性
为商家提供费用数据时,我们希望您能准确说明自己的费用。您应将可能适用于某个订单的所有送货和服务费都包含在内。
我们理解,费用可能因用户而异,并可能因用户而异。因此,我们提供了以范围(包括开放式范围)的形式指定费用的功能。如果费用可能会有很大差异,请确保所提供的范围包含用户在交易期间可能会看到的费用。
如果您不确定具体需要什么,请与您的操作中心联系人联系。
订单履行时间准确性
我们知道,具体履单时间会因各种因素而异。这些因素包括:
- 根据订单大小更改订单履行时间
- 根据完成订购和结账的时间,对订单履行时间进行了更改
- 通过 Feed 更新履单时间变更之间的延迟时间
- 用户的送货地址。
这些因素中的任何一个都可能导致最初向用户显示的订单履单时间与他们在结账时看到的确切履单时间不一致。实现执行时间的目标不是完全消除这些状态,而是尽可能多地向用户提供清晰的信息。
合作伙伴应提供相应的实现方案,确保尽可能经常地向用户显示准确的履单时间。如果这些因素导致时间出现显著变化,我们建议您提供包含该变化的时间范围。此外,如果履单时间因订单详情而发生变化,在到达您的订购流程中时,应向用户明确显示此信息。
如果您不确定自己的具体需要什么,请与您的操作中心联系人联系。
及时更新费用和预计到达时间
通过普通 Feed 上传进行的任何更改都可能需要至少 2 个小时才能处理完毕。如果您计划频繁更改加大型文字广告,请务必注意这一点。
强烈建议合作伙伴实现实时更新,以便 API 调用在 5 分钟内更改服务 Feed(包括费用和预计到达时间)。