דף זה תורגם על ידי Cloud Translation API.

קובץ עזר ב-XML של כללי דירוג

קובץ ה-XML של כללי התעריפים מגדיר את הכללים להצגת תעריפים בלעדיים ותעריפים פרטיים. אפשר להוסיף או לערוך קובץ XML של כללי תמחור דרך הדף כללי תמחור ב-Hotel Center. במאמר תעריפים בלעדיים ותעריפים פרטיים תוכלו לקרוא מידע נוסף על תעריפים בלעדיים ותעריפים פרטיים.

לכל כלל תמחור נדרש id, שאליו אפשר להפנות בהודעה על העסקה במסגרת <Rate>. התג <Rate> שמפנה למזהה של כלל תמחור מוצג רק למשתמשים בהתאם לתנאים שהוגדרו על ידי כלל התמחור. אפשר גם להפנות למזהה של כלל תמחור באמצעות משתנה בכתובת דף הנחיתה.

`<RateRuleSettings>`

רכיב הבסיס של קובץ ה-XML של כללי התמחור. הרכיב <RateRuleSettings> (לשעבר <PrivateRates>) מכיל:

רכיבי <UserRateCondition> שמגדירים את התנאים להתאמה בתעריפים בלעדיים ובתעריפים פרטיים. לדוגמה, אפשר ליצור תעריף מותנה שתואם למצב של כל המשתמשים במדינה מסוימת.
רכיבי <RateRule> שכל אחד מהם מגדיר כלל תמחור להפניה ב-<Rate> בהודעה לגבי עסקה. כל <RateRule> מציינים את התנאים ואת אופן הטיפול בממשק המשתמש שיוצרים קצב תנאי או קצב פרטי.

הרכיב <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>`, על ידי הפניה לרכיב `<UserRateCondition>` אחר באמצעות המאפיין `reference_id`, או גם בתוך השורה וגם באמצעות הפניה. עם זאת, לכל `<UserRateCondition>` עם `reference_id` חייבים להיות 0 ילדים. `<UserRateCondition>` ברמה העליונה מתחת ל-`<RateRuleSettings>` חייב לכלול את המאפיין `id`.

<RateRule>

Required

<RateRule>

מגדיר את תנאי ההתאמה, השינויים והזכאות להצגת תעריף מותנה או פרטי. צריך לציין את המאפיין id, שאפשר להפנות אליו ב<Rate> של ההודעה לגבי העסקה או ב כתובת דף הנחיתה.

<UserRateCondition>

Optional

<UserRateCondition>

מגדיר תנאי אחד או יותר שמתקיימים בו תנאים שהתוצאה שלהם היא הצגת תעריפים בלעדיים או פרטיים.

אפשר להגדיר תנאים בתוך השורה באמצעות רכיבי צאצא של <UserRateCondition>, על ידי הפניה לרכיב <UserRateCondition> אחר באמצעות המאפיין reference_id, או גם בתוך השורה וגם באמצעות הפניה. עם זאת, לכל <UserRateCondition> עם reference_id חייבים להיות 0 ילדים.

<UserRateCondition> ברמה העליונה מתחת ל-<RateRuleSettings> חייב לכלול את המאפיין 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`	חובה	string	מזהה ייחודי של כלל התמחור. ההפניה למזהה הזה כוללת באמצעות המאפיין `rate_rule_id` של `<Rate>` בהודעת העסקה כדי להציג תעריף מותנה או פרטי. אפשר להפנות גם לכלל התמחור `id` באמצעות משתנה ותנאים בכתובת דף הנחיתה. אפשר להזין עד 40 תווים.

id

חובה

string

מזהה ייחודי של כלל התמחור. ההפניה למזהה הזה כוללת באמצעות המאפיין rate_rule_id של <Rate> בהודעת העסקה כדי להציג תעריף מותנה או פרטי. אפשר להפנות גם לכלל התמחור id באמצעות משתנה ותנאים בכתובת דף הנחיתה.

אפשר להזין עד 40 תווים.

רכיבי צאצא

הרכיב <RateRule> כולל את רכיבי הצאצא הבאים:

רכיב צאצא	חובה?	סוג	תיאור
`<RateIneligibility>`	Optional	`<RateIneligibility>`	מציינת את הערכים שקובעים את אופן הטיפול הספציפי בממשק המשתמש לתעריף של `<MembershipProgram>`. תקף רק אם צוין `<MembershipProgram>` ב-`<UserRateCondition>`.
`<UserRateCondition>`	Required	`<UserRateCondition>`	מגדיר תנאי אחד או יותר שמתקיימים בו תנאים שהתוצאה שלהם היא הצגת תעריפים בלעדיים או פרטיים. אפשר להגדיר תנאים בתוך השורה באמצעות רכיבי צאצא של `<UserRateCondition>`, על ידי הפניה ל-`<UserRateCondition>` אחר באמצעות המאפיין `reference_id`, או גם בתוך השורה וגם באמצעות הפניה. עם זאת, שימו לב שכש-`<UserRateCondition>` הוא צאצא של `<RateRule>`, לאלמנט `<UserRateCondition>` לא יכול להיות מאפיין `id` ולא ניתן להפנות אליו באמצעות `<UserRateCondition>` אחר.
`<RateModification>`	Optional	`<RateModification>`	שינוי הטיפול בממשק המשתמש לתעריפים פרטיים.
`<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	המאפיין `op` נדרש אם ב-`<UserRateCondition>` יש מספר רכיבי צאצא. ערך המאפיין יכול להיות אחד מהערכים הבאים: `all`: הכללה של משתמשי קצה שתואמים לכל התנאים שהוגדרו על ידי כלל התמחור הזה. אי אפשר להשתמש בערך הזה כאשר אחד מהתנאים הוא `<UserListId>`, אלא אם מוגדר רק תנאי אחד נוסף — `<AlwaysEligibleMembershipProgram>` או `<MembershipProgram>`. `any`: כוללים משתמשי קצה שתואמים לאחד מהתנאים שהוגדרו על ידי כלל התמחור הזה. `none`: מחריגים משתמשי קצה שתואמים לאחד מהתנאים שהוגדרו על ידי כלל התמחור הזה. אי אפשר להשתמש בערך הזה כאשר אחד מהתנאים הוא `<UserListId>`.
`reference_id`	Optional	string	הגדרת הרכיב הזה כהפניה אל `<UserRateCondition>` אחר שהוגדר מראש עם `id` תואם. כאשר `reference_id` קיים: לא ניתן לנתח רכיבי צאצא אין לכלול את `id` ואת `op`

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	מציינת שתעריף ייעשה שימוש בטיפול בממשק המשתמש של תוכנית המינויים כפי שנקבע על ידי `<IneligibilityReason>` של `<RateIneligibility>`. כדי שהערך של `<MembershipProgram>` יהיה תקין, צריך לציין את `<RateIneligibility>`. הערך של `<MembershipProgram>` יכול להיות כל שם של תוכנית מועדון החברים.
`<UserRateCondition>`	Optional	`<UserRateCondition>`	מגדיר תנאי אחד או יותר שמתקיימים בו תנאים שהתוצאה שלהם היא הצגת תעריפים בלעדיים או פרטיים. ב-`<UserRateCondition>` עם `reference_id` חייבים להיות 0 ילדים.
`<UserCountry>`	Optional	string	קוד מדינה במאגר CLDR, כמו `DE` או `FR`. חשוב לשים לב שבמדינות מסוימות, קוד ה-CLDR הוא לא קוד ה-ISO בן 2 האותיות. אין תמיכה בקודי אזורים במאגר CLDR. מציינת שהמשתמש חייב להיות במדינה שצוינה. Google קובעת את המדינה של משתמש הקצה לפי כתובת ה-IP שלו.
`<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>

יפן ולא יפן

בדוגמה הבאה של תעריפים בלעדיים מוצג כלל תמחור אחד שתואם למשתמשים ביפן וכלל תמחור אחר שתואם למשתמשים בשאר העולם (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

הדוגמה הבאה של תעריפים פרטיים ממחישה איך לציין שיעור גלוי לחברי מועדון לקוחות בכמה רשימות קהלים:

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

מראה איך להציג את שיעור המשתמשים המוסתר בממשק המשתמש. אם הוא לא כלול, לא יוצג מאפיין ממשק המשתמש המוסתר של התעריף למנויים.

כדי להשתמש ב-<RateIneligibility> ב-<RateRule>, צריך לציין את <MembershipProgram> גם ברכיב <UserRateCondition> של <RateRule>.

הרכיב <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% בהרשמה בחינם'. להנחות 1-5%, יופיע הכיתוב "קבלו עד 5% הנחה". הנחות גדולות יותר יוצגו במרווחים של 5 נקודות, למשל 'קבלו 5-10% הנחה' או 'הנחה של 10-15%'. `existence`: רמז לא ספציפי. במקרה כזה, יופיע הכיתוב: "נרשמים במחיר נמוך יותר עם הרשמה בחינם". מידע נוסף על הטיפולים בממשק המשתמש זמין בפרטים ובדוגמאות של תעריפים פרטיים.
`<IneligibilityReason>`	Required	enum	הערכים החוקיים כוללים: `program_member`: מציג את המחיר לפי הטיפול המוסתר בממשק המשתמש של המחיר לחברי מועדון.

<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, ששונה מהטקסט הנוסף, "וגם Wi-Fi בחינם". הטיפול הזה בממשק המשתמש יוצג למשתמשים שתואמים לרשימת החברים בקהל.

<?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> מופיע במקום הבא בהיררכיית ה-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$. כך אפשר להחיל הנחה על כל התעריפים עם כלל תמחור מסוים.

<HotelAmenity>

Optional

enum

כדי לשנות את שיעור המשתמשים שמוסתרים בממשק המשתמש, צריך לשלב את השילוב עם <MembershipProgram> ו-<RateIneligibility>.

הערכים החוקיים כוללים:

free_wifi: הוספה של plus free wifi לטקסט.

<PriceMultiplier>

Optional

float

כדי לשנות את המחיר, מכפילים את הערך הזה במחיר הבסיס, במיסים ובעמלות. לדוגמה, אם PriceMultiplier = 0.9, תעריף הבסיס = 100$, מיסים = 20$, עמלות = 10$. אחרי החלת המכפיל: תעריף הבסיס = 90$, מיסים = 18$, עמלות = 9$.

כך אפשר להחיל הנחה על כל התעריפים עם כלל תמחור מסוים.

דוגמאות לתעריפים פרטיים

שירותי המלון

מחיר המינוי מוסתר לכל המשתמשים (הנחות תדרים) + Wi-Fi בחינם

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