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

id

חובה

מחרוזת

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

אפשר להזין עד 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>`.

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

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

הדוגמה הבאה של התעריפים המותנים מציינת שהתעריף יהיה מוצע באופן אקראי ל-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) יתאים למשתמשים שנמצאים בשאר הקהלים בעולם (row), לא כולל אוסטרליה וניו זילנד, וגם תנאי 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>

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

<RateRuleSettings>

תחביר

מאפיינים

רכיבי צאצא

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

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

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

<RateRule>

תחביר

מאפיינים

רכיבי צאצא

<UserRateCondition>

תחביר

מאפיינים

רכיבי צאצא

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

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

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

יפן ולא יפן

הכול, אף אחד

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

מחיר החברות במועדון גלוי 1

מחיר החברות במועדון גלוי 2

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

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

<RateIneligibility>

תחביר

מאפיינים

רכיבי צאצא

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

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

הנחה מדויקת

הנחה על רצועה

רמז להנחה

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

op=&quot;any&quot;

op=&quot;all&quot;

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

<RateModification>

מאפיינים

רכיבי צאצא

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

שירותי המלון

מכפיל מחיר

`<RateRuleSettings>`

`<RateRule>`

`<UserRateCondition>`

`<RateIneligibility>`

op="any"

op="all"

`<RateModification>`