AudienceReport: Most-used fields

The table below gives information about most-used fields that you can import from AudienceReport. 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.

API name	Adverity UI name	Description	Use in Adverity
clientAccountId	clientAccountId	A unique identifier for the client account within AudienceReport.	metric
costCurrency	costCurrency	The three-letter ISO 4217 code representing the currency used for cost calculations.	dimension
costs.costPerEventsInTargetGroup	costs.costPerEventsInTargetGroup	The cost incurred per event (e.g., impression, click) within the defined target audience group. This metric helps evaluate the efficiency of a campaign in reaching the desired audience.	metric
costs.costPerIncrementalReachInTargetGroup	costs.costPerIncrementalReachInTargetGroup	The cost incurred for each additional unique individual reached within the target audience group who had not been reached by other campaign elements.	metric
costs.costPerReachInTargetGroup	costs.costPerReachInTargetGroup	The cost incurred for each unique individual reached within the defined target audience group, regardless of prior exposure.	metric
costs.investment	costs.investment	The total monetary amount invested in a campaign or specific advertising activity.	metric
createdAt	createdAt	The timestamp indicating when the record was created.	dimension
eventType	eventType	The type of interaction or action being measured, such as an “Impression” or “Click”.	dimension
events	events	The total number of collected events, such as impressions or clicks, for a campaign or report item.	metric
eventsInTargetGroup	eventsInTargetGroup	The total number of specified events (e.g., impressions, clicks, video views) that occurred within the target audience.	metric
frequency	frequency	The average number of times each unique visitor was exposed to the campaign or triggered a report item event.	metric
id	id	A unique identifier for an entity, such as an account, channel, or item within the AudienceReport platform.	dimension
incrementalReachInTargetGroup	incrementalReachInTargetGroup	The number of additional unique individuals within the target audience group reached by a campaign who had not been reached by other campaign elements.	metric
incrementalReachInTargetGroupV2	incrementalReachInTargetGroupV2	The number of additional unique individuals within the target audience group reached by a campaign, using a potentially updated or refined calculation method (V2).	metric
incrementalReachPersonsInTargetGroupV2	incrementalReachPersonsInTargetGroupV2	The count of individual persons within the target audience group who represent incremental reach, calculated using a version 2 methodology.	metric
lastCalculatedAt	lastCalculatedAt	The timestamp indicating the last time the report data was processed or updated.	dimension
name	name	A descriptive label or title for an entity, such as an account, channel, or item.	dimension
personsHitrate	personsHitrate	The percentage of individuals within the measured audience who were successfully reached or engaged, often specifically within the defined target group.	metric
populationSize	populationSize	The total number of individuals in the overall population relevant to the report’s scope.	metric
reach	reach	The percentage of the target group that was exposed to the campaign or report item.	metric
reachInTargetGroup	reachInTargetGroup	The percentage of the defined target group that was reached by the campaign or measured activity.	metric
reachPersons	reachPersons	The number of unique individuals reached by the campaign or report item.	metric
reachPersonsInTargetGroup	reachPersonsInTargetGroup	The absolute number of unique individuals reached within the defined target group.	metric
shareInTargetGroup	shareInTargetGroup	The percentage or proportion of a specific metric (e.g., total reach, events) that is attributed to the defined target group.	metric
subItems	subItems	A list of identifiers for child items or components associated with a parent item, allowing for hierarchical structuring of campaign elements.	dimension
targetGroupSize	targetGroupSize	The total size of the selected demographic target group for the campaign.	metric
targetRatingPoints	targetRatingPoints	A measure of the total number of exposures to the target audience, expressed as a percentage of the target population multiplied by the average frequency of exposure.	metric
totalsByDemographics.ageCategory	totalsByDemographics.ageCategory	Demographic breakdown of data by predefined age ranges (e.g., 18-24, 25-34).	dimension
totalsByDemographics.children	totalsByDemographics.children	Demographic breakdown of data indicating the presence or absence of children in a household, or the number of children.	dimension
totalsByDemographics.education	totalsByDemographics.education	Demographic breakdown of data by educational attainment levels of the audience.	dimension
totalsByDemographics.employment	totalsByDemographics.employment	Demographic breakdown of data by employment status or category of the audience.	dimension
totalsByDemographics.gender	totalsByDemographics.gender	Demographic breakdown of data by the gender of the audience.	dimension
totalsByDemographics.householdSize	totalsByDemographics.householdSize	Demographic breakdown of data by the number of individuals residing in a household.	dimension
totalsByDemographics.income	totalsByDemographics.income	Demographic breakdown of data by income brackets or categories of the audience.	dimension
totalsByEventType	totalsByEventType	Aggregated data broken down by different types of events (e.g., impressions, clicks).	dimension
updatedAt	updatedAt	The timestamp indicating when the record was last updated.	dimension
weekStart	weekStart	The starting date of the weekly period for which the report data is aggregated, typically a Monday.	dimension
weekly	weekly	Indicates that the report data is broken down or aggregated on a weekly basis.	dimension