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

<RateRule>

Required

<RateRule>

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

<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>
      <PackageType>[direct_offer]</PackageType>
    </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>
    <PackageType>package_type</PackageType>
  </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	מציין שהשער יוצע למשתמשים שהשפה שלהם תואמת לקוד השפה הזה בן שתי האותיות. הערה>: מומלץ להשתמש ב-`<UserCountry>` במקום ב-`<LanguageCode>` בכל מקום שאפשר.
`<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>`.
`<PackageType>`	Optional	enum	הגדרה של התנאי 'סוג החבילה'. הערכים המותרים הם: `direct_offer` הערה: `direct_offer` הוא סוג מיוחד של מחיר שמוצע על ידי מפרסם, לא זמין לציבור וטוב יותר מהמחיר הציבורי הטוב ביותר.

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

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

בדוגמה הבאה של תעריפים בלעדיים מצוין שהתעריף יוצע באופן אקראי ל-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, אפשר להשתמש ב-any כדי להתאים משתמשים בכל אחת מכמה מדינות. כפי שמוצג בכלל התעריף 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>

הנחה על כרטיס Band

<?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 סוג המחיר המיוחד לחברי מועדון hidden UI treatment, ששונה באמצעות הטקסט הנוסף plus free Wi-Fi (בתוספת 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>

מבצע למימוש ישיר

החלת הנחה של 15% על התעריפים של המבצעים הישירים בנייד בפיד המחירים

<?xml version="1.0" encoding="UTF-8"?>
<RateRuleSettings>
  <RateRule id="do-mobile">
    <RateModification>
      <PriceMultiplier>0.85</PriceMultiplier>
    </RateModification>
    <UserRateCondition>
      <UserDeviceType>mobile</UserDeviceType>
      <PackageType>direct_offer</PackageType>
    </UserRateCondition>
  </RateRule>
</RateRuleSettings>

קובץ XML עם כללי תמחור לעיון קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

<RateRuleSettings>

תחביר

מאפיינים

רכיבי צאצא

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

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

משתמשים בארה"ב

<RateRule>

תחביר

מאפיינים

רכיבי צאצא

<UserRateCondition>

תחביר

מאפיינים

רכיבי צאצא

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

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

משתמשים בבריטניה ובנייד

יפן ולא יפן

כל, חלק ואף אחד

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

מחיר לחברים גלוי 1

מחיר לחברים גלוי 2

שיעור ההמרה של רשימת קהלים 1

שיעור ההמרה של רשימת קהלים 2

<RateIneligibility>

תחביר

מאפיינים

רכיבי צאצא

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

דוגמאות להסתרת מחיר לחברי מועדון (בסיסי)

הנחה מדויקת

הנחה על כרטיס Band

הנחה על רמז

דוגמאות להסתרה של מחיר לחברי מועדון (כמה תנאים)

op="any"

op="all"

ממשק משתמש שקוף/גלוי

<RateModification>

מאפיינים

רכיבי צאצא

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

שירותי מלון

מכפיל מחיר

מבצע למימוש ישיר

קובץ XML עם כללי תמחור לעיון

`<RateRuleSettings>`

`<RateRule>`

`<UserRateCondition>`

`<RateIneligibility>`

`<RateModification>`