नियमों के एक्सएमएल रेफ़रंस को रेटिंग दें

किराये के नियमों की एक्सएमएल फ़ाइल में, खास किराये और निजी किराये के लिए नियम तय किए गए हैं. Hotel Center में किराये के नियम पेज का इस्तेमाल करके, किराये के नियमों की एक्सएमएल फ़ाइल जोड़ी जा सकती है या उसमें बदलाव किया जा सकता है. खास किराये और निजी किराये के बारे में ज़्यादा जानकारी के लिए, सीमित और निजी किराये देखें.

दर के हर नियम के लिए एक id होना ज़रूरी है. इसकी जानकारी लेन-देन वाले मैसेज के <Rate> में दी जा सकती है. किराये के नियम के आईडी का रेफ़रंस देने वाला <Rate>, सिर्फ़ उपयोगकर्ताओं को दिखाया जाता है. यह किराये के नियम में तय की गई शर्तों के मुताबिक होता है. लैंडिंग पेज यूआरएल में वैरिएबल का इस्तेमाल करके भी दर के नियम के आईडी का रेफ़रंस दिया जा सकता है.

<RateRuleSettings>

दर के नियमों की एक्सएमएल फ़ाइल का रूट एलिमेंट. <RateRuleSettings> (पहले इसे <PrivateRates> के नाम से जाना जाता था) एलिमेंट में ये शामिल हैं:

  • <UserRateCondition> एलिमेंट, जो खास किराया और निजी किराये की शर्तों के बारे में बताते हैं. उदाहरण के लिए, कोई ऐसी शर्त तय की जा सकती है जो किसी खास देश के सभी उपयोगकर्ताओं की स्थिति से मेल खाए.

  • ऐसे <RateRule> एलिमेंट जो लेन-देन वाले मैसेज में मौजूद <Rate> के रेफ़रंस के लिए, दर का नियम तय करते हैं. हर <RateRule> में उन शर्तों और यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट के बारे में बताया जाता है जो कंडिशनल या प्राइवेट रेट बनाते हैं.

दर के नियमों के एक्सएमएल की हैरारकी में, <RateRuleSettings> एलिमेंट इस जगह पर दिखता है:

+ <RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

सिंटैक्स

<RateRuleSettings> एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <UserRateCondition id="some_id" op="[all|any|none]">
    ...
  </UserRateCondition>
  <!-- Required -->
  <RateRule id="rate_rule_id">
    <!-- Required -->
    <UserRateCondition op="[all|any|none]">
      ...
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

विशेषताएं

<RateRuleSettings> एलिमेंट में कोई एट्रिब्यूट नहीं है.

चाइल्ड एलीमेंट

<RateRuleSettings> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट ज़रूरी है? टाइप कंपनी का ब्यौरा
<RateRule> Required <RateRule>

इससे मैच करने की शर्तों, बदलावों, और शर्तों के साथ या निजी किराये पर ऑफ़र दिखाने की ज़रूरी शर्तों के बारे में पता चलता है. id एट्रिब्यूट की ज़रूरत होती है. इस एट्रिब्यूट की जानकारी, लेन-देन वाले मैसेज के <Rate> मैसेज या लैंडिंग पेज यूआरएल में दी जा सकती है.

<UserRateCondition> Optional <UserRateCondition>

एक या इससे ज़्यादा ऐसी शर्तों के बारे में बताता है जो मेल खाने पर शर्तों के साथ या निजी किराये पर मिलती हैं.

शर्तों को <UserRateCondition> चाइल्ड एलिमेंट का इस्तेमाल करके, इनलाइन तरीके से तय किया जा सकता है. reference_id एट्रिब्यूट का इस्तेमाल करके किसी दूसरे <UserRateCondition> एलिमेंट का रेफ़रंस दिया जा सकता है या इनलाइन और रेफ़रंस, दोनों तरीकों से ऐसा किया जा सकता है. हालांकि, reference_id वाले किसी भी <UserRateCondition> में 0 चाइल्ड होना चाहिए.

<RateRuleSettings> से जुड़े टॉप-लेवल <UserRateCondition> में id एट्रिब्यूट होना चाहिए.

खास किराया तय करने के उदाहरण

इन उदाहरणों में, खास किराये को तय करने के बुनियादी तरीके बताए गए हैं.

हमारा सुझाव है कि आप पहले से तय की गई शर्तों का रेफ़रंस लें, जैसा कि मोबाइल उपयोगकर्ता वाले उदाहरण में दिखाया गया है.

मोबाइल उपयोगकर्ता

शर्तों के साथ यहां दिए गए किराये के उदाहरण में किराये के एक नियम के बारे में बताया गया है. यह नियम, पहले से तय <UserRateCondition> का रेफ़रंस देकर, सभी मोबाइल उपयोगकर्ताओं से मेल खाता है:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <UserRateCondition id="mobile">
    <UserDeviceType>mobile</UserDeviceType>
  </UserRateCondition>
  <RateRule id="mobile">
    <!-- Referencing pre-defined conditions is recommended -->
    <UserRateCondition reference_id="mobile"/>
  </RateRule>
</RateRuleSettings>

अमेरिका में रहने वाले उपयोगकर्ता

शर्तों के साथ यहां दिखाए गए किराये के उदाहरण में किराये के एक नियम के बारे में बताया गया है. यह नियम, पहले से तय किसी <UserRateCondition> का इस्तेमाल करके, अमेरिका में खोज करने वाले सभी उपयोगकर्ताओं से मेल खाता है:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <UserRateCondition id="us">
    <UserCountry>US</UserCountry>
  </UserRateCondition>
  <RateRule id="us">
    <UserRateCondition reference_id="us"/>
  </RateRule>
</RateRuleSettings>

<RateRule>

एक कंटेनर, जिससे यह जानकारी मिलती है:

  • दर दिखाने के लिए शर्तें
  • दर के लिए कीमत और यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट में बदलाव (अगर कोई हो)
  • निजी रेट के लिए, छिपे हुए यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट का इस्तेमाल करना

रेट के नियमों की एक्सएमएल हैरारकी में, <RateRule> एलिमेंट इस जगह पर दिखता है:

+ 
<RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

सिंटैक्स

<RateRule> एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings ...>
  <UserRateCondition ...>
  ...
  </UserRateCondition>
  <!-- At least one RateRule is required. The id attribute is required -->
  <RateRule id="rate_rule_id">
    <!-- One or more UserRateCondition elements (inline or referenced) are required. -->
    <UserRateCondition op="[all|any|none]"> // Inline example
      <Description>user_rate_condition_description</Description>
      <!-- Uses the member rate visible UI treatment -->
      <AlwaysEligibleMembershipProgram>program_name</AlwaysEligibleMembershipProgram>
      <LanguageCode>language_code</LanguageCode>
      <MaxUsersPercent>20</MaxUsersPercent> // 20% of users
      <!-- Requires <RateIneligibility> -->
      <MembershipProgram>program_name</MembershipProgram>
      <UserRateCondition reference_id="user_rate_condition_id"/>
      <UserCountry>country_code</UserCountry>
      <UserDeviceType>[mobile|desktop|tablet]</UserDeviceType>
      <UserListId>id</UserListId>
      <UserSignedIn>[true|false]</UserSignedIn>
      <IsDomestic>[true|false]</IsDomestic>
    </UserRateCondition>
    <RateIneligibility>
      <IneligibilityType>[exact|price_band|existence]</IneligibilityType>
      <IneligibilityReason>[program_member]</IneligibilityReason>
    </RateIneligibility>
    <RateModification>
      <HotelAmenity>[free_wifi]</HotelAmenity>
    </RateModification>
  </RateRule>
</RateRuleSettings>

विशेषताएं

<RateRule> एलिमेंट में ये एट्रिब्यूट मौजूद हैं:

एट्रिब्यूट ज़रूरी है? टाइप कंपनी का ब्यौरा
id ज़रूरी स्ट्रिंग

किराये के नियम के लिए यूनीक आइडेंटिफ़ायर. यह आईडी, लेन-देन से जुड़े मैसेज में <Rate> के rate_rule_id एट्रिब्यूट का इस्तेमाल करके, शर्तों के साथ या निजी कीमत दिखाने के लिए इस्तेमाल किया जाता है. लैंडिंग पेज यूआरएल में वैरिएबल और शर्तों का इस्तेमाल करके भी दर के नियम id का रेफ़रंस दिया जा सकता है.

ज़्यादा से ज़्यादा 40 वर्ण डाले जा सकते हैं.

चाइल्ड एलीमेंट

<RateRule> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट ज़रूरी है? टाइप कंपनी का ब्यौरा
<RateIneligibility> Optional <RateIneligibility> यह उन वैल्यू के बारे में बताता है जो <MembershipProgram> दर के लिए, खास यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट को तय करते हैं.

सिर्फ़ तब मान्य है, जब <UserRateCondition> में <MembershipProgram> के बारे में बताया गया हो.

<UserRateCondition> Required <UserRateCondition>

एक या इससे ज़्यादा ऐसी शर्तों के बारे में बताता है जो मेल खाने पर शर्तों के साथ या निजी किराये पर मिलती हैं.

<UserRateCondition> चाइल्ड एलिमेंट का इस्तेमाल करके, शर्तों को इनलाइन तरीके से तय किया जा सकता है. इसके अलावा, reference_id एट्रिब्यूट का इस्तेमाल करके दूसरे <UserRateCondition> का रेफ़रंस दिया जा सकता है या इनलाइन और रेफ़रंस, दोनों का इस्तेमाल किया जा सकता है.

हालांकि, ध्यान दें कि जब <UserRateCondition>, <RateRule> का चाइल्ड होता है, तो <UserRateCondition> एलिमेंट में id एट्रिब्यूट नहीं हो सकता. साथ ही, किसी दूसरे <UserRateCondition> से इसका रेफ़रंस नहीं लिया जा सकता.

<RateModification> Optional <RateModification> यह नीति, निजी रेट के लिए यूज़र इंटरफ़ेस (यूआई) इस्तेमाल करने के तरीके में बदलाव करती है.
<PromoCode> Optional string इस नीति से, दर से जुड़ा कोड बताता है. ऐसा तब होता है, जब दर का यह नियम लागू होता है. PROMO-CODE लैंडिंग पेज वैरिएबल में दिखाया गया.

<UserRateCondition>

एक या इससे ज़्यादा ऐसी शर्तों के बारे में बताता है जो मेल खाने पर खास किराये या निजी किराये के तौर पर दिखाए जाते हैं.

रेट के नियमों की एक्सएमएल हैरारकी में, <UserRateCondition> एलिमेंट इस जगह पर दिखता है:

+ <RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

सिंटैक्स

<UserRateCondition> एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings ...>
  <!-- "op" is required for more than one child element -->
  <UserRateCondition id="some_id" op="[all|any|none]">
    <UserDeviceType>device_type</UserDeviceType>
  </UserRateCondition>
  <UserRateCondition id="some_other_id" op="[all|any|none]">
    <UserDeviceType>device_type</UserDeviceType>
  </UserRateCondition>
  <!-- At least one RateRule is required -->
  <RateRule id="rate_rule_id">
    <UserRateCondition reference id="some_id"/>
  </RateRule>
  <RateRule id="rate_rule_id">
    <UserRateCondition reference id="some_other_id"/>
  </RateRule>
  <RateRule id="rate_rule_id">
    <UserRateCondition>
      <UserDeviceType>device_type</UserDeviceType>
    </UserRateCondition>
  </RateRule>
<span class="nocode"></RateRuleSettings></span>

विशेषताएं

<UserRateCondition> एलिमेंट में ये एट्रिब्यूट मौजूद हैं:

एट्रिब्यूट ज़रूरी है? टाइप कंपनी का ब्यौरा
id Required (if top-level under <RateRuleSettings>) string

इस <UserRateCondition> के लिए यूनीक आइडेंटिफ़ायर. इसकी जानकारी <RateRule> id एट्रिब्यूट या <UserRateCondition> reference_id एट्रिब्यूट से दी जा सकती है.

op Optional enum

जब <UserRateCondition> में एक से ज़्यादा चाइल्ड एलिमेंट होते हैं, तो op एट्रिब्यूट की ज़रूरत होती है. एट्रिब्यूट की वैल्यू इनमें से कोई एक हो सकती है:

  • all: ऐसे असली उपयोगकर्ताओं को शामिल करें जो दर के इस नियम में तय की गई सभी शर्तों को पूरा करते हैं. अगर कोई एक शर्त <UserListId> है, तो इस वैल्यू का इस्तेमाल नहीं किया जा सकता. ऐसा सिर्फ़ तब होगा, जब कोई एक शर्त या तो <AlwaysEligibleMembershipProgram> या <MembershipProgram> तय न की गई हो.
  • any: ऐसे असली उपयोगकर्ताओं को शामिल करें जो दर के इस नियम में बताई गई किसी भी शर्त को पूरा करते हैं.
  • none: ऐसे असली उपयोगकर्ताओं को बाहर रखें जो दर के इस नियम में बताई गई किसी भी शर्त को पूरा करते हैं. अगर कोई एक शर्त <UserListId> है, तो इस वैल्यू का इस्तेमाल नहीं किया जा सकता.
reference_id Optional string

इस एलिमेंट को id के साथ, पहले से तय किसी अन्य <UserRateCondition> के रेफ़रंस के तौर पर बताता है.

reference_id के मौजूद होने पर:

  • चाइल्ड तत्वों को पार्स नहीं किया जा सकता
  • id और op मौजूद नहीं होने चाहिए

चाइल्ड एलीमेंट

<UserRateCondition> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट ज़रूरी है? टाइप कंपनी का ब्यौरा
<AlwaysEligibleMembershipProgram> Optional string

इससे पता चलता है कि दर, सदस्य के लिए तय की गई दर के यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट का इस्तेमाल करती है.

इस एलिमेंट की वैल्यू, पैसे चुकाकर लिए जाने वाले सदस्यता प्रोग्राम का कोई भी नाम हो सकता है.

<Description> Optional string <UserRateCondition> के बारे में बताता है. ऐसा दस्तावेज़ के लिए किया गया है. इससे इसकी क्षमताओं पर कोई असर नहीं पड़ता.
<LanguageCode> Optional string इससे यह तय होता है कि यह दर उन लोगों को ऑफ़र की जाएगी जिनकी भाषा, इस दो अक्षर वाले भाषा कोड से मेल खाती है.
<MaxUsersPercent> Optional float

इससे पता चलता है कि असली उपयोगकर्ताओं के इस प्रतिशत को दर रैंडम तरीके से ऑफ़र की जाएगी.

यह वैल्यू 0 से 100 के बीच की कोई संख्या होनी चाहिए. उदाहरण के लिए, अगर 20 उपयोगकर्ता, 20% असली उपयोगकर्ताओं को टारगेट करते हैं.

<MembershipProgram> Optional string

इससे पता चलता है कि दर, <RateIneligibility> के <IneligibilityReason> के मुताबिक, सदस्यता कार्यक्रम के यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट का इस्तेमाल करेगी.

<MembershipProgram> मान्य हो, इसके लिए <RateIneligibility> तय करना ज़रूरी है.

<MembershipProgram> की वैल्यू, पैसे चुकाकर लिए जाने वाले सदस्यता प्रोग्राम का कोई भी नाम हो सकता है.

<UserRateCondition> Optional <UserRateCondition>

एक या इससे ज़्यादा ऐसी शर्तों के बारे में बताता है जो मेल खाने पर शर्तों के साथ या निजी किराये पर मिलती हैं.

reference_id वाले <UserRateCondition> में 0 बच्चा होना चाहिए.

<UserCountry> Optional string

CLDR देश का कोड, जैसे कि DE या FR. ध्यान दें कि कुछ देशों में, CLDR कोड और दो अक्षरों वाले ISO कोड एक जैसे नहीं होते. इलाके के CLDR कोड का इस्तेमाल नहीं किया जा सकता.

इससे पता चलता है कि उपयोगकर्ता चुने गए देश में मौजूद होना चाहिए. Google, असली उपयोगकर्ता के देश का पता लगाने के लिए, उनके आईपी पते का इस्तेमाल करता है.

<UserDeviceType> Optional enum डिवाइस टाइप की स्थिति के बारे में बताता है. इन वैल्यू का इस्तेमाल किया जा सकता है:
  • mobile
  • desktop
  • tablet
<UserListId> Optional string ऑडियंस की सूची का Google Ads उपयोगकर्ता सूची आईडी.

इस शर्त का इस्तेमाल सिर्फ़ <AlwaysEligibleMembershipProgram> या <MembershipProgram> के साथ किया जा सकता है या जब op, any हो.

<UserSignedIn> Optional boolean यह एक बूलियन है. इससे पता चलता है कि उपयोगकर्ता को अपने Google खाते में साइन इन करना चाहिए या नहीं. true की वैल्यू का मतलब है कि उपयोगकर्ता को साइन इन करना होगा. false वैल्यू का मतलब है कि उपयोगकर्ता को साइन इन नहीं करना चाहिए. अगर आपको इस बात से फ़र्क़ नहीं पड़ता कि उपयोगकर्ता ने साइन इन किया है या नहीं, तो <UserSignedIn> शर्त को शामिल न करें.
<IsDomestic> Optional boolean यह एक बूलियन है. इससे पता चलता है कि उपयोगकर्ता उसी देश का है या नहीं जहां होटल मौजूद है. true वैल्यू का मतलब है कि उपयोगकर्ता और होटल एक ही देश में होने चाहिए. false की वैल्यू से यह पता चलता है कि उपयोगकर्ता, होटल वाले देश के अलावा किसी और देश से हो सकता है. अगर आपको ज़्यादा कंट्रोल चाहिए, तो <UserCountry> शर्त का इस्तेमाल करें.

खास किराया तय करने के उदाहरण

उपयोगकर्ताओं का प्रतिशत

शर्तों के इस उदाहरण में बताया गया है कि यह दर बीस प्रतिशत उपयोगकर्ताओं को बिना किसी क्रम के दी जाएगी:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="20_percent_users">
    <UserRateCondition>
      <MaxUsersPercent>20</MaxUsersPercent>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

यूनाइटेड किंगडम और मोबाइल उपयोगकर्ता

शर्तों के साथ यहां दिए गए किराये के उदाहरण में किराये के एक नियम के बारे में बताया गया है. यह नियम, यूनाइटेड किंगडम में मोबाइल डिवाइस की मदद से खोज करने वाले सभी लोगों से मेल खाता है. इसके लिए, इनलाइन <UserRateCondition> का इस्तेमाल किया जाता है:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="gb_mobile">
    <UserRateCondition op="all">
      <UserCountry>GB</UserCountry>
      <UserDeviceType>mobile</UserDeviceType>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

जापान, न कि जापान

शर्तों के साथ यहां दिए गए उदाहरण में, किराये का एक नियम दिखाया गया है जो जापान के लोगों से मेल खाता है. वहीं, किराये का दूसरा नियम दुनिया के बाकी देशों के उपयोगकर्ताओं से मेल खाता है.

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="jp">
    <UserRateCondition>
      <UserCountry>jp</UserCountry>
    </UserRateCondition>
  </RateRule>
  <RateRule id="row_not_jp">
    <UserRateCondition op="none">
      <UserCountry>jp</UserCountry>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

कोई भी, सभी और कोई नहीं

शर्तों के साथ यहां दिए गए किराये के उदाहरण में यह दिखाया गया है कि any, all, और none वैल्यू का इस्तेमाल करके, op एट्रिब्यूट को कई शर्तों के हिसाब से अलग-अलग तरीकों से कैसे इस्तेमाल किया जा सकता है. उदाहरण के लिए, जैसा कि au_nz शर्त में दिखाया गया है, किसी भी देश के उपयोगकर्ताओं से मैच करने के लिए, किसी भी देश का इस्तेमाल किया जा सकता है. जैसा कि au_nz_mobile_tablet के किराये के नियम में बताया गया है, आपके पास all का इस्तेमाल करके यह पक्का करने का विकल्प होता है कि उपयोगकर्ता एक से ज़्यादा शर्तों को पूरा करें. दर का row_mobile_tablet नियम, ऑस्ट्रेलिया और न्यूज़ीलैंड को छोड़कर, बाकी दुनिया (पंक्ति) में रहने वाले उपयोगकर्ताओं से मैच करेगा और mobile_tablet शर्त से भी मेल खाएगा.

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <UserRateCondition id="au_nz" op="any">
    <UserCountry>AU</UserCountry>
    <UserCountry>NZ</UserCountry>
  </UserRateCondition>
  <UserRateCondition id="mobile_tablet" op="any">
    <UserDeviceType>mobile</UserDeviceType>
    <UserDeviceType>tablet</UserDeviceType>
  </UserRateCondition>
  <RateRule id="au_nz_mobile_tablet">
    <UserRateCondition op="all">
      <UserRateCondition reference_id="au_nz"/>
      <UserRateCondition reference_id="mobile_tablet"/>
    </UserRateCondition>
  </RateRule>
  <RateRule id="row_mobile_tablet">
    <UserRateCondition op="all">
      <UserRateCondition op="none">
        <UserRateCondition reference_id="au_nz"/>
      </UserRateCondition>
      <UserRateCondition reference_id="mobile_tablet"/>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

निजी किराये के उदाहरण

सदस्यों के लिए किराया 1 दिख रहा है

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="member_visible">
    <UserRateCondition>
      <AlwaysEligibleMembershipProgram>[enter your program here]</AlwaysEligibleMembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

सदस्यों के लिए किराया 2

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="member_visible_es_only">
    <UserRateCondition op="all">
      <AlwaysEligibleMembershipProgram>[enter your program here]</AlwaysEligibleMembershipProgram>
      <UserCountry>es</UserCountry>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

ऑडियंस की सूची की दर 1

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="audience_list">
    <UserRateCondition>
      <UserListId>[enter an audience list id]</UserListId>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

ऑडियंस सूची की दर 2

निजी किराये के इस उदाहरण में, ऑडियंस की एक से ज़्यादा सूचियों के लिए, सदस्यों के लिए दिखने वाले किराये की जानकारी देने का तरीका बताया गया है:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <UserRateCondition op="all">
      <AlwaysEligibleMembershipProgram>[enter the program name here]</AlwaysEligibleMembershipProgram>
      <UserRateCondition op="any">
        <UserListId>[enter one audience list id here]</UserListId>
        <UserListId>[enter another audience list id here]</UserListId>
      </UserRateCondition>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

<RateIneligibility>

इससे यह पता चलता है कि सदस्यों के लिए तय की गई दर को, छिपे हुए यूज़र इंटरफ़ेस (यूआई) के तौर पर दिखाने का तरीका क्या है. इस नीति को शामिल न करने पर, सदस्यों के लिए तय की गई दर से छिपा हुआ यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट नहीं दिखाया जाता.

<RateRule> में <RateIneligibility> का इस्तेमाल करने के लिए, <RateRule> के लिए <UserRateCondition> एलिमेंट में <MembershipProgram> की जानकारी देना ज़रूरी है.

<RateIneligibility> एलिमेंट, रेट के नियमों के एक्सएमएल की हैरारकी में इस जगह पर दिखता है:

+ 
<RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

सिंटैक्स

<RateIneligibility> एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings ...>
  <UserRateCondition ...>
  ...
  </UserRateCondition>
  <RateRule ...>
    <UserRateCondition ...>
      ...
      <!-- Required when using RateIneligibility -->
      <MembershipProgram>program_name</MembershipProgram>
      ...
    </UserRateCondition>
    <RateIneligibility>
      <IneligibilityType>[exact|price_band|existence]</IneligibilityType>
      <IneligibilityReason>[program_member]</IneligibilityReason>
    </RateIneligibility>
  </RateRule>
</RateRuleSettings>

विशेषताएं

<RateIneligibility> एलिमेंट में कोई एट्रिब्यूट नहीं है.

चाइल्ड एलीमेंट

<RateIneligibility> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट ज़रूरी है? टाइप कंपनी का ब्यौरा
<IneligibilityType> Required enum

इससे यह तय होता है कि टेक्स्ट (क्रॉस-आउट रेट के बगल में दिखेगा) छिपी हुई दर के बारे में कैसे बताएगा.

मान्य मान हैं:

  • exact: छूट का प्रतिशत. टेक्स्ट में लिखा होगा, "बिना किसी शुल्क के रजिस्टर करें और X% की छूट पाएं."
  • price_band: छूट की सीमा. टेक्स्ट में लिखा होगा, "बिना किसी शुल्क के रजिस्टर करें और X-Y% की छूट पाएं." 1 से 5% की छूट के लिए, इस टेक्स्ट में "5% तक की छूट पाएं" लिखा होगा. बड़ी छूट, पांच पॉइंट के हिसाब से दिखाई जाएंगी. जैसे, "5 से 10% की छूट पाएं" या "10 से 15% की छूट पाएं."
  • existence: खास संकेत के बारे में नहीं. ऐसे मामले में, यह टेक्स्ट दिखेगा: "बिना किसी शुल्क के रजिस्टर करने पर, कम कीमत का फ़ायदा पाएं."

निजी किराये की जानकारी और उदाहरण में जाकर, यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट के बारे में ज़्यादा जानें.

<IneligibilityReason> Required enum

मान्य मान हैं:

  • program_member: सदस्य दर छिपाए गए यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट का इस्तेमाल करके, दर दिखाता है.

निजी किराये के उदाहरण

इस सेक्शन में, सदस्यों की दर के छिपे हुए उदाहरण (बुनियादी दर) और सदस्यों के लिए छिपाए जाने वाले किराये के उदाहरण (एक से ज़्यादा शर्तें) शामिल हैं. उपयोगकर्ताओं के सबसेट को भी सदस्यों से लिया जाने वाला किराया दिखाया जा सकता है. उदाहरणों के लिए, निजी किराये के उदाहरण देखें.

सदस्यों के लिए किराये के छिपे हुए उदाहरण (बुनियादी जानकारी)

बिलकुल सही छूट

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>exact</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition>
      <MembershipProgram>[enter program name here]</MembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

बैंड पर मिलने वाली छूट

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>price_band</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition>
      <MembershipProgram>[enter program name here]</MembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

हिंट डिस्काउंट

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>existence</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition>
      <MembershipProgram>[enter program name here]</MembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

सदस्यों के लिए किराये की जानकारी छिपाने के उदाहरण (एक से ज़्यादा शर्तें)

op="any"

सदस्यों के लिए ऑडियंस की सूची की दर + उन सदस्यों के लिए दर छिपा दी गई है जो सदस्यता नहीं लेते हैं (फ़िलहाल, सदस्यता न लेने वाले दर्शकों के लिए छूट वाली कीमत)

निजी किराये के उदाहरण से, सदस्यों के लिए किराये की छिपी हुई दर के existence टाइप के बारे में पता चलता है. इसे लोगों को दिखाया जाएगा, न कि ऑडियंस की सूची को. ऑडियंस की सूची में मौजूद उपयोगकर्ताओं को ऑडियंस रेट दिखेगा.

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>existence</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition op="any">
      <MembershipProgram>[enter program name here]</MembershipProgram>
      <UserListId>[enter you audience list id here]</UserListId>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

op="all"

सिर्फ़ ऑडियंस की सूची के उपयोगकर्ताओं के लिए सदस्यों के लिए तय की गई दर छिपाई गई

निजी किराये के इस उदाहरण में, सदस्य के लिए दिखाए जाने वाले exact टाइप के विकल्प के बारे में बताया गया है. हालांकि, यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट के दौरान, इसमें अतिरिक्त टेक्स्ट "मुफ़्त वाई-फ़ाई" शामिल किया गया है. यूज़र इंटरफ़ेस (यूआई) की यह सुविधा, ऑडियंस की सूची से मेल खाने वाले उपयोगकर्ताओं को दिखेगी.

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program_for_audience_list">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>exact</IneligibilityType>
    </RateIneligibility>
    <RateModification>
      <HotelAmenity>free_wifi</HotelAmenity>
    </RateModification>
    <UserRateCondition op="all">
      <MembershipProgram>[enter program name here]</MembershipProgram>
      <UserListId>[enter you audience list id here]</UserListId>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

पारदर्शी/दिखने वाला यूज़र इंटरफ़ेस (यूआई)

इस उदाहरण में, ऑडियंस की सूची में मौजूद उपयोगकर्ताओं के लिए दो यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट (पारदर्शी और दिखने वाले यूज़र इंटरफ़ेस) की मदद से, सदस्य दर तय करने का तरीका बताया गया है. साथ ही, बाकी सभी उपयोगकर्ताओं के लिए, छिपी हुई दरों की जानकारी देने का तरीका भी बताया गया है.

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>existence</IneligibilityType>
    </RateIneligibility>
    <UserRateCondition op="any">
      <MembershipProgram>[enter program name here]</MembershipProgram>
      <UserRateCondition op="all">
        <UserListId>[enter you audience list id here]</UserListId>
        <AlwaysEligibleMembershipProgram>program_name</AlwaysEligibleMembershipProgram>
      </UserRateCondition>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

<RateModification>

यह नीति, निजी रेट के लिए यूज़र इंटरफ़ेस (यूआई) इस्तेमाल करने के तरीके में बदलाव करती है.

रेट के नियमों की एक्सएमएल हैरारकी में, <RateModification> एलिमेंट इस जगह पर दिखता है:

+ 
<RateRuleSettings>
    + <UserRateCondition>
    + <RateRule>
        + <UserRateCondition>
        + <RateIneligibility>
        + <RateModification>

विशेषताएं

<RateModification> एलिमेंट में कोई एट्रिब्यूट नहीं है.

चाइल्ड एलीमेंट

<RateModification> एलिमेंट में ये चाइल्ड एलिमेंट होते हैं:

चाइल्ड एलिमेंट ज़रूरी है? टाइप कंपनी का ब्यौरा
<HotelAmenity> Optional enum

सदस्यों के लिए तय किए गए छिपे हुए यूज़र इंटरफ़ेस (यूआई) ट्रीटमेंट में बदलाव करने के लिए, <MembershipProgram> और <RateIneligibility> के साथ जोड़ें.

मान्य मान हैं:

  • free_wifi: टेक्स्ट में plus free wifi जोड़ता है.
<PriceMultiplier> Optional float

कीमत में बदलाव करने के लिए, इस वैल्यू को मूल दर, टैक्स, और शुल्क से गुणा किया जाता है. उदाहरण के लिए, अगर PriceMultiplier = 0.9, मूल दर = 100 डॉलर, टैक्स = 20 डॉलर, शुल्क = 10 डॉलर; फिर मल्टीप्लायर लागू करने के बाद: मूल दर = 90 डॉलर, टैक्स = 18 डॉलर, शुल्क = 9 डॉलर.

इससे आपको एक खास दर के नियम के हिसाब से, सभी दरों पर छूट लागू करने की सुविधा मिलती है.

निजी किराये के उदाहरण

होटल की सुविधाएं

सभी लोगों के लिए, बैंड के सदस्यों के लिए अलग से किराया दिखाने की सुविधा (बैंड पर मिलने वाली छूट) और मुफ़्त वाई-फ़ाई की सुविधा

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="membership_program">
    <RateIneligibility>
      <IneligibilityReason>program_member</IneligibilityReason>
      <IneligibilityType>price_band</IneligibilityType>
    </RateIneligibility>
    <RateModification>
      <HotelAmenity>free_wifi</HotelAmenity>
    </RateModification>
    <UserRateCondition>
      <MembershipProgram>[enter program name here]</MembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

मूल्य गुणक

कीमत फ़ीड में मोबाइल दरों पर 5% की छूट लागू करें

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="mobile">
    <RateModification>
      <PriceMultiplier>0.95</PriceMultiplier>
    </RateModification>
    <UserRateCondition>
      <UserDeviceType>mobile</UserDeviceType>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>