Supermetrics Support Forum

Requesting Missing Metrics and Dimensions

While we try to make sure the most valuable and most requested fields are added to our connectors, we don't add all fields supported by the data source APIs by default. So you may need to request additional fields to be added, which this guide will help you do.


Step #1 - Check That the Field Does Not Already Exist:

In some cases, we may have your field already in the product, but it may be under another name or listed as a dimension instead of a metric (or vice versa). We have the full field lists for all currently available metrics and dimensions here under "Integrations":

https://supermetrics.com/docs/


So please check under your data source's section for "Fields" to verify the field you want to use does not already exist. If it does not, then proceed to Step #2.


Step #2 - Check That the Field is Available in the API:

Most metrics and dimensions supported by the data source's own API can be added to the Supermetrics connectors. However, if the field you wish to have data for is not in the source API, there's no way we can support it.


Here's a list of the API documents* for the most popular data sources that you can check to see if they support the field you need added (those not listed you can still find on the internet):

Data SourceAPI Documentation Link
Facebook Adshttps://developers.facebook.com/docs/marketing-api/insights/parameters
Facebook Insightshttps://developers.facebook.com/docs/graph-api/reference/v2.12/insights
Google Ad Managerhttps://developers.google.com/ad-manager/api/reference/v201808/ReportService.ReportQuery
Google Adshttps://developers.google.com/adwords/api/docs/appendix/reports/all-reports
Google AnalyticsReporting API V4: https://developers.google.com/analytics/devguides/reporting/core/dimsmets
MCF Reporting V3: https://developers.google.com/analytics/devguides/reporting/mcf/dimsmets/
Google DV 360https://developers.google.com/bid-manager/v1/filters-metrics
Google Campaign Managerhttps://developers.google.com/doubleclick-advertisers/v3.3/dimensions
Google My Businesshttps://developers.google.com/my-business/reference/rest/
Instagram Insightshttps://developers.facebook.com/docs/instagram-api/reference (See IG Media and IG User)
LinkedIn Adshttps://docs.microsoft.com/en-us/linkedin/marketing/integrations/ads-reporting/ads-reporting
MailChimphttps://developer.mailchimp.com/documentation/mailchimp/reference/overview/
Microsoft Advertisinghttps://docs.microsoft.com/en-us/advertising/guides/report-attributes-performance-statistics?view=bingads-13&viewFallbackFrom=bingads-11
Twitter Adshttps://developer.twitter.com/en/docs/ads/analytics/overview/metrics-and-segmentation
YouTubehttps://developers.google.com/youtube/analytics/metrics


*The documents linked should be of the API version we are currently using with the data source integrations. Newer API versions may not be supported yet, so we may have to wait to add the field until we upgrade the version.


Step #3 - Requesting the New Field

Once you have confirmed the field is not already in Supermetrics and is in the API documentation for that source, then you can make the request to Supermetrics Support to have the field added!


Please submit a new ticket and make sure you have the following pieces of information contained in the ticket:

  • Name of the field(s) to be added. Please use either the UI label or the name from the API, so we're sure what field you mean
  • A link to the API documentation that shows the field is supported
  • And while not strictly required, it can help expedite us adding the field if you can grant us access to your data so we can test the field to make sure it works. Fill out the form for Granting Permission for Data Access to Support and note that you have done this in the ticket.

Support will then use your ticket to put in a feature request with the development team to add the field(s). Note that this process can take some time, so we appreciate your patience while we work on the request.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.