訂單追蹤信號

訂單追蹤信號可讓您向 Google 提供過往訂單追蹤資料，以便瞭解透過商家網站完成的訂單。這樣一來，買家就能更準確且準確地預估運費。訂單追蹤信號也可讓您運用免運費及快速出貨註解強化產品資訊。

無論是透過商家網站完成的訂單，還是透過 Buy on 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 最新提交的資料。