Bundle Settings

This topic contains information about the settings for both basic and compound bundles. 

Service Design Center uses a change management process to track and approve all changes to any product. All of these changes, including additions, edits, and deletions, must go through the promote-approve-deploy process before they become available.

Any changes you make (change a name, change a price, add or delete a product from a bundle, etc.) to any product do not affect any users that already have the product.

General Tab

The General tab contains most of the settings you will configure to determine how a bundle looks, acts, is priced, and more.

Appearance Settings

These settings define how information about a product will appear to customers.

Setting Description
Name Required. The name serves 2 primary purposes: it's what you see in product lists and it's what customers see as a descriptor when they are making purchase decisions. The name is limited to 115 characters.
Short Description Brief plain-text information about the bundle that sometimes appears with the bundle name. 
Marketing Message
The Marketing Message setting is available only in compound bundles.

Descriptive rich-text information about the bundle that appears on only the pre-purchase detail page above the content you add in the Description field. You can format the content you enter in several different ways using the functions in the toolbar.

This field is best for a small amount of marketing information that will help drive purchase decisions, such as offers customers will receive with purchase. Use the Description field for larger amounts of additional product information.
Description

Detailed and descriptive rich-text information about the bundle that appears on bundle detail pages. The content you enter here is seen on the product detail page both pre- and post-purchase. You can format the content you enter in several different ways using the functions in the toolbar.

This field is best for providing additional details about the product, for adding details to the brief marketing message, for legal boilerplate content, and so on.
Fulfillment Type

Required. This defines the system process by which customers receive the product or fee.

Currently, ItsOn Digital Delivery is the only option that is supported. Selecting any other option may produce unpredictable results.
Best Practice: The bundle description is information that subscribers will see in the store before purchase (for basic and compound bundles) and on their account pages after purchase (for compound bundles). It is a good place to summarize information about all the plans and fees you put in the bundle so they can see at a glance what they are getting in the bundle.

Depending on what types of plans and fees are in the bundle, you may also want to provide short summaries of each. For example:

Price Settings

Setting Description
Pricing Model

Required. Determines how the bundle price is calculated. Select from:

  • Bundle: The bundle price is determined by the amount entered in the Billing section.

    When you use bundle pricing for basic bundles and the basic bundle contains products that renew, the renewal price of each product is proportional to the bundle price and is not the product's defined price.

    For example, you have 2 renewable plans in a bundle. Plan 1 costs $20 and Plan 2 costs $10. You give the bundle a price of $15, which is half the total price of the plans if they were bought individually. A customer who buys the bundle can renew one or both plans. The renewal cost for Plan 1 would be $10 and the renewal cost for Plan 2 would be $5.

  • Item Sum: The bundle price is determined by adding the prices of all the items in the bundle.

    If you choose Item Sum and enter a price in the Billing section, the Billing section value will override the Item Sum calculated price.

Recipient/Sharing/Assigning Settings

Recipient/Sharing/Assigning settings are used only for compound bundles. In compound bundles, these settings override the individual product settings. However, once a compound bundle is purchased, sharing or assigning can be adjusted only on the individual product level.

These settings determine who can receive the bundle and how a bundle's allotment can be allocated.

Setting Description
This compound bundle can be purchased for

Required. Determines who can receive a compound bundle when it is purchased by a customer. Select

  • Customer's account only - If you want the compound bundle to stay with the purchaser's account.
  • Gift recipient only - If you want the compound bundle to be only giftable, that is, it can only be given to someone outside the purchaser's account.
  • Customer's account or gift recipient - If you want the purchaser to have the option of purchasing either for that account or as a gift for someone outside the purchaser's account.
Gifted products cannot have more than one cycle, because when you purchase a compound bundle, you are purchasing only the first cycle, and gifting a compound bundle with more than 1 cycle would require the gift recipient to either pay for subsequent cycles or cancel the compound bundle before it renews. So if you choose
  • Gift recipient only, the Recurring setting is constrained to No, which means that you cannot create a multi-cycle compound bundle that is giftable only.
  • Customer's account or gift recipient, when a customer buys a compound bundle and gifts it, the compound bundle terminates after one cycle no matter what is entered in the Number of Cycles setting, which means the gift recipient will receive exactly one cycle.

A compound bundle can be gifted only at purchase time. The purchase process of a gift requires a phone number to be input by the purchaser to identify the gift recipient. There are several issues that could occur and that would prevent the completion of a gift purchase, issues that include:

  • Entry of an incomplete (not enough digits) or incompatible (too many digits, non-numeric digits) phone number.
  • The phone number entered is for a subscriber in the same account. (Gifts can be made only to subscribers outside the purchaser's account.)
  • The phone number entered is for a suspended subscriber.
  • The phone number entered is for a subscriber in a suspended account.
Allocation

Required. Determines how the plans in a compound bundle are allocated to subscribers. Select

  • Exclusive - Allocation of products in the bundle is available only to the subscriber that purchased the compound bundle or to the recipient of a gifted compound bundle.
  • Assignable - Allocation of products in the bundle is available to be used by only one subscriber at a time. The Assignment Method setting (available only when this option is selected) determines additional assignment options.
  • Shareable - Allocation of products in the bundle can potentially be used by any subscribers in the account. The Share Method and Share Type settings (available only when this option is selected) determines additional sharing options.
The Assignable and Shareable options are viable only when the tenant offers more than one subscriber per account.
Share Method

When Shareable is selected as the Allocation setting, determines how that sharing occurs. Available only when the Allocation setting is Shareable. Select:

  • Automatic: Sharing of plan allocation happens automatically among subscribers when they join or are removed from an account and when a compound bundle is exchanged. On purchase, all subscribers receive equal allocations of each product in the bundle by default. The purchaser can change these allocations at any time.

  • Manual: Allocation of any amount of a plan in the compound bundle to any subscriber happens manually. When a subscriber joins or is removed from an account or when a plan is exchanged, no automatic (re)allocation occurs. On purchase, only the purchaser receives an allocation, and that allocation is 100%. The purchaser can change these allocations at any time.
Share Type

Determines how allowance of products in the compound bundle can be shared by subscribers. Available only when the Allocation setting is Shareable.

  • Limited (aka never go below)
  • Piñata

Limited is considered a "hard allocation," which means that once a subscriber is allocated an amount from a product, no other subscriber can use that allocated amount of that product unless there is an explicit reallocation. The total of the subscriber allocations cannot exceed 100%. For Limited, the following is true:

  • A subscriber allowance cannot be changed to lower than what the subscriber has already used in the cycle.
  • A subscriber allowance cannot be changed to more than what remains in the product allowance.
  • The total of all subscriber allowances cannot be more than 100%.
  • The total of all subscriber allowances can be less than 100%. That is, there can be unallocated product allowance.
  • The subscriber allowance percentages that are in place at the end of the cycle carry over to the next cycle.

Piñata is like a large glass with each subscriber having a straw. Each subscriber can consume as much of the total plan allocation as they are allocated, each allocation can be any value up to the plan allocation, and the total of all allocations can be more than 100%. The amount each subscriber actually consumes each cycle is defined only by their usage pattern. For example, you have a shared 100MB data plan. An account with 2 subscribers purchases the plan and gives each subscriber 100%. The first day of the first cycle, subscriber A uses 100MB. Subscriber B's allocation for the rest of the cycle becomes 0MB. In the second cycle, subscriber B uses 100MB in the first day. Subscriber A's allocation for the rest of the cycle becomes 0MB.

For both Limited and Piñata, the total allocation to subscribers can equal less than 100%, so there could be an unallocated amount in a cycle.

See Sharing Examples for information on how sharing and allocation works.

The Share Type option is viable only when the tenant offers more than one type of sharing.
Assignment Method

When Assignable is selected as the Allocation setting, determines how that assignment occurs. Select:

  • Assignable at purchase only: The allocation of the products in the compound bundle is available to be used by only one subscriber at once. The allocation of each product in the compound bundle can be assigned one time, at purchase time only, to one other subscriber (including the purchaser), at which point that is the only subscriber that can use the product allocation.
  • Reassignable: The allocation of each product in the compound bundle is available to be used by only one subscriber at once, but it can be assigned and reassigned to any subscriber in the account for the duration of the compound bundle.
Sharing, assigning, and gifting settings all affect what customers can do with plans. See Sharing, Assigning, and Gifting for more information on how these settings work together.

There are a number of ways that customers receive bundles where sharing, assigning, and gifting settings will not be available to them. In those cases, default bundle sharablility and assignability occurs.

Some sharing and assigning is done by the bundle purchaser as part of the purchase process. In fact, some settings require sharing, assigning, or gifting selection at purchase time. But when a bundle is mandatory to be received, is received via the complimentary or provisioning API, or is received as a benefit, it is not included as a part of such a purchase flow, so sharing and assigning selections that are required within that flow cannot be made.

A specific example of this is if a bundle's Allocation setting is Assignable and the Assignment Method setting is Assignable at purchase only. If the bundle is received as a benefit, it doesn't go through that customer-facing purchase flow, and so cannot be assigned. Another example is if a bundle's This product can be purchased for setting is Gift recipient only. If this bundle was being purchased, the only option at purchase time would be to enter a phone number of a subscriber outside the account to receive the bundle. But again, if the bundle is received as a complimentary bundle, the screen to enter a phone number isn't shown, so there's no way to gift the bundle.

The general rule is that if a bundle is received outside of the customer-facing purchase flow, like when a bundle is received automatically, and has a combination of settings that require decisions only in that customer-facing purchase flow, then the bundle is assigned to the subscriber designated to receive the bundle, and if that subscriber is not known, the bundle is assigned to the first subscriber in the account.

Behavior Settings

Behavior settings are used only for compound bundles. In compound bundles, these settings override the individual product settings.

These settings determine how and when a compound bundle is available in the store. See Plan Behavior Settings Examples for some scenarios on how these settings combine to produce desired product behavior. 

Several of the behavior settings relate to aspects of the plan cycle, aspects that include:

Setting Description
Recurring

Required. Defines whether the bundle is a multi-cycle subscription, lasts for only one cycle, or lasts for one cycle with the option for customers to renew.

If you selected Giftable only in the This product can be purchased for setting, the only option here is No. This is because bundles that are gifted can have only one cycle because when you purchase a bundle, you are purchasing only the first cycle, and gifting a bundle with more than 1 cycle would require the gift recipient to either pay for subsequent cycles or cancel the bundle before it renews.

Select:

  • Yes - To allow the bundle to have as many cycles as defined in Number of Cycles. Once a customer receives the bundle, it continues to renew until it is canceled.
  • No - To restrict the bundle to just one cycle.
  • Optional - To give the bundle for only one cycle initially, but to include a customer option to subscribe. When customers purchase the bundle, they get only one cycle unless they select the option during purchase to subscribe and receive additional cycles. When customers receive the bundle in any other way, such as through a benefit, the option to subscribe and receive additional cycles is on the bundle details page in the self-service app and on their account page after the bundle is received. The Number of Cycles setting determines the maximum amount of times the customer can receive the product subscription.

    During any last cycle (which is also the first cycle at purchase time or at the time the bundle is received, such as from a benefit), customers have the option to toggle renewability. In other words, during the bundle's last cycle, customers can decide that they want to continue receiving and paying for the bundle up to the Number of Cycles. Customers can also stop bundle renewal during any last cycle, in which case the bundle terminates at the end of the current cycle.
Any segmentation rules that include this setting, including restrictions and offers, will treat both Yes and Optional as the same. That is, if a rule is defined to match a recurring product, the rule will match if this setting for the product is either Yes or Optional.
Number of Cycles

Required. This defines the number of cycles a subscriber can receive the compound bundle. The options determine if a compound bundle repeats at the end of its duration. (The duration is defined either as the account cycle, if Aligned to account cycle is Yes, or as the compound bundle's Cycle Duration value.) If so, the customer is grandfathered the compound bundle rate and attributes when it is renewed, even if you have made significant changes to the compound bundle or even deleted it from your catalog. Select from:

  • Unlimited: Subscribers can continue to receive (and pay for) the compound bundle as long as they want.
  • Limited to: Enter the number of cycles of the compound bundle that can be received.

    You can enter only positive integers (1, 37, 5287024, etc.) in this field. Zero, negative numbers, and decimal numbers (0, 0.5, 3.1415926, 2.5, etc.) are not allowed.

Compound bundles renew when they are set to an unlimited number of cycles or when they are "limited" to more than one cycle, that is, the number in the Limited to option is greater than 1. Renewing means that at the end of a compound bundle cycle's duration:

  • The usage counter is reset.
  • The cycle starts over.
  • Billing occurs.

If you are going to make the compound bundle giftable, then it cannot renew and you must select the Limited to option and enter 1. This is because when you purchase a compound bundle, you are paying only for the first cycle. If gifting a compound bundle with more than 1 cycle was allowed, the recipient would be responsible for either paying for subsequent cycles or canceling the compound bundle before it renews.

Aligned to account cycle Required. This is the alignment, and it defines when renewals occur and are billed. Available only when Number of Cycles is set to Unlimited or is set to Limited to and its value is greater than 1. Defines whether the compound bundle is billed when the account cycles or when the compound bundle is purchased.
Cycle Duration

Required. This defines how long a compound bundle cycle is. Available only when Aligned to account cycle is set to No. Select from:

  • Unlimited. This means that there is no time limit for subscribers to consume the allotment of the plans in the compound bundle.

    If a compound bundle cycle duration is unlimited, then you must select Limited to in the Number of Cycles setting and enter 1. Compound bundles with an unlimited cycle duration may not have more than one cycle.
  • Lasts, then enter a number and select a unit of measure from minute(s), hour(s), week(s), day(s), or month(s). This sets a time limit to consume the allotment of the plans in the compound bundle. Any allotment unused when the time limit is reached is lost.

    You can enter only positive integers (1, 37, 5287024, etc.) in this field. Zero, negative numbers, and decimal numbers (0, 0.5, 3.1415926, 2.5, etc.) are not allowed.
Prorated on first cycle

Required. This is proration, and it defines how much is billed and allotted for the first cycle. Available only when Aligned to account cycle is set to Yes.

Best Practice: When you have a compound bundle that has more than 1 cycle and is aligned to the account cycle, you'll almost always want to set this to Yes. If you set it to No, a customer will be charged full price for the compound bundle even if they buy it on the last day of the account cycle.

While that may be OK for compound bundles with a fixed amount of consumption, your business needs may dictate otherwise, especially for compound bundles with unlimited plans

For example, if if a plan in a compound bundle offers 30MB of data for $30/month and a customer whose account cycle begins on the 1st buys the plan of the 20th, they will get a prorated amount of 10MB for a prorated cost of $10. But if you offer an unlimited amount of data for $30/month and a customer whose account cycle begins on the 1st buys the plan on the 30th, they will get an unlimited amount of data for $1. So if you have unlimited plans in he compound bundle, you may want to consider setting this option to No.

Even when a compound bundle is prorated normally, when it is offered in an exchange category in a carousel and a customer receives the compound bundle through the exchange category in the carousel, no proration occurs. The customer receives the full allotment for the remainder of the cycle in which it is received and is charged the full cycle price.

Terminates when all product usage allowances run out

Available only when Number of Cycles is set to Limited to and its value is 1 because this setting is used only for one-time compound bundles. Determines if a compound bundle is terminated when the usage allowance of all the plans in the compound bundle run out. The choices are:

  • Yes (default): When the usage allowance of all plans in a compound bundle run out, the compound bundle is terminated and is moved to the Subscription History or Plan History list immediately.
  • No: When the usage allowance of all plans in a compound bundle run out, the compound bundle remains unterminated and in the Subscriptions or My Plans list until it expires based on the validity duration.
Note: A reason why you might want to choose No here is so that customers can upgrade one-time compound bundles if the usage allowance of all its plans run out before the expiration of the compound bundle. Once a compound bundle terminates, it can't be upgraded.

The choice here can also affect when intercept notifications are triggered. One of the intercept notification rule options is a reason, and the two choices are Plan Capped and Plan Not Present. If a bundle terminates, then it would match the Plan Not Present option in the notification. If a bundle is not terminated when the usage allowance of all the plans in the bundle run out (the No option of this setting), the bundle would still be considered active until its duration expires. This matches the Plan Capped intercept notification option, and you could design an intercept notification to provide easy upgrade options.

Visibility

Determines whether or not the compound bundle is visible to customers.

If this is set to Hide, the bundle is not visible for purchase in the store nor is it visible in a customer's account information. It is not shown as part of a bundle when included in another bundle, and usage notifications are not triggered by plans within a hidden bundle, regardless of the visibility setting of the plans.

A bundle cannot be hidden unless its price is equal to 0 (zero). This is because at checkout, a non-zero priced bundle in the cart will result in a total price that is different from the sum of the prices of the visible products, which could cause customer confusion. So this setting is unavailable until a price value greater than 0 (zero) has been entered for the bundle.
Usage Display

This setting defines how bundle usage information is viewed on devices.

Each bundle has a default set of usage information that is displayed to users that is based on other bundle behavior settings, but you can override the default and specify different usage information to be displayed on devices for that product. Select:

  • Default: To use the default usage display property (defined below) for the type of bundle and its configuration.
  • Custom: To select what type of usage data your subscribers will see for this bundle.

Custom Usage Display Options

Usage Display Property Definition Example
Duration

Default for bundles with time-based limits.

Shows the amount of time used and the total time available.

None

Default for bundles with unlimited duration.

Shows the bundle name only.

Does not show any units or duration.

 

Summary of Usage Display Option Defaults

Usage display defaults depend on your usage and duration choices:

  • Unlimited duration: summary only
  • Limited duration: cycle duration only

Bar and Label Direction and Position

The direction of bar movement and the position of labels in relation to the bar (to the right or left of the bar) depend on tenant settings and/or language (left-to-right or right-to-left) settings.

First, whether the bars are count up (for example, Day 7 of 15) or count down (for example, 8 days remaining) depends on a tenant setting.

Then, the direction that the bar moves (or fills) depends on a tenant setting.

Finally, if there is a label, its location depends on language settings. If the language setting is left-to-right, the label will be to the right of the bar. If the language setting is right-to-left, the label will be to the left of the bar.

Billing Settings

Setting Description
Retail Price Defines the default, standard price for the bundle. This is the price customers will see unless overridden by the Sale Price field or other available offer mechanisms.  If no value is entered, 0 is used.
Sale Price

Overrides the Retail Price while allowing you to keep a record of the retail price. To return to the Retail Price, delete the contents of this field.

A Sale Price can affect whether customers qualify for offers (benefits and discounts), depending on the value of the Apply to sale price setting in the offer.

When a customer is viewing the catalog, both the sale price and the retail price are visible in the product listing. The exact appearance will depend on your branding. The following graphic is an example of what customers might see in a product where the Retail Price is 1.00 and the Sale Price is 0.80:

Some research suggests that consumers believe prices with more syllables are higher than the same prices with fewer syllables, and this is seen in both spoken and printed prices. Both commas and decimal points add to the "syllables," so, for example, $1,199.00 is viewed as more than $1199. ItsOn provides a client-side branding setting that can present catalog prices without the decimal and the digits after the decimal for whole number prices. If this setting were used for the example above, the values seen in the catalog presentation would be $1 and $0.80. This setting does not affect the amounts you enter in the Retail Price Price or the Sale Price fields, nor the amounts shown during checkout, in customer invoices, and in customer service records.

Taxes and Bundles

Unlike with plans and fees, you do not set a tax type with bundles. Taxes are charged based on the tax settings of the products within a bundle.

However, bundles are taxed based on the relative proportion of the retail price of their parts applied to the bundle price. For example, let's say you have a voice plan (P1) and a Messaging Plan (M1) and the tax rate on both is 5%. You charge $6 for the voice plan and $4 for the messaging plan, and you put them both in a bundle that you charge $8 for.

If bought individually, the tax for P1 would be $0.30 and the tax for M1 would be $0.20. Total taxes for the 2 products is $0.50.

The proportional cost for P1 in the bundle is $6/($6 + $4) = 60% * $8 = $4.80. Tax would be $0.24.

The proportional cost for M1 in the bundle is $4/($6 + $4) = 40% * 8 = $3.20. Tax would be $0.16.

Total tax for the bundle is $0.40.

Sku Bundle Items

This is where you manage the products in a bundle. You can:

Setting Description
Sku The product name.
Quantity How many of the product are in the bundle.
Item Sale Price The price of the product when it is sold as part of the bundle.
Options Not used.

Certain product types can and cannot be added to different types of bundles. The following table illustrates this.

  Basic Bundle Compound Bundle

OK to add

Do not add

If you attempt to promote a change that includes a bundle that contains an ineligible product, the promotion will fail and you will see an error message.