Offer Owner State Update Component Properties

Offer owner state update components have references to one or more offer owner state update tables in addition to the properties listed in Offer Owner State Update Component Properties. Each component table contains a decision table comprised of normalizers and their related object state update profile.

Table 1. Offer Owner State Update Component Properties
Property Description
Name A descriptive name for the offer owner state update component.
Description Information about the purpose of the offer owner state update component.
External ID (Optional) Use this field to identify this item in MATRIXX pricing items. An External ID is saved to the pricing configuration file and loaded into the Pricing Database. Set the External ID value to any alphanumeric character that is meaningful to your implementation. An External ID can be used, for example, to relate offers in the MATRIXX system to products in an external pricing plan. It can be used, for example, by the Subscriber Management API to query and purchase product offers and bundle IDs.
Start Date/Time The date on which the offer owner state update component becomes valid in the pricing database and can be used during rating to determine which object state update profile to choose. The start date enables you to create multiple revisions of the same object at one time, each of which becomes active at a future date, so you do not need to roll out additional pricing plans for each change in your rating structure. The default start date/time is 2000-01-01 00:00:00.

If the start date of the earliest revision of an offer owner state update component is after the valid period of the product offer that references it, the offer owner state update component will not be examined during rating.

Application Specifies the offer owner state update component application type.

The options are:

  • balance_threshold — The offer owner state update component is applied when a balance reaches or crosses a balance threshold.
  • purchase — The offer owner state update component applies to catalog item purchases only. This is the default.
  • purchased_item_activation — The offer owner state update component is applied when a product offer or bundle purchased in a pre-active state is activated.
  • recurring — The offer owner state update component is applied each time a recurring operation is processed for a product offer or bundle.
    Note: Because a recurring offer owner state update component is only for purchased item cycle, when recurring is selected as the Application type, a Cycle field displays with a read-only value of Purchased Item.
Threshold (balance_threshold application only) The threshold of the specified balance that when reached or crossed, triggers the offer owner state update component to be applied. Only balance thresholds with Applies To Balance Increase selected are listed. For more information, see the discussion about configuring balance template thresholds.
Is Instance Specific (balance_threshold application only)
  • If selected, the balance_threshold configuration for the component applies to only balance instances created by the containing offer.
  • If deselected, the balance_threshold configuration for the component applies to all balance instances in the balance template.
Offer Owner State Update Component Table Properties describes the offer owner state update component table properties.
Table 2. Offer Owner State Update Component Table Properties
Property Description
Name A descriptive name for the offer owner state update table.
Description Information about the purpose of the offer owner state update table.
External ID (Optional) Use this field to identify this item in MATRIXX pricing items. An External ID is saved to the pricing configuration file and loaded into the Pricing Database. Set the External ID value to any alphanumeric character that is meaningful to your implementation. An External ID can be used, for example, to relate offers in the MATRIXX system to products in an external pricing plan. It can be used, for example, by the Subscriber Management API to query and purchase product offers and bundle IDs.
Default Result A default object state update profile or the SKIP value to use when the normalization values present during rating do not match any of the results defined in the offer owner state update table.
Decision Table A table that contains one or more normalizers that the offer owner state update table uses to associate with results. Each result can be an object state update profile to select or a SKIP value.