Adding Custom Charts to Dataset Reports

Dataset Reporting in Version 5.5 allows for custom configuration of Charts available to content builders. Metric Insights Admins can now extend the existing list of the default charts available, beyond Line/Bar/Area charts, Pie charts, Map charts, Bubble charts, Funnel charts and Range charts.

This article details how to add a Custom Chart to Metric Insights and make it available for use in Dataset Reporting for all content builders.

1. Go to Admin > Charting Options > JavaScript Chart Templates

Zoom:
  1. Access a List of available JavaScript Templates via Admin > Charting Options > JavaScript Chart Templates
  2. [+New Chart Template]

2. Add a new Chart Template

Zoom:

On the "Add JavaScript Chart Template":

  1. Switch the Template to "enabled"
  2. Define the Name
  3. From the dropdown, select the required Charting Engine
  4. Specify the Width and Height
    • Defaults are 900x600, modify if required
  5. Send as HTML: switch to "yes" to be able to control how your Chart is displayed in an email by your email program (NOTE: this requires writing an additional piece of HTML code)
  6. Save to proceed

3. Chart Template Editor > Info tab

Design your Chart by providing the code and adding custom properties in the corresponding sections.

Zoom:

After specifying the basics, you will be redirected to the full Chart Template Editor. On the Info tab, configure the following:

  1. JavaScript Code
    • JavaScript Code is the only required code for the Chart Template
  2. Custom Chart Properties
    • Depending on your needs, add your own Charting Variables
    • Click [+New Charting Variable] to customize your Chart with labels, colors or custom actions
  3. Custom Chart Engine [optional]
    • Send as HTML in emails: set to "yes" to see additional options
    • Enter the HTML additional code to configure how your Chart will be displayed by your email program
  4. CSS code [optional]
    • For further control of the Chart formatting, input the CSS code in the corresponding tab

4. Chart Template Editor > Report Settings tab

To make your Chart accessible for Dataset Reporting, go to the Report Settings tab.

Zoom:
  1. Enable for Dataset Reports: must be switched to "yes" if you plan to use this Chart Template when building Dataset Reports
  2. Use Legacy Data Format: defaults to "yes", switch to "no" if necessary
    • Legacy Data Format requires less space and allows faster data transfer (NOTE: this format has to be additionally converted for use by applying a special function)
    • When Legacy Data Format is turned off, you will be using the new Data Format that does not need to be converted and is ready for use (NOTE: data in this format requires more storage space and is transferred more slowly)
  3. Click [Select Icon] to open a pop-up with options
  4. Description: Add a description of how this chart should be used. This is helpful for content builders who are not familiar with the chart type and might need some guidance.
  5. Save your inputs

5. Your Chart Template is ready for use

Zoom:
  1. After a Custom Chart has been added, it will appear as a new option in the Charts section
  2. Use the Chart Editor to configure your Chart