借助订单跟踪信号,您可以向 Google 提供通过商家网站完成的订单的历史订单跟踪数据。这为买家提供了更精确的运费估算值。借助订单跟踪信号,您还可以使用“免费快速配送”注释来完善商品详情。
对于通过商家网站和“在 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
提交的数据。