订单跟踪信号

借助订单跟踪信号，您可以向 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 最近提交的数据。