注文追跡シグナルを使用すると、販売者のサイトで完了した注文に関する過去の注文追跡データを 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
に最近送信されたデータのみが使用されます。