订单跟踪信号

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