डिलीवरी के मोड तय करना

डिलीवरी मोड से यह तय होता है कि होटल और यात्रा की योजना के कॉम्बिनेशन के लिए, Google को किराये के अपडेट कैसे भेजे जाएं. डिलीवरी मोड सेट अप करने के लिए, शुरुआती कॉन्फ़िगरेशन के दौरान, आप और आपका तकनीकी खाता मैनेजर (टीएएम) साथ मिलकर काम करते हैं.

डिलीवरी के तरीकों के बारे में खास जानकारी

डिफ़ॉल्ट रूप से, किसी होटल में कमरे की उपलब्धता के लिए 330 दिन पहले और ठहरने की अवधि के लिए 30 रातों तक की क्वेरी की जा सकती है. हालांकि, यात्रा की योजनाओं की ज़्यादा से ज़्यादा संख्या (चेक-इन की तारीख और ठहरने की अवधि का कॉम्बिनेशन) तय की जा सकती है.

जितनी ज़्यादा यात्रा की योजनाएं उपलब्ध कराई जाएंगी उतनी ही ज़्यादा नीलामियों में आपकी भागीदारी होगी. हालांकि, जितनी ज़्यादा यात्रा की योजनाएं उपलब्ध कराई जाएंगी उतना ही ज़्यादा डेटा आपको Google को भेजना होगा, ताकि किराये का डेटा सटीक रहे.

कीमतों को अपडेट करने के सामान्य तरीकों में, ट्रांज़ैक्शन मैसेज का इस्तेमाल इनमें से किसी एक तरीके से किया जाता है:

  • एआरआई (पुश): किराया डिलीवरी फ़ीड, जो किराये के प्लान, उपलब्धता, और होटल के मेटाडेटा का इस्तेमाल करके, आपकी प्रॉपर्टी के लिए पहले से तय की गई किराये की रणनीतियां सेट करता है. किराये और उपलब्धता में बदलाव और पुल किए गए किराये के फ़ीड के उलट, एआरआई फ़ीड किसी खास कीमत या यात्रा की योजना के लिए क्वेरी नहीं करते. इसके बजाय, आपको जानकारी के सबसेट वाले मैसेज पुश करने होंगे. इन मैसेज में, किराये की अलग-अलग जानकारी, पाबंदियों, और उपलब्धता के आधार पर, आपकी प्रॉपर्टी के लिए तय किए गए किराये के मॉडल की जानकारी होती है. उपलब्धता और कीमत की जानकारी देने के लिए, एआरआई फ़ीड, OTA एक्सएमएल स्पेसिफ़िकेशन (OTA_HotelRateAmountNotifRQ और OTA_HotelAvailNotifRQ) का इस्तेमाल करते हैं. ARI डिलीवरी मोड के बारे में ज़्यादा जानने और यह तय करने के लिए कि यह फ़ीड टाइप आपके खाते के लिए सबसे सही है या नहीं, अपने खाता मैनेजर से संपर्क करें. ज़्यादा जानकारी के लिए, एआरआई का इस्तेमाल करना लेख पढ़ें.

  • पुल: Google, कीमत और उपलब्धता के डेटा के कैश मेमोरी को रीफ़्रेश करने के लिए, नियमित तौर पर आपकी सेवा से क्वेरी करता है. इस मॉडल में, Google आपके सर्वर को अनुरोध भेजता है और आपका सर्वर अपडेट किए गए डेटा के साथ जवाब देता है. यह मॉडल तब सबसे अच्छा होता है, जब आपको यह पता न हो कि कीमत की जानकारी कब बदलती है या दिन भर में कीमत की जानकारी में अनियमित तौर पर बदलाव होता है. किराये कैश मेमोरी में तब तक बने रहते हैं, जब तक Google के एल्गोरिदम यह तय नहीं कर लेते कि किराये पुराने हो गए हैं. यह तय करने के लिए, एल्गोरिदम पार्टनर के हिसाब से, किराये में हुए पिछले बदलावों के इतिहास का इस्तेमाल करते हैं. ज़्यादा जानकारी के लिए, पुल डिलीवरी मोड का इस्तेमाल करना लेख पढ़ें.

  • किराया और उपलब्धता में बदलाव (पहले, संकेत के साथ पुल किया गया): यह पुल की तरह ही है. हालांकि, Google सभी प्रॉपर्टी के लिए नहीं, बल्कि सिर्फ़ प्रॉपर्टी के सबसेट के लिए डेटा का अनुरोध करता है. इस मोड की मदद से, अपनी प्रॉपर्टी की कीमतों और उपलब्धता को अपडेट करते समय, नेटवर्क ट्रैफ़िक में काफ़ी कमी आ सकती है. कीमतें अपडेट होने तक, कैश मेमोरी में सेव रहती हैं. ज़्यादा जानकारी के लिए, बदली गई कीमत का इस्तेमाल करना लेख पढ़ें.

कीमतों को अपडेट करने के अलावा, ट्रांज़ैक्शन मैसेज का इस्तेमाल करके अपनी इन्वेंट्री से प्रॉपर्टी हटाई जा सकती हैं. ज़्यादा जानकारी के लिए, इन्वेंट्री हटाना लेख पढ़ें.

कीमत में बदलाव करने के बारे में ज़्यादा जानने के लिए, कीमतों में बदलाव करना लेख पढ़ें. इसमें लेन-देन के मैसेज के उदाहरण भी दिए गए हैं.

किराये की लाइव क्वेरी

Google, लाइव कीमत से जुड़ी क्वेरी की मदद से, नीलामी के समय कीमत में कुछ बदलावों का अनुरोध भी कर सकता है. लाइव किराये की क्वेरी, किसी मौजूदा नीलामी के लिए Google से की गई किराये की जानकारी के अनुरोध होते हैं. तय समयसीमा के अंदर जवाब देने पर, आपका विज्ञापन नीलामी में दिखेगा.

Google, लाइव किराये की क्वेरी के जवाब को ठीक उसी तरह से सेव करता है जिस तरह वह किसी भी अन्य लेन-देन के मैसेज को सेव करता है. इस वजह से, Google आने वाले समय में लाइव किराया क्वेरी भेजने के बजाय, अपने कैश मेमोरी से किराया दिखा सकता है.

ज़्यादा जानकारी के लिए, लाइव कीमत से जुड़ी क्वेरी देखें.

संदर्भ

आम तौर पर, 'खींचें और छोड़ें' और 'कीमत में बदलाव' क्वेरी में उपयोगकर्ता के बारे में जानकारी नहीं दी जाती. इसकी वजह यह है कि Google आपके जवाबों का इस्तेमाल, कैश मेमोरी भरने के लिए करता है. इसका इस्तेमाल, कई तरह के उपयोगकर्ताओं को दिखाने के लिए किया जा सकता है.

उपयोगकर्ता के संभावित कॉन्टेक्स्ट के पूरे सेट के हिसाब से कीमतें दिखाना आपके लिए महंगा हो सकता है. इसलिए, एक ऐसी सुविधा को टेस्ट किया जा रहा है जिसमें क्वेरी के हिस्से के तौर पर, उपयोगकर्ता के लोकप्रिय कॉन्टेक्स्ट तय किए जाते हैं. उपयोगकर्ता के संदर्भ, उन उपयोगकर्ता अनुरोधों पर आधारित होते हैं जिनमें आपके पास कीमत दिखाने का मौका था. इनका हिसाब, उपयोगकर्ता के ज़्यादातर अनुरोधों को कवर करने के लिए लगाया जाता है. आपको बहुत लोकप्रिय प्रॉपर्टी या यात्रा की योजनाओं के लिए, उपयोगकर्ता के कॉन्टेक्स्ट की बड़ी संख्या दिख सकती है. हालांकि, उपयोगकर्ता के कॉन्टेक्स्ट की औसत संख्या 10 से कम होनी चाहिए. आपके पास अतिरिक्त कीमतें दिखाने या उपयोगकर्ता के बताए गए कॉन्टेक्स्ट को अनदेखा करने का विकल्प होता है. यह तय करना आपके ऊपर है कि किसी क्वेरी के लिए कौनसी कीमतें दिखानी हैं. हालांकि, उपयोगकर्ता के सुझाए गए कॉन्टेक्स्ट को अनदेखा करने से, ट्रैफ़िक कम हो सकता है.

ARI पुश डिलीवरी मोड

ARI पुश डिलीवरी मोड की मदद से, जब भी रात भर के किराये, उपलब्धता, इन्वेंट्री की संख्या या अन्य पाबंदियों में बदलाव होता है, तो Google को इनके बारे में अपडेट भेजे जाते हैं. किराया पुल करने या किराये या उपलब्धता में बदलाव करने की सुविधा के मुकाबले, एआरआई पुश की मदद से, किराये के लिए अलग मॉडल का इस्तेमाल किया जा सकता है. इससे, Google पर किराये की जानकारी के अलग-अलग कॉम्पोनेंट को बेहतर तरीके से अपडेट किया जा सकता है.

यहां दिए गए डायग्राम में, एआरआई पुश डिलीवरी मोड के लिए अनुरोध और जवाब का फ़्लो दिखाया गया है:

fig1

पहला चरण: Google को ARI पुश मैसेज भेजना

एआरआई पुश की मदद से डेटा अपडेट करने के लिए, जब भी आपका डेटा बदले, तो एआरआई अनुरोध मैसेज भेजें. ARI पुश डिलीवरी मोड, अलग-अलग तरह के मैसेज और कीमत तय करने की रणनीतियों के साथ काम करता है. पुश मैसेज के बारे में ज़्यादा जानकारी के लिए, एआरआई का इस्तेमाल करना लेख पढ़ें.

Google को आपके किराये की जानकारी मिलने के 15 से 20 मिनट के अंदर, लोगों को यह जानकारी दिखनी चाहिए.

दूसरा चरण: पुष्टि करना कि Google ने डेटा को कैश मेमोरी में सेव कर लिया है

Google, एआरआई से मिलने वाले हर पुश मैसेज के लिए, एचटीटीपी कनेक्शन की स्थिति और एआरआई प्रोसेसिंग के नतीजों के साथ जवाब देता है. अगर सर्वर से कनेक्शन हो जाता है, तो Google HTTP 200 OK के साथ जवाब देता है. इसमें जवाब के मैसेज वाला मुख्य हिस्सा भी शामिल होता है. इससे पता चलता है कि अपडेट सही तरीके से लागू हुए हैं या डिलीवरी मोड से जुड़ी चेतावनियां या गड़बड़ियां मिली हैं.

अनुमति वाली सूची में शामिल आईपी पते

Google को एआरआई मैसेज भेजने के लिए इस्तेमाल किए जाने वाले आईपी पतों को अनुमति वाली सूची में जोड़ने के लिए, Hotel Center के एआरआई की कीमत की सेटिंग वाले पेज का इस्तेमाल करें. Hotel Center में किराये की सेटिंग अपडेट करने का तरीका जानें.

ARI पुश की मदद से, कमरे और पैकेज का मेटाडेटा अपडेट करना

हर प्रॉपर्टी के लिए, चालू रूम टाइप और किराये के प्लान (पैकेज) तय करने के लिए, लेन-देन (प्रॉपर्टी डेटा) मैसेज टाइप का इस्तेमाल करें. जब भी कमरे के टाइप या किराये के प्लान जोड़े, हटाए या उनमें बदलाव किए जाएं, तो आपको अपडेट भेजने चाहिए. इस मामले में, <RoomData> और <PackageData> एलिमेंट में नई जानकारी के साथ एक एक्सएमएल मैसेज भेजा जाता है. ये एलिमेंट, <PropertyDataSet> एलिमेंट के चाइल्ड होते हैं.

कनेक्शन या कॉन्टेंट से जुड़ी गड़बड़ियां

अगर एक्सएमएल गलत या अमान्य होने की वजह से, डिलीवरी मोड से जुड़ी गड़बड़ी का मैसेज मिलता है, तो फ़ीड की स्थिति से जुड़ी गड़बड़ी के मैसेज में जाकर, समस्या को हल करने का सुझाव देखें.

अगर Google को एआरआई मैसेज भेजते समय, आपको एचटीटीपी कनेक्शन से जुड़ी गड़बड़ी का मैसेज मिलता है, तो अनुरोध को 1, 5, और 20 मिनट के अंतराल पर फिर से भेजें. अगर तीन बार कोशिश करने के बाद भी समस्या हल नहीं होती है, तो मैसेज भेजना बंद करें और Google सहायता टीम से संपर्क करें.

पुल डिलीवरी मोड

पुल डिलीवरी मोड में, Google समय-समय पर आपके सर्वर पर क्वेरी मैसेज भेजता है. ऐसा, कीमत में हुए बदलावों के बारे में जानकारी पाने के लिए किया जाता है. आपका सर्वर उन मैसेज का जवाब लेन-देन से जुड़े मैसेज के साथ देता है. इन मैसेज में, कीमत और उपलब्धता का अपडेट किया गया डेटा होता है.

इस डायग्राम में, पुल के अनुरोध/जवाब का फ़्लो दिखाया गया है:

fig2

कीमत के अपडेट मिलने के बाद, Google आम तौर पर कीमत और उपलब्धता के नए डेटा को करीब पांच मिनट में प्रोसेस कर देता है.

इन सेक्शन में, इन चरणों के बारे में ज़्यादा जानकारी दी गई है.

पहला चरण: क्वेरी मैसेज

डिफ़ॉल्ट रूप से, Google आपकी होटल की सूची में बताई गई सभी प्रॉपर्टी के लिए क्वेरी मैसेज भेजता है. इसका मतलब यह हो सकता है कि कीमत में बदलाव करने की प्रोसेस के दौरान, आपको कई क्वेरी मैसेज मिल रहे हों.

Google आपके सर्वर पर कीमत की क्वेरी मैसेज भेजता है. इन मैसेज में ये विशेषताएं होती हैं:

  • रूट एलिमेंट <Query> है.
  • शुरुआती कॉन्फ़िगरेशन के दौरान तय किए गए एंडपॉइंट पर भेजा जाता है. ज़्यादा जानकारी के लिए, अपने तकनीकी खाता मैनेजर (टैम) से संपर्क करें.
  • एचटीटीपी POST मेथड का इस्तेमाल करता है. (अगर एचटीटीपीएस का इस्तेमाल किया जा रहा है, तो आपको डोमेन पर आधिकारिक सर्टिफ़िकेट देने वाली संस्था से हस्ताक्षर कराना होगा.)
  • Content-Type हेडर को application/xml पर सेट किया गया है.
  • हर मैसेज में ज़्यादा से ज़्यादा 100 प्रॉपर्टी शामिल होती हैं. इन प्रॉपर्टी के लिए Google, किराये और उपलब्धता का डेटा मांगता है.
  • User-Agent हेडर को Google-HotelAdsPrices पर सेट किया गया है.

दूसरा चरण: लेन-देन से जुड़ी जानकारी देने वाला मैसेज

जब आपके सर्वर को क्वेरी मैसेज मिलता है, तो उसे ट्रांज़ैक्शन मैसेज के साथ जवाब देना होगा. इस मैसेज में, अनुरोध की गई यात्रा की योजनाओं के लिए किराये की जानकारी होती है.

लेन-देन से जुड़े मैसेज का रूट एलिमेंट <Transaction> है. ज़्यादा जानकारी के लिए, लेन-देन से जुड़े मैसेज और कीमतें अपडेट करना लेख पढ़ें.

कमरे और पैकेज का मेटाडेटा अपडेट करना

'खींचने' सुविधा का इस्तेमाल करके किराये का डेटा अपडेट करने के अलावा, अपने कमरे और पैकेज के मेटाडेटा को अपडेट करने के लिए, ट्रांज़ैक्शन मैसेज का भी इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, रूम और पैकेज का मेटाडेटा तय करना लेख पढ़ें.

कीमत की जानकारी डिलीवर करने का तरीका बदला गया

कीमत में बदलाव करने से, कीमत के अपडेट के लिए क्वेरी और लेन-देन के मैसेज का साइज़ और संख्या कम करने में मदद मिलती है. 'कीमत में बदलाव' सुविधा का इस्तेमाल करने पर, Google को उन प्रॉपर्टी की सूची भेजी जाती है जिनकी कीमतें अपडेट की गई हैं. Google, क्वेरी के जवाब में एक मैसेज भेजता है. इसमें सिर्फ़ उन प्रॉपर्टी की कीमतों के बारे में पूछा जाता है.

उस एंडपॉइंट को कॉन्फ़िगर करने के लिए जिस पर Google, हिंट का अनुरोध करने वाले मैसेज भेजता है, अपने तकनीकी खाता मैनेजर (टैम) से संपर्क करें. आपने इसे शुरुआती कॉन्फ़िगरेशन के दौरान सेट अप किया होगा.

नीचे दिए गए डायग्राम में, किराये में बदलाव करने के अनुरोध और जवाब का फ़्लो दिखाया गया है:

fig3

नीचे दिए गए सेक्शन में, इस फ़्लो के हर चरण के बारे में बताया गया है.

पहला चरण: हिंट रिक्वेस्ट मैसेज

Google आपके सर्वर पर, हिंट का अनुरोध करने वाले मैसेज भेजता है. इन मैसेज की ये विशेषताएं होती हैं:

  • रूट एलिमेंट <HintRequest> है.
  • इसे शुरुआती कॉन्फ़िगरेशन के दौरान तय किए गए एंडपॉइंट पर भेजा जाता है. ज़्यादा जानकारी के लिए, अपने तकनीकी खाता मैनेजर (टैम) से संपर्क करें.
  • एचटीटीपी POST तरीके का इस्तेमाल करें. (अगर एचटीटीपीएस का इस्तेमाल किया जा रहा है, तो आपको डोमेन पर आधिकारिक सर्टिफ़िकेट देने वाली संस्था से हस्ताक्षर कराना होगा.)
  • Content-Type हेडर को application/xml पर सेट किया गया है.
  • Google, तय की गई फ़्रीक्वेंसी पर आपके सर्वर को एक टाइमस्टैंप भेजता है. इससे यह पता चलता है कि आपने आखिरी बार, हिंट के अनुरोध वाले मैसेज का जवाब कब दिया था.
  • User-Agent हेडर को Google-HotelAdsPrices पर सेट किया गया है.

हमारा सुझाव है कि आप फ़्रीक्वेंसी को पांच मिनट पर सेट करें. हिंट के अनुरोध वाले मैसेज की फ़्रीक्वेंसी सेट करने या उसमें बदलाव करने के लिए, हमसे संपर्क करें.

जब आपको Google से, सुझाव का अनुरोध करने वाला मैसेज मिलता है, तो उस टाइमस्टैंप के बाद अपडेट की गई सभी कीमतों के साथ जवाब दें. ज़्यादा जानकारी के लिए, अनुरोध के लिए दिए गए मैसेज लेख पढ़ें.

दूसरा चरण: हिंट रिस्पॉन्स मैसेज

आपका सर्वर, हिंट के अनुरोध वाले मैसेज का जवाब हिंट रिस्पॉन्स मैसेज के ज़रिए देता है. इस मैसेज में, उन प्रॉपर्टी के होटल आईडी और यात्रा की योजनाएं शामिल होती हैं जिनकी कीमतों में पिछली बार अहम जानकारी के अनुरोध वाले मैसेज मिलने और उस पर जवाब देने के बाद से बदलाव हुआ है.

हिंट रिस्पॉन्स मैसेज का रूट एलिमेंट <Hint> होता है. ज़्यादा जानकारी के लिए, सलाह के तौर पर मिलने वाले रिस्पॉन्स मैसेज देखें.

तीसरा चरण: क्वेरी मैसेज

Google को हिंट रिस्पॉन्स मैसेज मिलता है और वह स्टैंडर्ड पुल मोड की तरह ही क्वेरी मैसेज के साथ जवाब देता है. अंतर यह है कि क्वेरी मैसेज में अब सिर्फ़ उन प्रॉपर्टी के होटल आईडी और यात्रा की योजनाएं शामिल होती हैं जिनके बारे में आपने हिंट रिस्पॉन्स मैसेज में बताया था. क्वेरी मैसेज का रूट एलिमेंट, <Query> होता है.

बदली गई कीमत के साथ किन होटल आईडी के लिए किराये का अनुरोध करना है, यह तय करते समय Google, आपके होटल की सूची वाले फ़ीड के कॉन्टेंट को अनदेखा कर देता है. इससे, Google से मिलने वाले क्वेरी मैसेज और आपके जवाब के लेन-देन मैसेज का साइज़ काफ़ी कम हो जाता है.

चौथा चरण: लेन-देन से जुड़ी जानकारी देने वाला मैसेज

Google की क्वेरी मैसेज के जवाब में, कीमत में हुए बदलाव के साथ लेन-देन का मैसेज भेजा जाता है. लेन-देन से जुड़ी जानकारी देने वाले मैसेज का रूट एलिमेंट, <Transaction> होता है. ज़्यादा जानकारी के लिए, पुल डिलीवरी मोड देखें.