To be able to work with a data widget of any type, you'll need to add dimensions and metrics. These can be simple (or Data Source-Specific), aggregate, or custom. This article is designed to help you understand the difference between the variety of Dimensions and Metrics available in the Template Builder.
NinjaNote: It's important to note that you may sometimes be limited by dimension and metric combination limits. These limitations are unfortunately defined by the API of the data provider and are most often beyond NinjaCat's control.
Dimensions are required for most data widgets - they're how we're segmenting the data. In many of the data widgets, you can add one or more dimensions to provide granular detail on things such as, for example, Campaign Performance by Date, Demographic, or Channel.
Simple Dimensions (Data Source-Specific)
Simple dimensions can be defined as those available in a widget that contains just 1 data source (or multiple instances of the same data source).
Aggregate Dimensions are dimensions that are common across all the data sources being used in a widget. If the dimension you're looking for isn't available in the Aggregate list, you will need to use Custom Dimensions, which are explored in the next section. There are many fewer aggregate dimensions than simple ones, but using custom dimensions gives you massive flexibility when adding dimensions to your data widgets.
Custom Dimensions allow you to build a dimension - for example if one data source calls its dimension landing page title, and the other data source calls the same dimension landing page name, you can use the custom dimension builder to instruct NinjaCat to view these as the same Dimension, which you can then custom name.
NinjaNote: At least 1 Metric is required for all data widgets - it's the measurement of performance or value. In many of the data widgets, you can add one or more metrics to provide greater detail on overall performance, such as displaying Impressions alongside Clicks, Cost, and CPC.
Simple Metrics (Data Source-Specific)
Simple metrics can be defined as those available in a widget that is specific to one of the data sources being used. If we were to use Facebook and Google Ads in our widget, Clicks for example is available across both - if we select the simple metric of Clicks from under the Facebook Header in the widget inspector, we're only going to see clicks from Facebook. Likewise, if we only want to see clicks from Google Ads, but not Facebook, we'd select clicks from under the Google Ads header in the widget inspector. Using simple metrics allows great control over which data we present from each data source.
Aggregate Metrics are metrics that are common across all the data sources being used in a widget. If a metric, such as Clicks is available from all data sources you're using you'll find it as a simple metric, but also an aggregate one. Aggregate metrics combine the metric values from ALL of the data sources you're using - so if we used Aggregate Clicks when a widget included both Facebook and Google Ads, our clicks value would be a combined total from both of those data sources.
Custom Metrics allows you to combine metrics from individual data sources to build very specific calculations. - for example, if you're measuring clicks from one data source, but cost from another, the aggregate CPC metric won't give you what you want. Creating metrics in the custom metric editor allows you to specify exactly the calculation you want to use. Using an example of a widget containing Facebook and a Custom Data Source such as a Google Sheet, for example, we might want CPC to reflect Cost from the Google Sheet divided by Clicks from Facebook displayed as a currency. Using the aggregate CPC metric wouldn't be able to give us such a specific result, as it would provide us with Cost from Facebook AND the Google Sheet added together and divided by the total clicks from Facebook and the Google Sheet.
We'll look at how to add each of these dimensions and metrics in the template builder in the article: