注文追跡シグナル

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

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

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

ordertrackingsignals サービスを使用する

ordertrackingsignals サービスには、過去の注文追跡データを送信できる create エンドポイントが 1 つ含まれています。配送時間を確認できるように、配送済みの注文のデータのみを送信してください。リクエストごとに 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 ごとに最後に送信されたデータのみが使用されます。