Map Widget

Map widgets provide a quick way to view data by country. You could visualize data by country using a bar or column chart, but the map makes it easy to get an overall understanding of the data, plus it's just more interesting to look at. Map widgets require the full width of the page.

You select this icon in the widget editor to display the map properties:

Example map widget

This sample map widget shows message success rate by country. In this particular example we've toggled on the data labels. When you hover over a country on a map widget, the country displays in a different color.

Screen shot showing a sample geo-map widget

How to build it

In the procedures below, we will create the widget shown above, which displays the sum of messages delivered. We'll base the widget on the report, SMS Daily Summary - This Month. The steps assume you've already created a dashboard to hold the widget.

Set required properties

  1. From your dashboard, select Add Widget and then select Custom.

    This displays the Add Custom Widget pop-up, which lets you create widgets based on the reports available to you.

    Screen shot of the Add Custom Widget window

  2. Select the plus sign (+) next to the report you want to use for the widget. You can add multiple widgets to the dashboard at once, but in this example we're going to add just one.

  3. Select Done.

    Since we added just one widget, the Edit Widget page displays next. If we had added multiple widgets, then we would be returned to the dashboard and the widgets would be added in the default List style.

  4. Under Properties and Type, select the geo-map icon.

    Note that the widget inherits the name of the report you based it on. You can change this if you like. The widget name will eventually display in the upper left. This can function as the only name for the widget or you can also give the widget a title. See step 1 under "Set Optional Properties".

  5. For Country Column, select Country Code Alpha-2.

  6. For Data Column, select the data you want to look at (e.g., Success Rate, Messages Accepted, etc.). For our example we'll select Success Rate.

Set optional properties

  1. Give your widget a Title. This will display in the center of the widget. We'll call our example, Success Rate by Country.
  2. Apply a specific Color Theme to the chart.
  3. Specify which Report Instance to use. By default this is set to Most Recent, meaning the data displayed by the widget is based on the most recent run of the report.

Once you click Save, you will be returned to the dashboard and your widget will display at the bottom. You can drag it to another position on the dashboard or move it to another dashboard if you wish.

Finished widget