주문 추적 신호

주문 추적 신호를 사용하면 판매자 사이트를 통해 완료된 주문의 이전 주문 추적 데이터를 Google에 제공할 수 있습니다. 이를 통해 구매자에게 더 정확한 배송 추정치를 제공할 수 있습니다. 주문 추적 신호를 사용하면 빠른 무료 배송 주석으로 등록정보를 개선할 수도 있습니다.

판매자 사이트를 통해 완료된 주문의 데이터를 제출할 수 있습니다. 제출하는 데이터는 판매자 센터 계정 설정의 일부로 제공하는 배송 구성 정보를 보완합니다. 예를 들어 구매자에게 3~7일의 배송 예상 기간을 제공하지만 최근 주문 내역 추적에 따르면 일부 지역에서 주문이 일반적으로 3일 만에 도착하는 경우 Google에서 고객에게 더 정확한 예상 기간을 제공하도록 등록정보를 업데이트할 수 있습니다.

이 가이드에서는 ordertrackingsignals 서비스를 사용하여 이전 주문 추적 데이터를 제출하는 방법을 설명합니다.

ordertrackingsignals 서비스 사용

ordertrackingsignals 서비스에는 이전 주문 추적 데이터를 제출할 수 있는 단일 create 엔드포인트가 포함되어 있습니다. 배송 시간을 확인할 수 있도록 배송된 주문의 데이터만 제출하세요. 요청당 주문 하나를 제출할 수 있습니다. 요청 본문에 다음 정보를 제출할 수 있습니다.

  • 주문 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에 대해 가장 최근에 제출된 데이터만 사용됩니다.