Skip to main content
Aria Knowledge Central

Models

  1. Last updated
  2. Save as PDF
  1. Rate Units
    1. View rate units
    2. Add a rate unit
    3. Edit a rate unit
    4. Delete a rate unit
  2. Rate Unit Maps
    1. View rate unit maps
    2. Add or edit a rate unit map
  3. Time Units
    1. View, add, edit, or delete time units
  4. Zone Units
    1. View zone units
    2. Add a zone unit
    3. Edit a zone unit
    4. Export zone unit data

Models provide the rate and zone structures that monetization models reference during usage rating.

Rate Units

A rate unit defines how the Allegro engine derives the quantity for pricing. The engine uses the rate unit configuration to compute a quantity value that it then applies against the price configured in the monetization model.

View rate units

  1. Click the Usage toggle in the navigation pane.
  2. Click Configurations to expand the sub-menu.
  3. Click Models.
  4. Click the Rate Unit tab in the activity pane.

The table lists all rate units configured for the client. Filter by Rate Unit Code or Service Type, and sort by Rate Unit Code or Usage Type.

Add a rate unit

  1. Navigate to the rate units list.
  2. Click Add Rate Unit at the top right of the activity pane.
  3. Enter a Rate Unit Code (required).
  4. Select the associated Service Type (required) from the dropdown.
  5. Configure how the rate unit derives its quantity using one of the following methods (these options are mutually exclusive):
    • Expression—enter or build a custom expression using usage container fields.
    • Database Function—reference a server-side function.
    • Meter Read—derive quantity from a meter reading.
  6. If the rate unit drives a recurring price offer fee, enable the appropriate flag. Allegro will use this configuration to derive the quantity when applying the recurring fee.
  7. Click Save.

Edit a rate unit

  1. Navigate to the rate units list.
  2. Click the ID link for the rate unit you want to modify.
  3. Update the attributes as needed. The ID field is read-only.
  4. Click Save.

Delete a rate unit

Note: Allegro enforces referential integrity. You can only delete a rate unit if it is not referenced in any other configuration.

  1. Navigate to the rate units list.
  2. Click the trash icon in the row for the rate unit you want to remove.
  3. Click Save to confirm the deletion.

Rate Unit Maps

A rate unit map associates a rate unit with a service type and transaction type. The Allegro rating engine uses this mapping to determine which rate unit to apply when processing usage records of a given type.

A common use case is mapping rate units to call duration for voice usage types.

View rate unit maps

  1. Click the Usage toggle in the navigation pane.
  2. Click Configurations to expand the sub-menu.
  3. Click Models.
  4. Click the Rate Unit Map tab in the activity pane.

The table lists all rate unit maps configured for the client.

models-01.png

You can filter by Rate Unit Code (case-insensitive, partial match), Service Type (exact match from dropdown), or Transaction Type (exact match from dropdown). Sort by any of these attributes ascending or descending.

Add or edit a rate unit map

  1. Navigate to the rate unit maps list.
  2. Click Add Rate Unit Map to add a new mapping, or click the ID link of an existing mapping to edit it.
  3. Select the Rate Unit Code, Service Type, and Transaction Type (all required).
  4. Click Save.

Time Units

Time units define the billing period structure used by Allegro monetization models that apply time-based pricing or grants.

View, add, edit, or delete time units

  1. Click the Usage toggle in the navigation pane.
  2. Click Configurations to expand the sub-menu.
  3. Click Models.
  4. Click the Time Unit tab in the activity pane.
  5. Click Add Time Unit to create a new time unit, or click an ID link to edit an existing one. To delete, click the trash icon and confirm.
  6. Click Save.

Zone Units

Zone units define geographic or other classification-based routing zones used by the Allegro rating engine to apply differentiated pricing. Each zone unit configuration contains one or more rows that map origin, destination, and optionally distance values to a zone.

Allegro supports two zone model types:

  • Origin-Destination—matches usage records by origin and destination field values.
  • Geographic—matches usage records by geographic coordinates, with an optional distance value.

Note: Use Mediation Enrichment rules to normalize input values before defining zones. For example, normalize all phone number formats to a consistent format such as 11234567890. Zones typically require only the first few digits or a wildcard (*). The Allegro rating engine applies best-match logic: a more specific pattern (such as country code 55 for Brazil) takes precedence over a wildcard (*).

View zone units

  1. Click the Usage toggle in the navigation pane.
  2. Click Configurations to expand the sub-menu.
  3. Click Models.
  4. Click the Zone Unit tab in the activity pane.

The table lists all zone unit configurations for the client. You can filter by zone unit attributes and sort by Origin Value, Destination Value, Distance Value, Zone Unit, Start Date, or End Date.

Add a zone unit

  1. Navigate to the zone units list.
  2. Click Add Zone Unit at the top right of the activity pane.
  3. Enter a Zone Unit Id (required) and a Name (required).
  4. Select the Zone Type: Origin-Destination or Geographic.
  5. Select the usage container field that holds the Origin Value from the dropdown.
  6. Select the usage container field that holds the Destination Value from the dropdown. Enter the destination pattern in the adjacent field. Use * as a wildcard.
  7. For Geographic zone type, select the usage container field that holds the Distance Value.
  8. Enter a Start Date and, optionally, an End Date for the zone configuration row.
  9. Click Add Row to add additional zone rows as needed, then repeat steps 5–8 for each row.
  10. Click Save.

Edit a zone unit

  1. Navigate to the zone units list.
  2. Click the Zone Unit ID link to open the configuration drawer.
  3. Update the attributes inline. To remove a row, click the X icon on the right side of the row.
  4. To change the zone unit status, select a value from the Status dropdown at the top of the drawer. Supported values are ACTIVE, INACTIVE, and CLOSED. Only zone units with ACTIVE status are used by the Allegro rating engine.
  5. Click Save.

Export zone unit data

You can export zone unit data to an Excel or PDF file.

  1. Navigate to the zone units list and open the zone unit configuration you want to export.
  2. Use the horizontal scroll bar to scroll the table fully to the right.
  3. Click the three vertical dots icon in the table header to expand the sub-menu.
  4. Select Export to reveal the file format options.
  5. Click Excel or PDF. Allegro downloads the file to your default download location.
TOP
  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Page type
    Topic
  2. Tags
    1. allegro
    2. rating
    3. usage