Learn about the metrics and dimensions offered in Singular reporting.
- 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 & Data Destinations (ETL) |
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 |
Asset ID | asset_id | [Creative Reporting] "Asset ID" and "Asset Name" apply only to UAC (mobile app) campaigns in Google Ads (AdWords). These campaigns have an additional level of granularity in which a single creative (ad) can contain multiple assets (images, videos, and texts), and each asset has its own name and ID. For more information, see the AdWords Data Connector Guide. Note: Due to a Google Ads API limitation, you currently can't see Installs broken down by asset, only by creative. |
Ad Network |
Asset Name | asset_name | [Creative Reporting] "Asset ID" and "Asset Name" apply only to UAC (mobile app) campaigns in Google Ads (AdWords). These campaigns have an additional level of granularity in which a single creative (ad) can contain multiple assets (images, videos, and texts), and each asset has its own name and ID. For more information, see the AdWords Data Connector Guide. Note: Due to a Google Ads API limitation, you currently can't see Installs broken down by asset, only by creative. |
Ad Network |
Bid Amount | bid_amount |
The bid amount in your organization's default currency (converted from Original Bid Amount). Note: For Google Ads, Singular only pulls the bid amount for campaigns in which the Bid Type is “Target CPA”. Learn more in the Campaign Properties FAQ. | |
Bid Strategy | bid_strategy |
This dimension contains the original data that we pulled from the ad network in order to deduce the Standardized Bid Strategy. Learn more in the Campaign Properties FAQ. To see exactly which setting we pull from each network and the logic we use to standardize it, see Campaign Properties Data Mapping. | |
Bid Type |
bid_type |
This dimension contains the original data that we pulled from the ad network in order to deduce the Standardized Bid Type. Learn more in the Campaign Properties FAQ. To see exactly which setting we pull from each network and the logic we use to standardize it, see Campaign Properties Data Mapping. | |
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 Objective | campaign_objective | For ad networks that distinguish between the campaign objective and the bid type, such as Facebook and Snapchat, this dimension contains the campaign objective. You can also use it to find out if this is a mobile app install campaign. Learn more in the Campaign Properties FAQ. To see exactly which setting we pull from each network to populate this dimension, see Campaign Properties Data Mapping. | |
Campaign Status | campaign_status | Is the campaign live or not? Note that this is not a standardized dimension, so it may contain different values based on the ad network, e.g. “live/not live” vs. “true/false”. Learn more in the Campaign Properties FAQ. | |
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 |
City | city_field |
The user's city, as reported by the ad network. The availability of this dimension depends on the network. Not available for creative reports. | 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 |
Creative Height | creative_height | [Creative Reporting] The height of an image/video creative, in pixels. | |
Creative ID | creative_id | [Creative Reporting] The unique identifier of the creative. | |
Creative Name | creative_name | [Creative Reporting] The name of the creative, usually given by the customer. | |
Creative Reported URL | creative_reported_url | [Creative Reporting] The URL that is triggered when the user clicks the creative. | |
Creative Type | creative_type | [Creative Reporting] "Video", "Image", "Text", or "Carousel". If the Creative Type is "Text," it means the ad has only text. "Carousel" is a Facebook ad format that displays multiple images in a single ad. | |
Creative Width | creative_width | [Creative Reporting] The width of an image/video creative, in pixels. | |
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 | The ID of the Designated Marketing Area that the ad was targeted to. The availability of this dimension depends on the network. Not available for creative reports. | Ad Network |
DMA Name | dma_name_field | The name of the Designated Marketing Area that the ad was targeted to. The availability of this dimension depends on the network. Not available for creative reports. | 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 |
Facebook ROAS Bid | min_roas | For Facebook campaigns in which the campaign objective was set to Lowest Cost with Min ROAS (rather than having a set bid amount in dollars), we store the minimum ROAS percent in this dimension. The Bid Amount dimension for these campaigns will be empty. Learn more in the Campaign Properties FAQ. | |
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 Creative ID | adn_creative_id | [Creative Reporting] The creative ID as reported by the ad network. | Ad Network |
Network Creative Name | adn_creative_name | [Creative Reporting] The creative name as reported by 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 Bid Amount | original_bid_amount | The bid amount in the original currency. Learn more in the Campaign Properties FAQ. | |
Original Bid Currency | original_metadata_currency | The original currency of the bid (see Original Bid Amount). Learn more in the Campaign Properties FAQ. | |
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 (see What is the difference between an app and an app site?). | |
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 |
Region |
region_field |
The user's geographic region, as reported by the ad network. The availability of this dimension depends on the network. Not available for creative reports. | 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 |
Standardized Bid Strategy | standardized_bid_strategy |
The bid strategy for the campaign: Manual: A fixed bid you determined in advance, e.g. $7 per install or $8 per action. Target: Bidding based on a target bid amount, e.g. $7 CPI, as used in Facebook and Google Ads. Max: Bidding based on a maximum bid amount (e.g. in Facebook when your choice is “Lowest Cost with Bid Cap”). If this is your Standardized Bid Strategy, the Bid Amount represents the maximum amount you were willing to pay. Auto: Automatic bidding (e.g. in Facebook when your choice is “Lowest Cost without Cap”). If the Standardized Bid Strategy is Auto, the Bid Amount dimension is going to be empty. Learn more in the Campaign Properties FAQ. |
|
Standardized Bid Type | standardized_bid_type | The method by which the bid is set up: ROI (ROAS), CPM, CPC, CPI, CPA, or CPCV. Learn more in the See Campaign Properties FAQ. | Ad Network |
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 |
Text | creative_text | [Creative Reporting] The text associated with the creative (the creative may or may not have other elements associated with it, such as an image or a video). | |
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 Campaign ID |
tracker_campaign_id |
The campaign ID as pulled from the tracker. | Tracker |
Tracker Campaign Name |
tracker_campaign_name |
The campaign name as pulled from the tracker. | Tracker |
Tracker Creative ID | tracker_creative_id | [Creative Reporting] The creative ID as reported by the tracker. | Tracker |
Tracker Creative Name | tracker_creative_name | [Creative Reporting] The creative name as reported by the tracker. | Tracker |
Tracker Name | tracker_name | The name configured in the attribution tracker's platform for the tracking link. | Tracker |
Tracker Source Name |
tracker_source_name |
The name of the ad network, as pulled from the tracker. May be slightly different than the Source field (which holds the network name as it's listed in Singular). | Tracker |
Tracker Sub Campaign ID |
tracker_sub_campaign_id |
The ID of the sub campaign (ad group/ad set), as pulled from the tracker. | Tracker |
Tracker Sub Campaign Name |
tracker_sub_campaign_name |
The name of the sub campaign (ad group/ad set), as pulled from the tracker. | 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. | ||
|
creative_hash |
[Creative Reporting] The calculated MD5 hash for the creative. |
|
|
creative_image_hash |
[Creative Reporting] The calculated MD5 hash specifically for the image (in contrast with creative_hash, which is a hash for the entire contents of any creative, including text). |
|
|
singular_creative_id |
[Creative Reporting] An identifier given by Singular to the creative. This may be different from the original ID pulled from the ad network or the tracke (for example, if there are duplicates). |
|
|
creative_is_video |
[Creative Reporting] True if the creative is a video, false otherwise. |
|
|
creative_url |
[Creative Reporting] The URL of the creative (or ad). |
|
Metrics
Name in Singular UI | Name in Singular API & Data Destinations (ETL) | Description | Notes |
ARPU | arpu | Average revenue per user. | Cohort metric (learn more) |
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 | |
Completed Video View Rate | completed_video_view_ rate | Percentage of videos that were viewed in their entirety out of videos that were initiated. Formula: (Completed Video Views / Video Views) * 100 | Available in creative reports (learn more) |
Completed Video Views | completed_video_views | How many videos were viewed in their entirety. | Available in creative reports (learn more) |
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. | |
Original Revenue | original_revenue | If there are any custom calculations applied to the "Revenue" metric in your account, use "Original Revenue" to see the original revenue value as reported by the source. | Cohort metric (learn more) |
Re-Engagements | tracker_reengagements | Number of re-engaged users. | |
Revenue | revenue | The revenue gained from the cohort of users in the selected cohort period. | Cohort metric (learn more) |
ROI | roi | Return on Investment (return on ad spend): the revenue divided by the cost. | Cohort metric (learn more) |
Tracker Clicks | tracker_clicks | Clicks reported by the attribution tracker. | |
Tracker Installs | tracker_installs | Number of installs as reported by the attribution tracker. | |
Video Views | video_views | How many videos were initiated. Depending on the network and ad type, this metric may be the same as "ad impressions". | Available in creative reports (learn more) |
Video Views 25% | video_views_25pct | How many videos were viewed to the 25% point. | Available in creative reports (learn more) |
Video Views 50% | video_views_50pct | How many videos were viewed to the halfway point. | Available in creative reports (learn more) |
Video Views 75% | video_views_75pct | How many videos were viewed to the 75% point. | Available in creative reports (learn more) |