Custom Account Dimensions

First, you need to define your custom account dimensions with a name and type in the “Dimensions” page in the Management Center, select "Custom account dimensions" from the drop-down menu and click "New Dimension" on the top right.

Name – The name of the custom dimension as it will appear on the Natero platform.

Description - An optional description of this custom account dimension

Dimension Type – One of the following: Textual, Numeric or Date-based dimension.

Since custom metrics are time series data, they need to be sent with timestamp information through the Natero Account API. The timestamp needs to be in epoch milliseconds (UTC timezone is assumed). You can also send custom dimensions from your implementation using the Natero Account API.

Your data will then be processed using your custom dimension and metric definitions. We'll capture the names of the custom dimensions and metrics you send automatically in any account dimensions and metrics dropdown.

Custom User Dimensions

First, you need to define your custom user dimensions with a name and type in the “Dimensions” page in the Management Center, select "Custom user dimensions" from the drop-down and click "New Dimension" on the top right.

Name – The name of the custom dimension as it will appear on the Natero platform.

Description - An optional description of this custom user dimension

Dimension Type – One of the following: Textual, Numeric or Date-based dimension.

Then you can update custom dimension values at the Account Details, Contacts & Users page for each individual user. Please note that bulk editing for user details is currently not supported in Natero.

2. Using the Natero Account API to populate custom dimensions to users using the "dimensions" object.

Limits and Caveats

1. Once a custom dimension or metric is created, you can only modify its name but not its type. Once the name is changed, you will need to start sending data with the new name and we'll update the name for all the old data.

2. Deletion of any custom dimensions or metrics is permanent and unrecoverable. Deleting a metric or dimension via the “Account Settings” page also deletes the data associated with that setting.

3. Value of custom dimensions and metrics will be stored as a "Double", allowing for fractional numbers.

4. There is a maximum number of characters (255 characters) allowed for string based dimensions. In other words, both the name and values of a specific dimension need to be within the maximum number of characters.

5. When naming the custom dimension and metric, each name needs to be globally unique.

6. When sending the custom dimension and metric, the name for the same dimension/metric needs to be consistent (exact match), otherwise it'll be captured as a separate custom dimension/metric.

7. If the value of a custom metric and/or value dimension does not exist for an account, we'll set it to be zero for that account. For accounts that do not have value for a custom text dimension, you can filter these accounts in the List Explorer by constructing a condition that says "Name of custom text dimension" "is not defined".

8. Natero currently supports both custom dimensions and metrics for accounts but only custom dimensions for users.