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

<RateRule>

Required

<RateRule>

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

<UserRateCondition>

Optional

<UserRateCondition>

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

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

<UserRateCondition> ברמה העליונה מתחת ל-<RateRuleSettings> חייב להיות עם המאפיין id.

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

בדוגמאות הבאות מוצגות דרכים בסיסיות להגדרת תעריפים בלעדיים.

מומלץ להפנות לתנאים מוגדרים מראש, כפי שמוצג בדוגמה של Mobile users.

משתמשים בנייד

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

id

חובה

מחרוזת

מזהה ייחודי של כלל התמחור. יש הפניה למזהה הזה באמצעות המאפיין 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>`. ניתן להפנות באמצעות מאפיין `id` `<RateRule>` או המאפיין `<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>. ניתן להפנות באמצעות מאפיין id <RateRule> או המאפיין <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>`.

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

אחוז המשתמשים

הדוגמה הבאה של תעריפים מותנים מציינת שהתעריף יוצע באופן אקראי לעשרים אחוזים מהמשתמשים:

<?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 של מחיר לחברים מוסתר בממשק המשתמש, ששונה עם הטקסט הנוסף "plus free 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>