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

किराये के नियमों वाली एक्सएमएल फ़ाइल में, खास किराये और निजी किराये दिखाने के नियम बताए गए हैं. 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

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

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

इस एलिमेंट को, पहले से तय किए गए किसी ऐसे <UserRateCondition> के रेफ़रंस के तौर पर परिभाषित करता है जिसके id मैच करते हैं.

जब 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 कोड और दो अक्षरों वाला आईएसओ कोड एक जैसा नहीं होता. 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>

यहां दिए गए किराये के उदाहरण में, किराये का एक नियम दिखाया गया है जो जापान के उपयोगकर्ताओं से मैच करता है. साथ ही, किराये का एक और नियम दिखाया गया है जो दुनिया के बाकी हिस्सों (RoW) के उपयोगकर्ताओं से मैच करता है:

<?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>

यहां दिए गए, खास किराये के उदाहरण से पता चलता है कि op एट्रिब्यूट का इस्तेमाल करके, any, all, और none वैल्यू का इस्तेमाल करके, अलग-अलग तरीकों से कई शर्तों को मैच कैसे किया जा सकता है. उदाहरण के लिए, 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>

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

Member rate visible 1सदस्यों के लिए किराया दिख रहा है 2ऑडियंस सूची की दर 1ऑडियंस सूची की दर 2
<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="member_visible">
    <UserRateCondition>
      <AlwaysEligibleMembershipProgram>[enter your program here]</AlwaysEligibleMembershipProgram>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>


<?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>


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

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

<?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-पॉइंट के हिसाब से दिखाई जाएगी. जैसे, "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"op="all"पारदर्शी/दिखने वाला यूज़र इंटरफ़ेस (यूआई)

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

निजी किराये के इस उदाहरण में, सदस्यों के लिए तय की गई किराये की जानकारी को छिपाने के लिए, यूज़र इंटरफ़ेस (यूआई) में बदलाव करने का 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>

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

निजी किराये के इस उदाहरण में, 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>