Sinyal pelacakan pesanan

Sinyal pelacakan pesanan memungkinkan Anda memberikan data histori pelacakan pesanan kepada Google untuk pesanan yang diselesaikan melalui situs penjual. Hal ini memberikan perkiraan 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 dan melalui Beli dengan Google. Data yang Anda kirimkan melengkapi informasi konfigurasi pengiriman yang Anda berikan sebagai bagian dari pembuatan akun Merchant Center. Misalnya, jika Anda memberi pembeli estimasi pengiriman 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 tepat 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 historis pelacakan pesanan. Hanya kirimkan data untuk pesanan yang telah dikirim agar 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 ditagihkan 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 pengiriman pesanan (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 mengetahui informasi selengkapnya tentang kolom pelacakan pesanan wajib dan opsional, baca dokumentasi referensi untuk referensi ordertrackingsignals.

Mengirimkan data sinyal pelacakan pesanan yang baru

Berikut adalah contoh permintaan untuk mengirimkan data pelacakan pesanan yang 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, kirimkan permintaan yang berisi data baru dengan orderId yang sama. Untuk estimasi pengiriman serta badge yang cepat dan gratis, hanya data yang terakhir dikirimkan untuk setiap orderId yang digunakan.