ऑर्डर ट्रैक करने के सिग्नल

ऑर्डर ट्रैकिंग सिग्नल की मदद से, Google को किसी व्यापारी/कंपनी की साइट से पूरे किए गए ऑर्डर के पुराने ऑर्डर का ट्रैकिंग डेटा दिया जाता है. इससे खरीदारों को शिपिंग का ज़्यादा सटीक और सटीक अनुमान मिलता है. ऑर्डर ट्रैकिंग सिग्नल की मदद से, मुफ़्त और तेज़ शिपिंग एनोटेशन की मदद से भी अपनी लिस्टिंग को बेहतर बनाया जा सकता है.

व्यापारी/कंपनी की साइट और 'Google पर खरीदें', दोनों के ज़रिए पूरे किए गए ऑर्डर का डेटा सबमिट किया जा सकता है. सबमिट किया जाने वाला डेटा, शिपिंग कॉन्फ़िगरेशन की उस जानकारी के साथ दिखता है जो Merchant Center खाते के सेटअप के दौरान दी जाती है. उदाहरण के लिए, अगर खरीदारों को शिपिंग के लिए तीन से सात दिनों का अनुमान दिया जाता है, लेकिन पुराने ऑर्डर की हाल ही की ट्रैकिंग से पता चलता है कि कुछ क्षेत्रों में आपके ऑर्डर, आम तौर पर तीन दिन में पहुंच जाते हैं, तो Google आपकी लिस्टिंग को अपडेट कर सकता है. इससे खरीदारों को ज़्यादा सटीक अनुमान मिलता है.

इस गाइड में बताया गया है कि पुराने ऑर्डर का ट्रैकिंग डेटा सबमिट करने के लिए, ordertrackingsignals सेवा का इस्तेमाल कैसे किया जाता है.

ordertrackingsignals सेवा का इस्तेमाल करें

ordertrackingsignals सेवा में एक create एंडपॉइंट शामिल होता है. इसकी मदद से, पुराने ऑर्डर का ट्रैकिंग डेटा सबमिट किया जा सकता है. सिर्फ़ उन ऑर्डर का डेटा सबमिट करें जो डिलीवर हो गए हैं, ताकि हम शिपिंग में लगने वाले समय की पुष्टि कर सकें. एक अनुरोध के लिए एक ऑर्डर सबमिट किया जा सकता है. अनुरोध के मुख्य भाग में, आप यह जानकारी सबमिट कर सकते हैं:

  • ऑर्डर की जानकारी, जिसमें ऑर्डर आईडी और ऑर्डर करने का समय, डिलीवरी की जगह का पिन कोड, और क्षेत्र का कोड शामिल हैं
  • शिपिंग के लिए खरीदार से लिया जाने वाला शुल्क (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 के लिए हाल ही में सबमिट किया गया डेटा ही इस्तेमाल किया जाता है.