• Home
/
• Explore m3ter Documentation
/
• Worked Examples

Example 3: Segmented Aggregation on Single Meter Usage

Suppose you run a SaaS company that offers a service to companies to perform background checks on employee candidates to support their hiring process:

• Pricing for this service will vary by candidate location and the level of background check done.

• The service is offered for candidate locations across three countries: the USA, the UK, and China.

• Three levels of background check are offered for each location: Standard, Extended, or Complete.

If you want to price differently for each possible combination of location/level, this can mean having to set up multiple Meters/Aggregations to support usage-pricing for all possible combinations. However, for this kind of pricing use case that demands a wide spread of differentiated pricing metrics, you can use a Segmented Aggregation on the same Meter usage data - you can submit data for the same Meter and allow a different pricing to be created for each segment defined by the Aggregation.

This topic provides a worked example to show how to set up a Segmented Aggregation to serve this differentiated pricing use case. The example goes on to show how to submit some test data against a test Account and then generate a Bill for the test Account and check billed amounts against submitted usage.

Step 1: Create Product

Products represent a product or service that you offer to your end customers. A Meter, Aggregation, Plan Template, Plan, or Pricing typically all belong to a Product.

To create a Product:

1. In the Console, select Products. The Products page opens.

2. Select Create Product. We'll create a single Product called Premium Candidate Checks:

3. Select Create Product.

The Premium Candidate Checks Product can now serve as a container for any Meters, Aggregations, Pricing, Plans, and Plan Templates we'll need for the example.

More Details: Creating and Managing Products

Step 2: Set up Meter

Meters define the Data Fields that your system will use to submit usage data to the m3ter platform:

• As well as simple Data Fields, which collect raw usage data, you can define Derived Fields that reference and apply calculations to simple fields.

• You can create Product-specific Meters or Global Meters.

For this worked example, we'll create a single Meter for our Premium Candidate Checks Product.

To create a Meter:

1. Select Usage>Meters. The Meters page opens.

2. In the Product drop-down, select Premium Candidate Checks.

3. Select Create Meter.

Here's the set up for the Meter to support the pricing model we want to use in the example:

For the example, we've set up Candidate Check Meter 1 and added the three Data Fields:

• A Location field: Category is Where, which is a String field.

• A Type field of: Category is What, which is a String field.

• A Checks field: Category is Measure, which is a Numeric field.

4. Select Create Meter.

We now have a single Meter for the example, which we can use to collect usage data on any Account that consumes the Premium Candidate Checks Product. This metered usage data will serve as the basis for the Segmented Aggregation we shall create to apply differentiated pricing for Product consumption.

More Details: Reviewing Meter Options and Creating Meters

Step 3: Define Aggregations

Aggregations define how to transform into a single number the individual measurements submitted to a Meter Data Field as usage data. For example, you may choose to simply SUM the submitted usage data values. In this way, Aggregations define the usage-based pricing metrics you'll use to set up pricing for your products and services.

For the usage-based pricing model we want to implement in our example, we'll need to create a Segmented Aggregation based on the usage data collected by our single Meter - Candidate Check Meter 1:

• We'll use the Location and Type string Data Fields the create the required segments on the usage data.

• We can target the Checks numeric Data Field to give a sum of the number of checks performed for each defined segment.

To create a Segmented Aggregation:

1. Select Usage>Aggregations. The Aggregations page opens.

2. In the Product drop-down, select Premium Candidate Checks.

3. Select Create Aggregation. The Create page opens.

4. Enter a Name and Code for the new Aggregation.

5. Select the Meter previously created for the example and with the required Data Fields: Location, Type, and Quantity

Here's the basic setup for the Segmented Aggregation:

We've targeted the Checks field on Candidate Checks Meter 1. Although we intend to define segments by location and type, we want to charge by the total number of checks for each segment in any given billing period.

6. Scroll down the Create form and click the arrow to open the Segments panel:

Because the selected Meter also has two String Data Fields configured - Location and Type - these fields are made available to define segments for the usage data and to set up differentiated pricing for Product consumption.

7. Select the two fields to define segment values by location/type. The Segments panel adjusts for the selections:

For the example, we'll assume the end-customer Account that will consume the Premium Candidate Checks Product has asked for six possible location/type checks to be done.

8. We can add the appropriate location/type segment values using the Segments panel:

9. Select Create Aggregation.

We now have the Candidate Checks Aggregation 1 with appropriate segment values defined and which we can use to apply differentiated pricing to a Plan for the Premium Candidate Checks Product.

Step 4: Create Product Plan

Plans represent a pricing plan for one of your products or services. A Plan is always derived from a Plan Template and inherits settings from the Plan Template which control billing operations, such as billing frequency and currency. You can override some of these settings when you create a Plan from a Plan Template. To meet the example requirements:

• First, we'll need a Plan Template for the Premium Candidate Checks Product. We'll configure the Plan Template:

  • For monthly billing using a specific billing currency.

  • Omit any Standing charge or Minimum spend amounts to be applied for each billing period.

• Second, we'll create a Product Plan based on the Plan Template.

To create a Product Plan Template:

1. Select Pricing>Plan Templates. The Plan Templates page opens.

2. In the Product drop-down, select Premium Candidate Checks.

3. Select Create Plan Template. The Create page opens.

Here's the setup for our Product Plan Template:

For the Candidate Checks Plan Template 1 we've:

• Chosen US dollars as the billing currency.

  • Note that if US Dollar doesn't appear for selection in the Currency drop-down when you are creating your Plan Template, you'll need to create it for your Organization:

    • Select Settings>Organization and open the Currencies tab.

    • Click Create currency and on the Create page add USD - US Dollar ($) as a Standard currency. You can define the Maximum decimal places for the currency also. Click Create - US Dollar will now be available for selection across you Organization.

• Selected a monthly Bill frequency with a Bill interval of 1, which means Accounts put on the Plan will receive a Bill each month for a month's period of usage.

• Ignore the settings under Advanced Configuration. This section of the form allows you to set up Standing charge and Minimum spend amounts for billing, neither of which are required for the example pricing model.

4. Select Create Plan Template. You are returned to the Plan Template Details page.

We can now create a Product Plan for the example based on this template.

To create a Product Plan:

1. Select Pricing>Plans. The Plans page opens.

2. In the Product drop-down, select Premium Data Checks.

3. Select Create Plan. The Create page opens.

Here's the setup for our Product Plan:

• Note that no Template Overrides for Standing charge or Minimum spend amounts are required for the example.

4. Select Create Plan. The Plan Details page opens for our new Product Plan.

We can now price Candidate Checks Plan 1 using our Candidate Checks Aggregation 1 Segmented Aggregation.

More Details: Reviewing Options for Plan Templates and Plans and Creating Plans

Step 5: Price Product Plan

Pricing allows you to configure the cost of usage data under a specific Plan you apply to an Account, and is used to calculate bills.

We can use the Pricing Editor in the m3ter Console to quickly price up our Product Plan to meet the pricing requirements for the example.

To price Product Plan:

1. Select Pricing>Pricing Editor. The Pricing page opens.

2. In the Product drop-down, select Premium Candidate Checks.

3. Select Add Plans. The Select Plans dialog opens and lists all Plans created for the Premium Candidate Checks Product.

4. Check Candidate Checks Plan 1 and select Confirm. The dialog closes and the Plan is added to the Pricing page.

We'll use the Segmented Aggregation we created at Step 3 for the usage-based metrics to apply differentiated price to the Plan in accordance with the requirements set out in the example.

5. Click Add Aggregations. A Select Aggregations dialog appears and lists all Aggregations created for the Premium Candidate Checks Product.

• Note that you might also see global Aggregations listed for selection. Global Aggregations are not tied to any specific Product and can be used to price Plans across all Products.

6. On the Select Aggregations dialog check Candidate Checks Aggregation 1.

7. Click Confirm. The dialog closes and the selected Aggregation is added to the Pricing page for the added Plan.

• You'll see a warning that none of the six segments we defined for the Candidate Checks Aggregation 1 have active pricings configured.

8. In the pricing grid, select Edit segmented pricing. The Segments pricing page opens:

• You can read off details of the Segmented Aggregation being used to create the pricing at the top of the page.

• You can read off details of the Plan to which you are applying differentiated pricings by segment.

9. Scroll down the page to reveal the Segments pricing grid, which contains a row for each segment defined for the Aggregation:

For the example, we'll suppose that for each segment we want to charge customers a different flat rate per candidate check performed:

10. For the first segment row - China/Standard - select Create Plan Pricing. The Create pricing page opens:

• You can read off details of the Segmented Aggregation being used to create the pricing at the top of the page.

• You can Switch to wizard to follow an alternative streamlined pricing workflow by Pricing Type. For the example workflow, we'll continue with the default advanced pricing format.

11. Work down the form to enter:

• Start and End dates for the period the pricing will be active for the Plan.

• A Description that will appear for any usage charge line items on Bills, such as China/Standard Check Charges.

• Leave the Apply as setting as the default - Debit.

• Pricing type:

  • The pricing requirement was to charge each segment at a flat rate on a per check basis per billing period.

  • We can therefore implement this pricing for each segment using a Tiered pricing structure with a single pricing band configured:

12. Select Create Pricing. The Create pricing page closes and you are returned to the Segments page where the pricing is shown as active for the China/Standard segment:

13. Repeat steps 10. to 12. to create pricings for the remaining five segments.

14. If we return to the Pricing editor, we see that each of our six segments have active pricings configured:

We now have a Product Plan to which we've applied differentiated pricing according to the pricing requirements using our Segmented Aggregation.

More Details: Reviewing Pricing Options for Plans and Plan Templates and Pricing Plans Using Segmented Aggregations.

Step 6: Create Test Account and Attach Priced Plan

Accounts represent one of your end-customers, and contains the end-customer name and contact details:

• When you attach a priced Plan to an Account, this creates a link between them to create an Account Plan. Attaching priced Plans to an Account determines the charges incurred by customers who are put on the Plan when they consume one of your Products.

For this step, we'll create a test Account for the example and attach our priced Plan to it.

To create a test Account and attach Plan:

1. In the main Console navigation, select Accounts. The Accounts page opens.

2. Select Create Account. The Create page opens.

3. Enter the details of the new Account:

• Name and Code. Required fields.

  • Note that when you enter a Name and click in the Code field, a default code is entered based on the name you've entered, which you can then edit as required.

• Email Address. In addition to Name and Code, this is also a required field.

• Other settings. These are optional fields, such as physical address settings, which you can add later by editing the Account.

4. Select Create Account. The Account Details page for the new Account opens with the Overview tab selected:

For the worked example, we've created the Candidate Checks Customer 1 test Account.

5. Select the Attached Plans tab.

6. On the Active and pending attached plans panel, select Attach plan. The Create page opens.

• When you attach a Plan to an Account, you create an Account Plan, which lets you define the specific way in which you want the Plan to be applied to the individual Account. Note that the Account Plan you create when you attach the Plan to an Account is distinct from the Plan itself - you may want to attach the Plan to another Account but to configure the way the Plan is applied to that other Account differently.

8. On the Create page, leave the radio button for Plan as default setting and enter the details of the Account Plan:

• Use the Product drop-down to select the Product, which is Premium Candidate Checks for the example. The Plan drop-down selection field is enabled.

• Use the Plan drop-down to select the Plan, which is Candidate Checks Plan 1 for the example.

• Use the pop-up calendars to enter Start date and End date, which will define the period the Account Plan is active for the Account.

9. Select Create Plan. Back on the Attached Plans tab, the Account Plan is shown on the Active and pending attached plans panel:

We now have a test Account set up that will be billed according to the segmented pricing schema we've configured for the Plan for any metered usage of the Product.

More Details: Creating an Account and Attaching Plans to an Account

Step 7: Submit Data to Test Account and Check Bill

We'll now submit some test data to our Candidate Checks Customer 1 test account and for the Candidate Check Meter 1. This will allow us to generate a Bill for the test Account and check that the usage charges on the Bill for the submitted test data are correct.

1. Select Accounts. On the Accounts page, select the NAME hotlink text of the Candidate Customer Customer 1 test Account we created at Step 6. The Account Details page opens with the Overview tab selected.

2. Select Submit usage:

A Submit usage dialog appears. To submit usage data measurements for the Account, you must complete two stages using the dialog.

3. Under stage 1: Select a meter, use the Meter drop-down to select Candidate Check Meter 1 and then select Continue. The dialog adjusts to show stage 2: Define measurements and send:

• Note that you can complete stage 2 using either a Simple or Advanced format, where the default is Simple.

• For the example, we'll use the Simple format to submit our test usage data measurements:

  • UID. This field is automatically populated with a unique id for the measurement. For the example, we'll use this as our measurement id.

  • Timestamp. The timestamp field is also automatically populated using the date/time the dialog was opened, and again for the example we'll use this as the timestamp for the measurement.

  • Meter. The Meter Code is automatically entered.

  • Account. The Code of the Account we're submitting the data measurement for is automatically entered.

  • Data fields. The three Data Fields we set up for the Meter are shown with empty Value fields.

4. Enter test data Values for the Location, Type, and Checks Data Fields:

For this first submission, we've defined a measurement for the first segment value of Location = China and Type = Standard with number of Checks = 754.

5. Select Submit usage. If the measurement is ingested successfully, under Log you'll see a { "result" : "accepted" } message with the measurement JSON submission reproduced:

• Note that the Submit usage dialog refreshes with a new measurement UID and readied for another data submission.

6. For the example, repeat steps 3. to 5. to submit test measures for each of the remaining five segment values:

• China/Extended. Number of Checks = 687.

• USA/Extended. Number of Checks = 954.

• USA/Complete. Number of Checks = 432.

• UK/Standard. Number of Checks = 765.

• UK/Complete. Number of Checks = 1206.

7. Close the Submit usage dialog.

8. Go to the test Account details page and select the Bills tab.

9. On the Bills tab, select Run billing. The Run billing dialog appears.

10. In the example, we are using monthly billing and the test data was submitted in September 2023, so we select:

• October 1st for Invoice date.

  • Note: it might be worth double-checking that your Organization configuration setting has the Month Epoch setting to run Bills from the 1st of a month.

• Monthly for Bill Frequency.

11. Select Run billing. The dialog closes and your Bill job is queued.

• You can select the Running Tasks button at top-right in the Console:

• This opens the Running Tasks panel and you can follow the status of your Bill job.

12. When the Bill has generated, it will be listed on the Bills tab for the Account. Select the REFERENCE hotlink text to open the Bill in Bill Management.

Before checking a sample Bill we've generated for the Account, we can calculate manually what the cumulative usage charges should be for the usage-based segmented pricing we've implemented:

• China/Standard. Number of Checks = 754 at $0.20 per check: $150.80.

• China/Extended. Number of Checks = 687 at $0.40 per check: $274.80.

• USA/Extended. Number of Checks = 954 at $0.50 per check: $477.00.

• USA/Complete. Number of Checks = 432 at $0.70 per check: $302.40.

• UK/Standard. Number of Checks = 765 at $0.50 per check: $382.50.

• UK/Complete. Number of Checks = 1206 at $0.80 per check: $964.80.

• This gives total for the usage data measures we submitted across segments of: $2552.30

For the example, we can see that the Bill based on test usage data we submitted has been calculated correctly in accordance with our usage-based differentiated pricing schema:

Deploying to Production: Having submitted some metered test data against a test Account, generated a Bill for the Account, and confirmed that charges are in accordance with our pricing requirements for consumption of our Product, we can be comfortable deploying our usage-based pricing implementation to live production.

More Details: Submitting Test Usage Data and Running Bills Manually

Additional Support