Create a Priority Generator

Follow this procedure to create a new priority generator. Priority generators determine one value in the dynamic rating formula that, together with the settings in an offer Priority page, determine the offer priority. The highest priority offer is then used to rate an event. You create a priority table inside a priority generator to set priority values. The priority table is composed of one or more preconfigured decision tables, which in turn are composed of preconfigured normalizers.

Before you begin

See the discussion about product offers priority generators for information about how the resulting priority generator priority value is used.

Before creating a priority generator, you need to:

  • Create the normalizers that the priority generators use in decision tables.
  • Create your decision table before creating priority generators. This is recommended, not required. See the discussions about decision tables in general and creating a decision table specifically for details.
  • Know the default priority that the priority tables will use. This value is used if any priority values are missing from priority tables.

Procedure

  1. In Offer Priority Generators, click New Offer Priority Generator.
  2. In Create New Offer Priority Generators:
    1. In Name, enter a unique name.
    2. (Optional) In Description, enter descriptive information about its purpose.
    3. (Optional) In External ID, enter any alphanumeric character to serve as a unique ID on this pricing object. The external ID can be used for any reason that is meaningful to your implementation. External IDs are saved to the pricing configuration file and loaded into the Pricing database. The value is a string limited to 64 characters. The external ID can be used by the Subscriber Management API to purchase, cancel, and query priority generators.
    4. Click Create.
  3. In Edit Offer Priority Generator:
    The default priority value is used for any missing rows in the decision table when compiling the price plan.
    1. Edit any of the values you already set except ID.
    2. In Start Date/Time, use the date picker to select the date on which the object becomes active in the Pricing database and is first available for use, or enter the date in the format YYYY-MM-DD. Optionally, enter a time for when the object becomes active. The default start date/time is 2000–01–01 00:00:00. If applicable, the range in which the start date/time must fall is listed. For example:
      • Select a date on or before 2021–12–01.
      • Select a date on or after 2020–01–27.
      • Select a date between 2000–01–02 and 2021–10–04.
      Note: If you are creating a new revision of this object, the start date/time must be after the start date/time of the preceding revision and before the start date/time of the next revision. If you are making a copy of this object, the start date/time is not copied. The new object is the first revision, so it has the default start date/time of 2000–01–01 00:00:00.
  4. In Priority Tables, click New Priority Table.
  5. In Create New Priority Table:
    1. In Name, enter a unique name.
    2. (Optional) In Description, enter descriptive information about its purpose.
    3. (Optional) In External ID, enter any alphanumeric character to serve as a unique ID on this pricing object. The external ID can be used for any reason that is meaningful to your implementation. External IDs are saved to the pricing configuration file and loaded into the Pricing database. The value is a string limited to 64 characters. The external ID can be used by the Subscriber Management API to purchase, cancel, and query priority generators.
    4. Click Create.
  6. In Edit Priority Table:
    The default priority value is used for any missing rows in the decision table when compiling the price plan. Each row in the decision table can have a priority value.
    1. Edit any of the values you already set except ID.
    2. In Default Priority, enter a default priority, or SKIP. Any 32-bit integer is allowed, including negative numbers. The default is 0.
  7. To add a decision table, do one of the following;
    • To use an existing decision table:
      1. In Decision Table, click Select Decision Table.
      2. Search for and click a table to use.
      3. Click Select.
    • To create a new table:
      1. In Decision Table, click Create New Table. Edit Decision Table appears in the Decision Table section of the My MATRIXX General Configuration section.
      2. Create the new decision table. For more information, see the discussion about decision tables and how to create them.
      3. Click Cancel to return to the priority table you just created.
      4. In Edit Offer Priority Generator, click New Priority.
      5. Fill out the Create New Priority items and click Create.
      6. In Edit Priority Table, click Select Decision Table, click the table you just created, and click Select to add it to the priority generator.