Learn about metrics and dimensions offered in Singular reports.
- For more about Singular reports and how to use the Singular web UI, see the Reports FAQ.
- For other ways to get your reports, see Introduction to the Singular Reporting API and Singular Data Destinations (ETL) FAQ.
- To see precisely how Singular maps data from a specific partner, see Data Connectors in Detail.
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. |
