The Numeric Range Mapper extension turns a number a visitor enters, like an age, order size, or score, into a text label you define. Use it to show a friendlier label back to the visitor, or to pass that label through to an integration.
What you'll learn
- How to install the Numeric Range Mapper extension
- How to configure numeric ranges and destination labels using campaign metadata
- How to display the mapped text in your campaign or pass it to an integration
Install the extension
- Go to your account name drop-down (top right) and select Extensions.
- Find Numeric Range Mapper in the Field Data category and click Install.
- Publish to your Site for the extension to activate.
Configure the extension
Add the extension's settings as campaign metadata:
- Open the campaign in the Campaign Editor.
- Go to Settings > Campaign Settings.
- Scroll to the bottom of the window to find Campaign metadata.
- Add the metadata keys below.
Metadata Key | Value | Description |
|---|---|---|
range_source | custom_X | The form field with the number to evaluate. |
range_dest | custom_Y | The form field that receives the matching label. Must be different from range_source. |
range:MIN-MAX | label text | Defines one numeric range. Add one key per range bucket. Both MIN and MAX are inclusive. |
Important: The source and destination fields must be different, and neither should be used for any other purpose on the form.
Example
Goal: read a numeric score from custom_1 and write a tier label into custom_2.
Metadata Key | Value |
|---|---|
range_source | custom_1 |
range_dest | custom_2 |
range:1-5 | low |
range:6-10 | medium |
range:11-20 | high |
With this configuration, a source value of 7 sets custom_2 to medium. A value of 0 or 21 doesn't match any range, so custom_2 keeps its current value.
How the range matching works
- Digioh checks the ranges when the form is validated, before the campaign submits, so the destination field already holds the matched label by the time the submission goes out.
- Range comparisons are inclusive, so a value equal to MIN or MAX counts as a match.
- If your ranges overlap, whichever range is checked first wins, and that order isn't guaranteed. Avoid overlapping ranges to prevent inconsistent results.
- If the source value doesn't fall in any range, the destination field keeps its existing value.
- The extension reads whole numbers only. If a visitor enters a decimal, only the whole number part is used (5.9 becomes 5).
- Both the source and destination fields must exist on the form, or the mapping won't run.
Display or use the mapped value
To show the mapped text in the campaign, install the Universal Merge Tags extension, then add the merge tag for your destination field (for example, [CUSTOM_2] if range_dest is custom_2) to a text element.
To pass the mapped text to an integration, reference that field number in the map task of your pipeline.
That's it; your numeric range mapping is ready to go. Need a hand? Reach out to support@digioh.com.
Want to get more from Digioh?
Get the playbooks leading brands use to convert more visitors into revenue.
Browse the Playbooks ?Platform Tour
See what else you can do with Digioh in our self-guided platform tour.
Take the Tour ?