Singular: Most-used fields#
The table below gives information about most-used fields that you can import from Singular. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
Ad ROI Dimension
The Return on Investment for advertising campaigns. This is a cohort metric used to measure the profitability of ad spending.
App Revenue Dimension
This field represents the revenue generated from in-app purchases within mobile applications. It is a key metric for understanding the monetary value users bring to your app campaigns.
Web Revenue Dimension
This field represents revenue generated from web activities. While the Singular API primarily focuses on mobile app attribution and monetization, general revenue metrics might encompass web-attributed revenue if web attribution is set up. However, an explicit 'Web Revenue' metric separate from app revenue is not distinctly defined in the API documentation.
adn_clicks Metric
The number of clicks reported by the ad network for campaigns.
adn_cost Metric
The cost of advertising campaigns as reported by the ad network.
adn_creative_name Dimension
The name of the creative asset used in the ad campaign.
adn_impressions Metric
The number of ad impressions (views) reported by the ad network for campaigns.
adn_installs Dimension
The number of app installs reported by the ad network.
adn_original_cost Metric
This metric represents the raw cost reported by the ad network (ADN) in its original currency, before any currency conversions or adjustments. It reflects the direct expense of advertising campaigns.
app Dimension
The name of the application as identified in Singular.
bid_amount Dimension
This dimension represents the amount of the bid set for a campaign, as reported by the ad network. It is a property related to campaign settings.
bid_strategy Dimension
The bidding strategy employed for the advertising campaign.
campaign_status Dimension
The current operational status of an advertising campaign.
country_field Dimension
The country where the user is located, often inferred from campaign targeting settings if not directly available.
custom_clicks Metric
The number of clicks on ads or marketing content recorded via custom tracking mechanisms.
custom_impressions Metric
A combined metric representing the number of impressions, intelligently chosen by Singular from either the ad network or tracker data.
custom_installs Metric
The number of application installs attributed through custom tracking mechanisms.
daily_active_users Metric
The number of unique users who engaged with the app on a given day. This is a metric from the attribution tracker.
end_date Dimension
The end date for the data query range (inclusive).
keyword Dimension
The specific keyword associated with an ad campaign, used for breakdown and analysis.
min_roas Dimension
The minimum Return On Ad Spend (ROAS) target set for a campaign.
os Dimension
The operating system of the user's device (e.g., iOS, Android).
platform Dimension
The platform on which the application is running (e.g., iOS, Android). Often similar to OS.
publisher_id Dimension
The identifier for the publisher site or app where the ad was displayed.
publisher_site_name Dimension
The name of the publisher site or app where the ad was displayed.
source Dimension
The name of the ad network or traffic source where campaigns are run, as identified in Singular.
start_date Dimension
The start date for the data query range (inclusive).
sub_campaign_name Dimension
The name of a sub-campaign, used to identify and categorize marketing efforts at a more detailed level.
tracker_clicks Metric
The number of clicks recorded by the attribution tracker.
tracker_conversions Metric
The number of conversions (e.g., installs, events) recorded by the attribution tracker.
tracker_impressions Dimension
The number of ad impressions recorded by the attribution tracker.
tracker_installs Metric
The number of app installs recorded by the attribution tracker.
tracker_reengagements Metric
The number of user re-engagements with the app recorded by the attribution tracker.
unified_campaign_name Dimension
A standardized campaign name used across different data sources for unified reporting.