履单时间和费用（仅限旧版）

本教程将介绍以下内容：

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

如需查看显示订单履单时间和费用用法的完整 Feed 示例，请参阅 Ordering Redirect EPA 示例。

费用和履单时间用例

费用用例

我们提供了多种不同的费用指定方式。以下几点介绍了支持的不同用例，以及一些类似于用户在前端看到的语言示例。

  • 固定费用：“运费 5 美元”或“服务费 5 美元”
  • 百分比费用：“配送费 5%”或“服务费 5%”
  • 费用范围：“运费 2 美元到 10 美元”或“服务费 3%-6%”
  • 开口范围：“配送费最低 5%”或“服务费最高 20 美元”

如上例所示，费用可以指定为运费或服务费。 您还可以指定多种费用（例如“服务费 5%-10%，运费 5 美元”）。

不支持需要全天更新费用或根据用户信息进行更改的用例。

Fulfillment Time 用例

我们允许使用多种不同的格式来指定播出时间，以帮助确保您提供准确的数据。以下几点介绍了支持的不同用例，以及一些类似于用户在前端看到的语言示例。

  • 固定时间：“30 分钟送达”或“15 分钟自提”
  • 时间范围：“30 分钟至 1 小时送达”或“15 至 20 分钟自提”
  • 开放式时间范围：“送货时间超过 10 分钟”或“自提时间不到 1 小时”

您可以使用常见格式（如下所述）为自提和送货指定履单时间。如上例所示，向用户显示的文本将反映操作链接中指定的执行方式。

不支持需要全天更新时间或根据用户信息进行更改的用例。

通过 Feed 指定订单履单时间

操作链接的订单履单时间包含在商家 Feed 的 action_link 消息中，作为 food_ordering_metadata 字段的一部分。对于与商家关联的每个 action_link，您都必须使用其中一个消息路径提供履单信息。

固定履单时间

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

此消息应采用以下格式：

{
  "fulfillment_lead_time_duration": {
    "seconds" : 1800
  }
}

范围履单时间

  • Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

此消息应采用以下格式：

{
  "fulfillment_lead_time_duration_range": {
    "min_duration": {
       "seconds" : 1800
     },
    "max_duration": {
     "seconds" : 2400
    }
  }
}

通过 Feed 指定费用

与订单履单时间类似，费用可以包含在 action_link 消息的 food_ordering_metadata 字段下。对于与商家关联的每个 action_link，您都可以使用消息路径提供费用信息：

merchant.action_link.food_ordering_metadata.fee_details

以下是不同用例的几个示例。
  • 固定配送费为 1.99 美元： 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]
  • 配送费百分比为 5.6%。 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]
  • 服务费介于 1.99 美元到 9.99 美元之间 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount_range": {
        "min_amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        },
        "max_amount": {
          "currency_code": "USD",
          "units": "9",
          "nanos": "990000000"
        }
      }
    }
  }
]
  • 服务费百分比介于 1.2% 到 2.7% 之间 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]
  • 两项费用，服务费为 5 美元，运费为 1.2%。 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]

费用和履单时间准确性

费用准确性

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

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

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

订单履单时间准确性

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

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

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

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

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