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 của bạn đối với các đơn đặt hàng đã hoàn tất thông qua trang web của người bán. Điều này cung cấp cho người mua số liệu ước tính về thời gian vận chuyển chính xác và chính xác hơn. Tín hiệu theo dõi đơn đặt hàng cũng cho phép bạn cải thiện trang thông tin 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 cho các đơn đặt hàng được hoàn tất thông qua trang web của người bán. Dữ liệu mà bạn gửi bổ sung cho thông tin 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 ước tính về thời gian vận chuyển là từ 3 đến 7 ngày, nhưng dữ liệu theo dõi đơn đặt hàng trước đây cho thấy đơn đặt hàng của bạn thường đến nơi 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.
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. Bạn chỉ nên 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 cho mỗi yêu cầu. Trong phần 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 điểm 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 cả hãng vận chuyển, đơn đặt hàng, điểm xuất phát, điểm đến và thời gian vận chuyển của từng lô hàng liên kết với đơn đặt hàng - Thông tin về mục hàng trong đơn đặt hàng (
lineItems), bao gồm cả các sản phẩm trong đơn đặt hàng - Liên kết các mục hàng trong đơn đặt hàng với các lô hàng vận chuyển
(
shipment_line_item_mapping) Mã người bán của người bán mà bạn 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 người bán khác. Nếu bạn không cung cấp giá trị cho trường này, dữ liệu sẽ được liên kết với tài khoản gửi dữ liệu.
Để 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 cho tài nguyên ordertrackingsignals.
Gửi dữ liệu tín hiệu theo dõi đơn hàng mới
Dưới đây là yêu cầu mẫu về việc 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 yêu cầu chứa dữ liệu mới có cùng orderId. Đối với thông tin vận chuyển ước tính và huy hiệu nhanh và miễn phí, hệ thống chỉ sử dụng dữ liệu gần đây nhất được gửi cho mỗi orderId.