Metrics and Dimensions

Learn about metrics and dimensions offered in Singular reports.

Note: Some of the metrics and dimensions below are limited to enterprise customers or customers using premium features.

Dimensions

Name in Singular UI Name in Singular API/ETL Exports Description Pulled From (Learn More)
Account ID adn_account_id Your account ID from which we pulled the data. In some networks, such as Facebook and Google Ads, you may have multiple ad account IDs. Ad Network
Account Name adn_account_name The account name of the campaign, as reported by the ad network (when applicable). Ad Network
App app The app name as configured in the Apps page. Ad Network/Tracker
App Site ID app_site_id The app site identifier as configured in the Apps page (see What is the difference between an app and an app site?). Ad Network/Tracker
Campaign ID unified_campaign_id The ID of the campaign (see Campaign Name for more information). Ad Network/Tracker
Campaign Name unified_campaign_name The name of the campaign. Usually this is pulled from the ad network, but if it's missing in the ad network, the dimension reflects the campaign name reported by the attribution tracker. Ad Network/Tracker
Campaign URL adn_campaign_url The URL that is triggered when a user clicks on a campaign ad (the tracking link URL), as reported by the network. See also: Final URL. Ad Network
Click Type adn_click_type The click type as reported by the ad network, where applicable. Ad Network
Conversion Type conversion_type How the user interacted with the ad. Possible values: "Click-through" (an ad click) or "View-through" (an ad impression).  
Country country_field The user's country, as reported by the network. Ad Network/Tracker
Device Model device_model In Aura campaigns only: the device model the ad was displayed in, e.g., LM-X320. Ad Network
DMA ID dma_id_field In Facebook campaigns only: the ID of the Designated Marketing Area that the ad was targeted to. Ad Network
DMA Name dma_name_field In Facebook campaigns only: the name of the Designated Marketing Area that the ad was targeted to. Ad Network
Facebook Ad Set ID fb_adset_id In Facebook campaigns only: the "Ad Set ID" given by Facebook. Ad Network
Facebook Campaign ID fb_campaign_id In Facebook campaigns only: the campaign ID given by Facebook. Ad Network
Final URL final_url In Google Ads (AdWords) campaigns, this field contains the tracking link arguments (suffixes), as they are not included in the Campaign URL reported by Google. Ad Network
Is UAC is_uac In Google Ads (AdWords) campaigns only: is the campaign a "Universal App Campaign" (see Google's documentation for more information). Ad Network
Keyword keyword In search results ad campaigns: the search keyword as reported by the ad network. Applicable to Apple Search Ads, Bing, Google Ads (AdWords), Yahoo, etc. Ad Network
Keyword ID keyword_id The internal ID given by the ad network to the targeted search keyword. Ad Network
Network Campaign ID adn_campaign_id The ID of the campaign, as pulled from the ad network. Ad Network
Network Campaign Name adn_campaign_name The name of the campaign, as pulled from the ad network. Ad Network
Network Sub Campaign ID adn_sub_campaign_id The ID of the sub-campaign, as pulled from the ad network. A sub-campaign is Singular's name for an additional grouping of ads that some networks have under the campaign level. Some networks may call it "ad group" or "ad set".  
Network Sub Campaign Name adn_sub_campaign_name The name of the sub-campaign, as pulled from the ad network. A sub-campaign is Singular's name for an additional grouping of ads that some networks have under the campaign level. Some networks may call it "ad group" or "ad set".  
Original Currency adn_original_currency The original currency as reported by the ad network. This may be different from the default currency set up for you in Singular. Ad Network
OS os The operating system of the marketed product. For an app, this usually indicates which app store the app is sold in,, e.g. "iOS" or "Android". Ad Network/Tracker
Platform platform The platform of the marketed product, e.g. "iPhone" or "iPad". Ad Network/Tracker
Public Id site_public_id The app's ID in the Apple App Store or Google Play.  
Publisher ID publisher_id The hashed ID of the publisher (app) in which the ad has been displayed. Ad Network
Publisher Site ID publisher_site_id The public ID of the publisher (app) in which the ad has been displayed. This field is only populated if this information is provided by the ad network. Ad Network
Publisher Site Name publisher_site_name The name of the publisher (app) in which the ad has been displayed. This field is only populated if this information is provided by the ad network. Ad Network
Retargeting retention Whether the campaign is a retargeting campaign (Yes/No).  
Source source The name of the data source (usually the ad network). Ad Network/Tracker
Status adn_status The campaign status (enabled/disabled) as reported by the network (when applicable). Ad Network
Sub Ad Network adn_sub_adnetwork_name The sub ad network, as reported by the ad network. This is an additional level of hierarchy that some networks have. E.g., Google Ads has YouTube, Shopping, etc. Ad Network
Sub Campaign ID sub_campaign_id The sub-campaign ID (when applicable). A sub-campaign is Singular's name for an additional grouping of ads that some networks have under the campaign level. Some networks may call it "ad group" or "ad set". Ad Network/Tracker
Sub Campaign Name sub_campaign_name The sub-campaign name (when applicable). A sub-campaign is Singular's name for an additional grouping of ads that some networks have under the campaign level. Some networks may call it "ad group" or "ad set". Ad Network/Tracker
Tracking URL tracking_url In Google Ads (AdWords) campaigns, each ad click triggers two separate URLs: a destination (e.g. the advertiser's store) and a tracking URL. This field contains the tracking URL. Ad Network
Tracker Name tracker_name The name configured in the attribution tracker's platform for the tracking link. Tracker
UTC Offset adn_utc_offset The timezone offset of the campaign data, relative to UTC. Ad Network
  singular_campaign_id The campaign ID in Singular. This may be different from the original campaign ID - for example, if there are duplicates.  

Metrics

Name in Singular UI Name in Singular API Description
ARPU arpu Average revenue per user.
Clicks custom_clicks Number of ad clicks. By default, this metric is pulled from the tracker side, but it can be set up to show clicks reported by the ad network.
Clicks Discrepancy clicks_discrepancy The difference between clicks reported by the tracker and clicks reported by the network. Use this metric to help you identify and troubleshoot major discrepancies. Formula: Tracker Clicks - Network Clicks
Cost adn_cost Cost (ad spend) reported by the ad network, in your default currency configured in Singular.
CTR ctr Click-through rate (ration of clicks to impressions).
CVR cvr Conversion rate (ratio of installs to clicks).
DAU daily_active_users Daily Active Users: Number of unique users who had at least one session in the day. The day is the rolling day since the user's time of attribution. For periods of more than one day, the DAU is the average of the daily active users for the selected days.
eCPC ecpc Effective Cost per Click: the total cost divided by the total click count.
eCPI ecpi Effective Cost per Install: the total cost divided by the total install count.
eCPI (Orig. Cost) ecpi_original_cost Effective Cost per Install, but based on the original cost, before any currency conversions.
eCPM ecpm Effective Cost per Mille: the cost per 1000 impressions.
eCPM ad_ecpm Effective cost per one thousand impressions.
Est. Conversions adn_estimated_total_conversions An estimate of total conversions as reported by the ad network (when available).
Impressions custom_impressions Number of ad views. By default, this metric is pulled from the tracker side, but it can be set up to show clicks reported by the ad network.
Impressions Discrepancy impressions_discrepancy The difference between impressions reported by the tracker and impressions reported by the network. Use this metric to identify and troubleshoot major discrepancies. Formula: Tracker Impressions - Network Impressions
Installs custom_installs Installs as displayed in the Singular UI. This is a custom field and can be set to show network side installs for some sources and tracker
Installs Discrepancy installs_discrepancy The difference between installs reported by the tracker and installs reported by the network. Use this metric to help you identify and troubleshoot major discrepancies. Formula: Tracker Installs - Network Installs
Network Clicks adn_clicks The number of ad clicks as reported by the ad network.
Network Impressions adn_impressions The number of ad views as reported by the ad network.
Network Installs adn_installs The number of app installs as reported by the ad network.
oCVR ocvr Conversion rate from impressions to installs (the number of installs divided by impressions).
Original Cost adn_original_cost Original cost (presented in the original currency) reported by the ad network. In API queries, we recommend using this metric only when using the "adn_original_currency" dimension
Original Currency adn_original_currency The currency of the Original Cost value.
Re-Engagements tracker_reengagements Number of re-engaged users.
Revenue revenue Revenue gained from the cohort of users.
ROI roi Return on Investment (return on ad spend): the revenue divided by the cost.
Tracker Clicks tracker_clicks Clicks reported by the attribution tracker.
Tracker Installs tracker_installs Number of installs as reported by the attribution tracker.

 

Was this article helpful?