透過訂單追蹤信號，您可以將透過商家網站完成的訂單歷來追蹤資料提供給 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 最新提交的資料。