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

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

<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

इस एलिमेंट के बारे में बताता है कि यह किसी ऐसे <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 कोड और दो अक्षर वाले 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> शर्त का इस्तेमाल करें.

खास दरों के उदाहरण

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

खास तौर पर तय की गई दरों के नीचे दिए गए उदाहरण से पता चलता है कि यह दर 20 प्रतिशत उपयोगकर्ताओं को किसी भी क्रम में दी जाएगी:

<?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> का इस्तेमाल करने के लिए, <MembershipProgram> की जानकारी, <RateRule> के <UserRateCondition> एलिमेंट में भी दी जानी चाहिए.

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

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

निजी किराये के इस उदाहरण में, सदस्यों के लिए छिपाए गए 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>