注文追跡シグナル

注文追跡シグナルを使用すると、販売者のサイトで完了した注文に関する過去の注文追跡データを Google に提供できます。これにより、購入者はより正確な配送予定日を確認できます。注文追跡シグナルを使用すると、無料で迅速な配送のアノテーションをリスティングに追加することもできます。

販売者のサイトで完了した注文のデータを送信できます。送信するデータは、Merchant Center アカウントの設定で指定する配送設定情報を補完するものです。たとえば、購入者に 3 ～ 7 日の配送予定日を提示している場合でも、最近の注文追跡履歴で一部の地域では通常 3 日で商品が届いていることが示されている場合、Google はリスティングを更新して、より正確な配送予定日を購入者に提示できます。

このガイドでは、ordertrackingsignals サービスを使用して過去の注文追跡データを送信する方法について説明します。

ordertrackingsignals サービスを使用する

ordertrackingsignals サービスには 1 つの create エンドポイントが含まれており、過去の注文追跡データを送信できます。配送時間を検証できるように、配送済みの注文のデータのみを送信してください。リクエストごとに 1 つの注文を送信できます。リクエスト本文で、次の情報を送信できます。

  • 注文情報（注文 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 の最新の送信データのみが使用されます。