Sinyal pelacakan pesanan

Sinyal pelacakan pesanan memungkinkan Anda memberikan data historis pelacakan pesanan kepada Google untuk pesanan yang diselesaikan melalui situs penjual. Hal ini memberikan estimasi pengiriman yang lebih akurat dan presisi 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 perkiraan pengiriman kepada pembeli sebesar 3-7 hari, tetapi histori pelacakan pesanan terbaru Anda menunjukkan bahwa pesanan Anda biasanya tiba dalam 3 hari di beberapa wilayah, Google dapat memperbarui listingan Anda untuk memberikan perkiraan yang lebih akurat kepada pelanggan.

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

Gunakan layanan ordertrackingsignals

Layanan ordertrackingsignals menyertakan satu endpoint create yang memungkinkan Anda mengirimkan data historis pelacakan pesanan. 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 dibebankan kepada pembeli (customer_shipping_fee)
  • Informasi pengiriman (shippingInfo) termasuk jasa kurir, pelacakan, asal, tujuan, dan waktu pengiriman untuk setiap pengiriman yang terkait dengan pesanan
  • Informasi item baris pesanan (lineItems), termasuk produk dalam pesanan
  • Pemetaan item baris pesanan untuk memesan pengiriman (shipment_line_item_mapping)

  • ID 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 informasi selengkapnya tentang kolom pelacakan pesanan yang wajib dan opsional, lihat dokumentasi referensi untuk resource ordertrackingsignals.

Mengirim 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 dikirimkan, kirim permintaan yang berisi data baru dengan orderId yang sama. Untuk estimasi pengiriman dan pemberian badge yang cepat dan gratis, hanya data terbaru yang dikirimkan untuk setiap orderId yang akan digunakan.