履单时间和费用

本教程将介绍以下内容:

  1. 简要说明支持哪些费用和履单时间用例
  2. 有关如何为服务 Feed 指定订单履单时间和费用的具体说明。
  3. 准确性预期

如需查看显示订单履单时间和费用用法的完整 Feed 示例,请参阅 Ordering Redirect 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"
    ]
  }
}

Range

{
  "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

在此示例中,2400slead_time 将在上午 11:00 到下午 1:30 之间显示。
1200slead_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"
            }
          }
        ]
      }
    }
  ]
}

费用和履单时间准确性

费用准确性

在为商家提供费用数据时,我们希望您准确提供费用信息。您应包含订单可能产生的所有运费和服务费。

我们知道,费用可能会随时间推移而变化,也可能会因用户而异。因此,我们提供了以范围(包括开口范围)指定费用的功能。如果费用可能会有很大差异,请确保提供的费用范围涵盖用户在交易期间可能会看到的费用。

如果您不确定自己的支持请求具体需要满足哪些要求,请与您的 Google 表单处理中心联系人联系。

订单履单时间准确性

我们理解,订单履单时间的具体情况会因各种因素而异。这些因素包括:

  • 订单履单时间因订单大小而异
  • 基于完成订购和结账所需时间对订单履单时间所做的更改
  • 通过 Feed 更新订单履单时间更改的时间延迟
  • 用户的送货地址。

上述任何因素都可能会导致向用户最初显示的订单履单时间与他们在结账时看到的确切履单时间不一致。实现履单时间的目标不是完全消除这些问题,而是尽可能经常向用户提供清晰的信息。

合作伙伴应尽最大努力提供实现,以便尽可能经常向用户显示准确的执行时间。如果由于这些因素导致时间存在很大差异,我们建议您提供涵盖这些差异的时间范围。 此外,如果订单详情确实导致履单时间发生变化,则应在用户进入订购流程时向其明确显示这一点。

如果您不确定具体需要满足哪些要求,请与您的 Action Center 联系人联系。

及时更新费用和预计到达时间

使用常规 Feed 上传功能进行的任何更改都可能需要至少 2 小时才能处理完毕。如果您打算经常更改预计送达时间,请务必注意这一点。

我们强烈建议合作伙伴实现实时更新,以便通过 API 调用在 5 分钟或更短的时间内更改服务 Feed(包括费用和预计到达时间)。