订单跟踪信号

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