สัญญาณการติดตามคําสั่งซื้อ

สัญญาณการติดตามคำสั่งซื้อช่วยให้คุณส่งข้อมูลการติดตามคำสั่งซื้อที่ผ่านมาสำหรับคำสั่งซื้อที่ดำเนินการเสร็จสมบูรณ์ผ่านเว็บไซต์ของผู้ขายให้กับ Google ได้ ซึ่งจะช่วยให้ผู้ซื้อทราบค่าจัดส่งโดยประมาณที่แม่นยำยิ่งขึ้น สัญญาณการติดตามคำสั่งซื้อยังช่วยให้คุณปรับปรุงข้อมูลด้วยคำอธิบายประกอบการจัดส่งฟรีและรวดเร็วได้ด้วย

คุณส่งข้อมูลสำหรับคำสั่งซื้อที่ดำเนินการเสร็จสมบูรณ์ผ่านเว็บไซต์ของผู้ขายได้ ข้อมูลที่ส่งมาจะเสริมข้อมูลการกำหนดค่าการจัดส่งที่คุณระบุไว้ในการตั้งค่าบัญชี Merchant Center ตัวอย่างเช่น หากคุณระบุเวลานำส่งโดยประมาณสำหรับการจัดส่งแก่ผู้ซื้อที่ 3-7 วัน แต่การติดตามคำสั่งซื้อที่ผ่านมาล่าสุดระบุว่าคำสั่งซื้อมักจะมาถึงใน 3 วันในบางภูมิภาค Google จะอัปเดตข้อมูลผลิตภัณฑ์เพื่อระบุเวลานำส่งโดยประมาณที่แม่นยำยิ่งขึ้นให้แก่ลูกค้าได้

คำแนะนำนี้จะอธิบายวิธีใช้บริการ ordertrackingsignals เพื่อส่งข้อมูลการติดตามคำสั่งซื้อที่ผ่านมา

ใช้บริการ ordertrackingsignals

บริการ ordertrackingsignals มีปลายทาง create รายการเดียว ซึ่งจะช่วยให้คุณส่งข้อมูลการติดตามคำสั่งซื้อที่ผ่านมาได้ โปรดส่งเฉพาะข้อมูลคำสั่งซื้อที่จัดส่งแล้วเพื่อให้เรายืนยันเวลาจัดส่งได้ คุณส่งคำสั่งซื้อได้ 1 รายการต่อคำขอ คุณส่งข้อมูลต่อไปนี้ได้ในเนื้อหาคำขอ

  • ข้อมูลคำสั่งซื้อ เช่น รหัสคำสั่งซื้อและเวลาสร้างคำสั่งซื้อ รหัสไปรษณีย์ของการนำส่ง และรหัสภูมิภาค
  • ค่าจัดส่งที่เรียกเก็บจากผู้ซื้อ (customer_shipping_fee)
  • ข้อมูลการจัดส่ง (shippingInfo) รวมถึงผู้ให้บริการขนส่ง การติดตาม ต้นทาง ปลายทาง และเวลาจัดส่งสำหรับการจัดส่งแต่ละรายการที่เชื่อมโยงกับคำสั่งซื้อนั้นๆ
  • ข้อมูลสินค้าในรายการสั่งซื้อ (lineItems) รวมถึงผลิตภัณฑ์ในคำสั่งซื้อ
  • การแมปรายการโฆษณาของคำสั่งซื้อกับการจัดส่งคำสั่งซื้อ (shipment_line_item_mapping)

  • รหัสผู้ขายของผู้ขายที่คุณส่งข้อมูล (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 แต่ละรายการเท่านั้น