Skip to main content
Upload metering data

Add metering for many customers at once by uploading your usage records in a CSV file.

Steve Stormoen avatar
Written by Steve Stormoen
Updated over 2 weeks ago

If you are reconciling accounts for numerous customers, you can process data much more quickly by uploading a CSV to create multiple usage records at once.

Download your metering template

  1. In Tackle, click Metering in the left menu.

  2. Click Upload CSV.

  3. On the new page that opens, click CSV Template to download the template.

Prepare your metering records CSV file

Open the CSV template on your computer using a tool like Excel, Google Sheets or Numbers and add a row for each metering record you want to create. Fill in all columns as indicated in the table below. All fields are required, except for end_time, which is only required if you are metering a contract through Google Cloud.

Column header

Notes

productid

The ID of the product for which you are submitting usage. Product ids are visible as a column in the listing display when you click Metering > Create new record.

customerid

The reference ID for the buyer you are billing. You can also find this in the Tackle list of active contracts or in the corresponding marketplace portal.

dimension

The name of the metric you are reporting for, referred to in AWS and Microsoft as a dimension or Google Cloud as a metric.

quantity

The amount of the metric you are measuring (for example 3 clicks, 20 users etc.). Do not enter the price of the metric, this should be a count not a monetary amount.

start_time

The time usage occurred (AWS, Microsoft) or started (Google Cloud). All times should be in the format of an RFC3339 timestamp, for example: 2014-10-02T15:01:23Z

For AWS, the start time for usage can be up to six hours in the past - as long as the customer is still subscribed to your product. However, if the customer unsubscribes, you must send the metering records within one hour of their cancellation to avoid any issues.

end_time

The end of the time range for measured usage (Google Cloud). For AWS and Microsoft, leave this field blank. All times should be in the format of an RFC3339 timestamp, for example: 2014-10-02T15:01:23Z

For Google Cloud, the end_time should always be in the past, and the start_time should be before the end_time. The end_time can be up to 5 minutes in the future.

Tip

If you are doing a monthly true-up, enter the current day/time in the start_time field for AWS or Microsoft record. For a Google Cloud record, enter the current day/time in the end_time field, and set the start_time an hour before the end_time.

When you're finished, save your file in the CSV format.

Upload your completed metering record CSV file

  1. Return to the Tackle platform and navigate back to Metering > Upload CSV.

  2. Drag and drop the CSV file of your metering records from your computer onto the same page in Tackle. You can also click Select metering CSV to navigate to the file on your computer.

  3. Review the submissions, and if it looks correct, click Submit.

Did this answer your question?