订单跟踪信号

借助订单跟踪信号,您可以针对通过商家网站完成的订单,向 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 最近提交的数据。