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

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

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

<RateRuleSettings>

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

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

  • <RateRule> तत्व, जिनमें से प्रत्येक, लेन-देन संदेश में <Rate> में संदर्भ के लिए एक दर नियम निर्धारित करता है. प्रत्येक <RateRule> उन शर्तों और UI उपचार को निर्दिष्ट करता है जो सशर्त या निजी दर का निर्माण करते हैं.

<RateRuleSettings> तत्व दर नियम XML पदानुक्रम में निम्न स्थान पर दिखाई देता है:

+ <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> तत्व दर नियम XML पदानुक्रम में निम्न स्थान पर दिखाई देता है:

+ 
<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 को लैंडिंग पृष्ठ URL में वैरिएबल और शर्तों का उपयोग करके भी संदर्भित किया जा सकता है.

ज़्यादा से ज़्यादा 40 वर्ण इस्तेमाल किए जा सकते हैं. इस आईडी को खाली स्ट्रिंग नहीं छोड़ा जा सकता.

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

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

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

यह सिर्फ़ तब मान्य होता है, जब <UserRateCondition> में <MembershipProgram> की वैल्यू दी गई हो.
<UserRateCondition> Required <UserRateCondition>

एक या अधिक शर्तें परिभाषित करता है, जिनके मिलान होने पर सशर्त या निजी दरें प्रदान की जाती हैं.

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

हालांकि, ध्यान दें कि जब <UserRateCondition>, <RateRule> का चाइल्ड होता है, तब <UserRateCondition> एलिमेंट में id एट्रिब्यूट नहीं हो सकता. साथ ही, इसे किसी दूसरे <UserRateCondition> से रेफ़रंस नहीं किया जा सकता.
<RateModification> Optional <RateModification> निजी दरों के लिए UI उपचार को संशोधित करता है.
<PromoCode> Optional string अगर किराये से जुड़ा यह नियम लागू होता है, तो इस कोड को किराये से जोड़ा जाएगा. PROMO-CODE लैंडिंग पेज वैरिएबल में दिखता है.

<UserRateCondition>

एक या अधिक शर्तें परिभाषित करता है, जिनके मिलान होने पर सशर्त या निजी दरें प्रदान की जाती हैं.

<UserRateCondition> तत्व दर नियम XML पदानुक्रम में निम्न स्थान पर दिखाई देता है:

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

इस एलिमेंट को, पहले से तय किए गए किसी दूसरे <UserRateCondition> के रेफ़रंस के तौर पर तय करता है. इसमें id मेल खाना चाहिए.

जब reference_id मौजूद हो, तब:

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

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

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

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

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

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

ध्यान दें>: हमारा सुझाव है कि आप जहां भी हो सके वहां <LanguageCode> के बजाय <UserCountry> का इस्तेमाल करें.
<MaxUsersPercent> Optional float

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

वैल्यू, 0 और 100 के बीच का कोई पूर्णांक होना चाहिए. हालांकि, इन दोनों में से भी कोई संख्या हो सकती है. उदाहरण के लिए, 20 से असली उपयोगकर्ताओं के 20% हिस्से को टारगेट किया जाएगा.
<MembershipProgram> Optional string

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

<MembershipProgram> की वैल्यू मान्य होने के लिए, <RateIneligibility> की वैल्यू तय होनी चाहिए.

<MembershipProgram> की वैल्यू, सदस्यता कार्यक्रम का कोई भी नाम हो सकती है.
<UserRateCondition> Optional <UserRateCondition>

एक या उससे ज़्यादा ऐसी शर्तें तय करता है जिनके पूरा होने पर, खास किराये या निजी किराये के नियम लागू होते हैं.

reference_id वाले <UserRateCondition> में 0 चाइल्ड होने चाहिए.
<UserCountry> Optional string

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

यह निर्दिष्ट करता है कि उपयोगकर्ता निर्दिष्ट देश में स्थित होना चाहिए. गूगल अंतिम उपयोगकर्ता के देश का निर्धारण उसके आईपी पते से करता है.
<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>

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

सदस्य दर दृश्यमान 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

यह निजी दरों का उदाहरण दिखाता है कि एकाधिक ऑडियंस सूचियों के लिए सदस्य दर दृश्यमान UI उपचार कैसे निर्दिष्ट किया जाए:

<?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> तत्व दर नियम XML पदानुक्रम में निम्न स्थान पर दिखाई देता है:

+ 
<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% छूट पाएं." एक से पांच प्रतिशत तक की छूट के लिए, टेक्स्ट में "पांच प्रतिशत तक की छूट पाएं" लिखा होगा. ज़्यादा छूट को पांच-पांच पॉइंट के अंतर से दिखाया जाएगा. जैसे, "5 से 10% की छूट पाएं" या "10 से 15% की छूट पाएं."
  • existence: सामान्य जानकारी देने वाला कोई सुराग. इस मामले में, टेक्स्ट इस तरह दिखेगा: "बिना किसी शुल्क के रजिस्टर करें और कम कीमत में खरीदारी करें."

निजी दरों के विवरण और उदाहरण में UI उपचारों के बारे में अधिक जानें.
<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 प्रकार के सदस्य दर छिपे हुए UI उपचार को निर्दिष्ट करता है, जो उपयोगकर्ताओं को दिखाया जाएगा, न कि ऑडियंस सूची को. दर्शक सूची में मौजूद उपयोगकर्ताओं को दर्शक दर दिखाई देगी.

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

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

यह उदाहरण दिखाता है कि ऑडियंस सूची में उपयोगकर्ताओं के लिए दो UI उपचारों (पारदर्शी और दृश्यमान UI) के साथ सदस्य दर और अन्य सभी उपयोगकर्ताओं के लिए छिपी हुई दरें कैसे निर्दिष्ट की जाती हैं.

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

निजी दरों के लिए UI उपचार को संशोधित करता है.

<RateModification> एलिमेंट, दर के नियमों के XML स्ट्रक्चर में यहां दिखता है:

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