Sinyal pelacakan pesanan

Sinyal pelacakan pesanan memungkinkan Anda memberikan data pelacakan pesanan historis kepada Google untuk pesanan yang diselesaikan melalui situs penjual. Hal ini memberikan estimasi pengiriman yang lebih akurat dan tepat kepada pembeli. Sinyal pelacakan pesanan juga memungkinkan Anda meningkatkan kualitas listingan dengan anotasi pengiriman gratis dan cepat.

Anda dapat mengirimkan data untuk pesanan yang diselesaikan melalui situs penjual. Data yang Anda kirimkan melengkapi informasi konfigurasi pengiriman yang Anda berikan sebagai bagian dari penyiapan akun Merchant Center. Misalnya, jika Anda memberikan estimasi pengiriman 3-7 hari kepada pembeli, tetapi data pelacakan pesanan historis terbaru menunjukkan bahwa pesanan Anda biasanya tiba dalam 3 hari di beberapa wilayah, Google dapat memperbarui listingan Anda untuk memberikan estimasi yang lebih akurat kepada pelanggan.

Panduan ini menjelaskan cara menggunakan layanan ordertrackingsignals untuk mengirimkan data pelacakan pesanan historis Anda.

Menggunakan layanan ordertrackingsignals

Layanan ordertrackingsignals mencakup satu endpoint create, yang memungkinkan Anda mengirimkan data pelacakan pesanan historis. Hanya kirimkan data untuk pesanan yang telah dikirim, sehingga kami dapat memverifikasi waktu pengiriman. Anda dapat mengirimkan satu pesanan per permintaan. Dalam isi permintaan, Anda dapat mengirimkan informasi berikut:

• Informasi pesanan, yang meliputi ID pesanan dan waktu pembuatan pesanan, kode pos pengiriman, dan kode wilayah
• Biaya pengiriman yang dikenakan kepada pembeli (customer_shipping_fee)
• Informasi pengiriman (shippingInfo) yang meliputi ekspedisi, pelacakan, asal, tujuan, dan waktu pengiriman untuk setiap pengiriman yang terkait dengan pesanan
• Informasi item baris pesanan (lineItems), yang meliputi produk dalam pesanan
• Pemetaan item baris pesanan ke pengiriman pesanan (shipment_line_item_mapping)

• ID penjual untuk penjual yang datanya Anda kirimkan (merchant_id). Kolom ini bersifat opsional dan memungkinkan Anda memberikan data atas nama penjual lain. Jika Anda tidak memberikan nilai untuk kolom ini, data akan dikaitkan dengan akun yang mengirimkannya.

Untuk mengetahui informasi selengkapnya tentang kolom pelacakan pesanan yang wajib dan opsional, lihat dokumentasi referensi untuk ordertrackingsignals resource.

Mengirimkan data sinyal pelacakan pesanan baru

Berikut adalah contoh permintaan untuk mengirimkan data pelacakan pesanan baru:

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"
}

Memperbarui data sinyal pelacakan pesanan yang ada

Untuk mengubah data pelacakan pesanan yang telah dikirim, kirimkan permintaan yang berisi data baru dengan orderId yang sama. Untuk estimasi pengiriman dan badge cepat dan gratis, hanya data yang paling baru dikirim untuk setiap orderId yang akan digunakan.