Tín hiệu theo dõi đơn đặt hàng cho phép bạn cung cấp cho Google dữ liệu theo dõi đơn đặt hàng trước đây đối với các đơn đặt hàng đã hoàn tất thông qua trang web của người bán. Nhờ đó cung cấp cho người mua thông tin ước tính vận chuyển chính xác và chính xác hơn. Các tín hiệu theo dõi đơn đặt hàng cũng giúp bạn cải thiện trang thông tin của mình bằng chú thích về dịch vụ vận chuyển nhanh và miễn phí.
Bạn có thể gửi dữ liệu của cả những đơn đặt hàng đã hoàn tất qua trang web của người bán và qua chương trình Mua trên Google. Dữ liệu mà bạn gửi bổ sung cho thông tin về cấu hình vận chuyển mà bạn cung cấp trong quá trình thiết lập tài khoản Merchant Center. Ví dụ: Nếu bạn cung cấp cho người mua thông tin vận chuyển ước tính trong khoảng từ 3 đến 7 ngày, nhưng dữ liệu theo dõi đơn đặt hàng trước đây gần đây cho biết các đơn đặt hàng của bạn thường đến trong vòng 3 ngày ở một số khu vực, thì Google có thể cập nhật trang thông tin của bạn để cung cấp cho khách hàng thông tin ước tính chính xác hơn.
Hướng dẫn này giải thích cách sử dụng dịch vụ ordertrackingsignals để gửi dữ liệu theo dõi đơn đặt hàng trước đây của bạn.
Sử dụng dịch vụ ordertrackingsignals
Dịch vụ ordertrackingsignals bao gồm một điểm cuối create duy nhất, cho phép bạn gửi dữ liệu theo dõi đơn đặt hàng trước đây. Chỉ gửi dữ liệu cho các đơn đặt hàng đã được giao để chúng tôi có thể xác minh thời gian vận chuyển. Bạn có thể gửi một đơn đặt hàng mỗi yêu cầu. Trong nội dung yêu cầu, bạn có thể gửi các thông tin sau:
- Thông tin đơn đặt hàng, trong đó có mã đơn hàng và thời gian tạo đơn đặt hàng, mã bưu chính giao hàng và mã vùng
- Phí vận chuyển tính cho người mua (
customer_shipping_fee) - Thông tin vận chuyển (
shippingInfo) bao gồm hãng vận chuyển, thông tin theo dõi, nơi xuất phát, điểm đến và thời gian vận chuyển cho mỗi lô hàng trong đơn đặt hàng - Thông tin về mỗi mục riêng trên đơn đặt hàng (
lineItems), bao gồm cả các sản phẩm trong đơn đặt hàng - Liên kết mục hàng của đơn đặt hàng với các lô hàng của đơn đặt hàng
(
shipment_line_item_mapping) Mã người bán của người bán mà bạn đang gửi dữ liệu (
merchant_id). Trường này là không bắt buộc và cho phép bạn cung cấp dữ liệu thay mặt cho một người bán khác. Nếu bạn không cung cấp giá trị cho trường này, thì dữ liệu được liên kết với tài khoản gửi giá trị đó.
Để biết thêm thông tin về các trường theo dõi đơn đặt hàng bắt buộc và không bắt buộc, hãy xem tài liệu tham khảo về tài nguyên ordertrackingsignals.
Gửi dữ liệu tín hiệu theo dõi đơn đặt hàng mới
Dưới đây là yêu cầu mẫu để gửi dữ liệu theo dõi đơn đặt hàng mới:
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"
}
Cập nhật dữ liệu tín hiệu theo dõi đơn đặt hàng hiện có
Để sửa đổi dữ liệu theo dõi đơn đặt hàng đã gửi, hãy gửi một yêu cầu chứa dữ liệu mới có cùng orderId. Đối với thông tin ước tính vận chuyển cũng như huy hiệu nhanh và miễn phí, hệ thống chỉ sử dụng dữ liệu được gửi gần đây nhất cho mỗi orderId.