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

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

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

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

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

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

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

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

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

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

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

लाइव प्राइसिंग क्वेरी

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

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

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

कॉन्टेक्स्ट

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

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

एआरआई पुश डिलीवरी मोड

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

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

fig1

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

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

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

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

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

अनुमति वाले आईपी पते

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

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

हर प्रॉपर्टी के लिए, उपलब्ध कमरों के टाइप और किराये की योजनाओं (पैकेज) को तय करने के लिए, लेन-देन (प्रॉपर्टी का डेटा) मैसेज टाइप का इस्तेमाल करें. कमरे के टाइप या किराये के प्लान जोड़े, हटाए या उनमें बदलाव किए जाने पर, आपको अपडेट पुश करने चाहिए. इस मामले में, आपको <RoomData> और <PackageData> एलिमेंट में नई जानकारी के साथ एक XML मैसेज भेजना होगा. ये एलिमेंट, <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, तय की गई फ़्रीक्वेंसी पर आपके सर्वर को एक टाइमस्टैंप भेजता है. इससे यह पता चलता है कि आपने आखिरी बार Hint Request मैसेज का जवाब कब दिया था.
  • User-Agent हेडर को Google-HotelAdsPrices पर सेट किया गया है.

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

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

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

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

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

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

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

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

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

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