借助订单跟踪信号，您可以向 Google 提供通过商家网站完成的订单的历史订单跟踪数据。这样一来，买家就能获得更精确、更准确的运费估算值。订单跟踪信号还可让您通过“免费快速配送”注释来提升商品详情的效果。
您可以提交通过商家网站完成的订单的数据。您提交的数据可补充您在 Merchant Center 账号设置过程中提供的配送配置信息。例如，如果您向买家提供的预计送达时间为 3-7 天，但您最近的历史订单跟踪数据显示，在某些地区，订单通常会在 3 天内送达，那么 Google 可以更新您的商品详情，以便为客户提供更准确的预计送达时间。
本指南介绍了如何使用 ordertrackingsignals 服务提交历史订单跟踪数据。
使用 ordertrackingsignals 服务
ordertrackingsignals 服务包含一个 create 端点，您可以通过该端点提交历史订单跟踪数据。仅提交已送达订单的数据，以便我们验证配送时间。您可以在每个请求中提交一个订单。您可以在请求正文中提交以下信息：
- 订单信息，包括订单 ID、订单创建时间、收货地邮政编码和区号
- 向买家收取的运费 (
customer_shipping_fee) - 配送信息 (
shippingInfo)，包括订单所关联的每个运单的运输公司、跟踪信息、发货地、目的地和配送时间 - 订单项信息 (
lineItems)，包括订单中的商品 - 订单商品与订单货件的映射关系 (
shipment_line_item_mapping) 您要提交数据的商家的商家 ID (
merchant_id)。此字段为可选字段，可让您代表其他商家提供数据。如果您未为此字段提供值，则数据会与提交该数据的账号相关联。
如需详细了解必需和可选的订单跟踪字段，请参阅 ordertrackingsignals 资源的参考文档。
提交新的订单跟踪信号数据
以下是提交新订单跟踪数据的请求示例：
https://shoppingcontent.googleapis.com/content/v2.1/merchantId/ordertrackingsignals
{
"merchantId": "987654321",
"orderCreatedTime": {
"year": 2020,
"month": 1,
"day": 2,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"orderId": "123456789",
"shippingInfo": [
{
"shipmentId": "1",
"trackingId": "100",
"carrierName": "FEDEX",
"carrierServiceName": "GROUND",
"shippedTime": {
"year": 2020,
"month": 1,
"day": 3,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippingStatus": "DELIVERED"
},
{
"shipmentId": "2",
"earliestDeliveryPromiseTime": {
"year": 2020,
"month": 1,
"day": 4,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"latestDeliveryPromiseTime": {
"year": 2020,
"month": 1,
"day": 5,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"actualDeliveryTime": {
"year": 2020,
"month": 1,
"day": 5,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippedTime": {
"year": 2020,
"month": 1,
"day": 3,
"hours": 0,
"minutes": 0,
"seconds": 0,
"timeZone": {
"id": "America/Los_Angeles"
}
},
"shippingStatus": "DELIVERED"
}
],
"lineItems": [
{
"lineItemId": "item1",
"productId": "online:en:US:item1",
"quantity": "3"
},
{
"lineItemId": "item2",
"productId": "online:en:US:item2",
"quantity": "5"
}
],
"shipmentLineItemMapping": [
{
"shipmentId": "1",
"lineItemId": "item1",
"quantity": "1"
},
{
"shipmentId": "2",
"lineItemId": "item1",
"quantity": "2"
},
{
"shipmentId": "1",
"lineItemId": "item2",
"quantity": "4"
},
{
"shipmentId": "2",
"lineItemId": "item2",
"quantity": "1"
}
],
"customerShippingFee": {
"value": "4.5",
"currency": "USD"
},
"deliveryPostalCode": "94043",
"deliveryRegionCode": "US"
}
更新现有订单跟踪信号数据
如需修改已提交的订单跟踪数据，请提交包含相同 orderId 的新数据。对于运费估算和“快速免费”徽章，系统只会使用每个 orderId 最近提交的数据。