注文追跡シグナルを使用すると、販売者のサイトで完了した注文の過去の注文追跡データを Google に提供できます。これにより、購入者はより正確な配送予定日を確認できます。注文追跡シグナルを使用すると、送料無料とエクスプレス配送のアノテーションを使ってリスティングを強化することもできます。
販売者のサイトで完了した注文のデータは送信できます。送信するデータは、Merchant Center アカウントの設定で指定した配送構成情報を補完するものです。たとえば、配送所要日数を 3 ～ 7 日と購入者に提示しているにもかかわらず、過去の注文追跡データから、一部の地域では通常 3 日で注文が届くことが判明した場合、Google はリスティングを更新して、より正確な配送所要日数を購入者に提示できます。
このガイドでは、ordertrackingsignals サービスを使用して過去の注文追跡データを送信する方法について説明します。
ordertrackingsignals サービスを使用する
ordertrackingsignals サービスには、過去の注文追跡データを送信できる単一の 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 について最後に送信されたデータのみが使用されます。