訂單追蹤信號

訂單追蹤信號可讓您向 Google 提供透過商家網站完成的訂單歷來追蹤資料。為買家提供更精確的運送預估時間。訂單追蹤信號也能用來在產品資訊中加入免運費及快速出貨註解。

你可以提交透過商家網站完成的訂單資料。你提交的資料會補充你透過 Merchant Center 帳戶設定提供的運送設定資訊。舉例來說，如果你向買家提供的運送預估時間為 3 到 7 天，但最近的過往訂單追蹤記錄顯示，某些地區的訂單通常會在 3 天內送達，Google 就會更新你的產品資訊，向消費者提供更準確的預估時間。

本指南說明如何使用 ordertrackingsignals 服務提交歷史訂單追蹤資料。

使用 ordertrackingsignals 服務

ordertrackingsignals 服務包含單一 create 端點，可供你提交歷來訂單追蹤資料。請只提交已送達訂單的資料，方便我們驗證運送時間。每次要求只能提交一筆訂單。您可以在要求主體中提交下列資訊：

• 訂單資訊，包括訂單 ID、訂單建立時間、交貨地點郵遞區號和區碼
• 向買家收取的運費 (customer_shipping_fee)
• 運送資訊 (shippingInfo)，包括與每份訂單相關的貨運公司、追蹤資訊、出貨地、目的地和運送時間等資訊
• 訂單明細項目資訊 (lineItems)，包括訂單中的產品
• 訂單商品與訂單出貨內容的對應關係 (shipment_line_item_mapping)

• 你要提交資料的商家 ID (merchant_id)。這個欄位為選填，可讓你代表其他商家提供資料。如未提供這個欄位的值，資料會與提交資料的帳戶建立關聯。

  注意： 你必須先啟用這項功能，才能代表其他商家提交資料。如要申請存取權，請傳送電子郵件至 [e-mail]。

如要進一步瞭解必要和選填的訂單追蹤欄位，請參閱 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 最近提交的資料。