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 tepat dan akurat 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 3-7 hari kepada pembeli, tetapi pelacakan pesanan historis terbaru 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.

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, termasuk ID pesanan dan waktu pembuatan pesanan, kode pos pengiriman, dan kode wilayah
  • Biaya pengiriman yang dikenakan kepada pembeli (customer_shipping_fee)
  • Informasi pengiriman (shippingInfo), termasuk ekspedisi, 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 ke pengiriman pesanan (shipment_line_item_mapping)

  • ID penjual dari 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 wajib dan opsional, lihat dokumentasi referensi untuk resource ordertrackingsignals.

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 sudah dikirimkan, kirimkan permintaan yang berisi data baru dengan orderId yang sama. Untuk estimasi pengiriman dan badge cepat dan gratis, hanya data yang baru saja dikirimkan untuk setiap orderId yang digunakan.