注文追跡シグナル

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

販売者のサイトから完了した注文と「Google で購入」の両方で完了した注文のデータを送信できます。送信するデータは、Merchant Center アカウントの設定時に指定する配送設定情報を補完するものです。たとえば、購入者に配送予定日を 3 ~ 7 日提示しているものの、最近の注文追跡で、一部の地域では注文が通常 3 日以内に届くことが示されている場合、Google はリスティングを更新して、より正確な見積もり額をユーザーに提供できます。

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

ordertrackingsignals サービスを使用する

ordertrackingsignals サービスには単一の create エンドポイントが含まれており、これを使用して過去の注文追跡データを送信できます。配送済みの注文についてのみ、Google が配送所要日数を確認できるようにします。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 に最近送信されたデータのみが使用されます。