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.
ageCategory.categoryDimension
The category for a specific age group within the demographic breakdown of the report.
ageCategory.personsHitrateMetric
The persons hit rate for a specific age group, indicating the percentage of the target audience reached within that category.
ageCategory.shareMetric
The share of the audience falling into a specific age category within the demographic breakdown.
children.categoryDimension
The category indicating the presence or absence of children within the demographic breakdown of the report (e.g., 'Yes' or 'No').
children.personsHitrateMetric
The persons hit rate for the children category, indicating the percentage of the target audience reached within that category.
children.shareMetric
The share of the audience falling into a specific children category within the demographic breakdown.
clientAccountIdMetric
A unique identifier for the client account within AudienceReport.
configuredItemsDimension
A list of items configured for the report, including their ID, display name, and whether they are included in the report.
costCurrencyDimension
The three-letter ISO 4217 code representing the currency used for cost calculations.
costReportingEnabledDimension
A boolean flag indicating whether cost reporting is enabled for the report.
costs.costPerEventsInTargetGroupMetric
The cost incurred per event recorded within the specified target group.
costs.costPerIncrementalReachInTargetGroupMetric
The cost incurred per incremental reach achieved within the specified target group.
costs.costPerReachInTargetGroupMetric
The cost incurred per reach achieved within the specified target group.
costs.investmentMetric
The total investment or spend associated with the campaign or channel.
createdAtDimension
The timestamp indicating when the record was created.
creator.idDimension
The unique identifier of the user who created the report.
creator.nameDimension
The name of the user who created the report.
education.categoryDimension
The category for a specific education level within the demographic breakdown of the report.
education.personsHitrateMetric
The persons hit rate for a specific education level, indicating the percentage of the target audience reached within that category.
education.shareMetric
The share of the audience falling into a specific education category within the demographic breakdown.
employment.categoryDimension
The category for a specific employment status within the demographic breakdown of the report.
employment.personsHitrateMetric
The persons hit rate for a specific employment status, indicating the percentage of the target audience reached within that category.
employment.shareMetric
The share of the audience falling into a specific employment category within the demographic breakdown.
eventTypeDimension
The specific type of event, such as 'Impression', 'VideoStart', or 'Click'.
eventsMetric
The total number of collected events, such as impressions or clicks, for a campaign or report item.
eventsInTargetGroupMetric
The total number of specified events (e.g., impressions, clicks, video views) that occurred within the target audience.
frequencyMetric
The average number of times each unique visitor was exposed to the campaign or triggered a report item event.
gender.categoryDimension
The category for gender within the demographic breakdown of the report (e.g., 'Male', 'Female').
gender.personsHitrateMetric
The persons hit rate for a specific gender category, indicating the percentage of the target audience reached within that category.
gender.shareMetric
The share of the audience falling into a specific gender category within the demographic breakdown.
householdSize.categoryDimension
The category for a specific household size within the demographic breakdown of the report.
householdSize.personsHitrateMetric
The persons hit rate for a specific household size category, indicating the percentage of the target audience reached within that category.
householdSize.shareMetric
The share of the audience falling into a specific household size category within the demographic breakdown.
idMetric
The unique identifier for the report.
income.categoryDimension
The category for a specific income level within the demographic breakdown of the report.
income.personsHitrateMetric
The persons hit rate for a specific income category, indicating the percentage of the target audience reached within that category.
income.shareMetric
The share of the audience falling into a specific income category within the demographic breakdown.
incrementalReachInTargetGroupMetric
The additional unique audience reached within a specified target demographic or behavioral segment by a campaign, beyond those already exposed through other means. This metric measures the net new audience gained in the target group.
incrementalReachInTargetGroupV2Metric
The updated version of incremental reach achieved within the defined target group, often provided per channel or sub-item.
incrementalReachPersonsInTargetGroupV2Metric
The updated version of incremental reach in terms of persons within the defined target group, often provided per channel or sub-item.
isArchivedDimension
A boolean flag indicating whether the report is archived.
lastCalculatedAtDimension
The timestamp indicating the last time the report data was processed or updated.
nameDimension
The name of the report, channel, or item.
personsHitrateMetric
The percentage of individuals within the measured audience who were successfully reached or engaged, often specifically within the defined target group.
populationSizeMetric
The total number of individuals in the overall population relevant to the report's scope.
reachMetric
The percentage of the target group that was exposed to the campaign or report item.
reachInTargetGroupMetric
The percentage of the defined target group that was reached by the campaign or measured activity.
reachPersonsMetric
The number of unique individuals reached by the campaign or report item.
reachPersonsInTargetGroupMetric
The absolute number of unique individuals reached within the defined target group.
reportChannelCostsDimension
A list of cost details per channel, including channel ID, impressions purchased, and total spend.
shareInTargetGroupMetric
The percentage or proportion of a specific metric (e.g., total reach, events) that is attributed to the defined target group.
subItemsDimension
A list of sub-items associated with a reported item or channel, often containing their own detailed breakdown data.
targetGroup.countryDimension
An object containing details about the country of the target audience, including country code, name, and currency information.
targetGroup.countryCodeDimension
The two-letter country code (ISO 3166-1) that defines the target audience's country.
targetGroup.demographicsDimension
An object defining the demographic criteria used to specify the target audience for the report, such as age, gender, and education.
targetGroup.period.endDateDimension
The end date of the reporting period for the target group, in ISO 8601 format.
targetGroup.period.startDateDimension
The start date of the reporting period for the target group, in ISO 8601 format.
targetGroupSizeMetric
The total size of the selected demographic target group for the campaign.
targetRatingPointsMetric
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.
totalsByDemographics.ageCategoryDimension
A demographic breakdown of the report's audience by age category.
totalsByDemographics.childrenDimension
A demographic breakdown of the report's audience by presence of children.
totalsByDemographics.educationDimension
A demographic breakdown of the report's audience by education level.
totalsByDemographics.employmentDimension
A demographic breakdown of the report's audience by employment status.
totalsByDemographics.genderDimension
A demographic breakdown of the report's audience by gender.
totalsByDemographics.householdSizeDimension
A demographic breakdown of the report's audience by household size.
totalsByDemographics.incomeDimension
A demographic breakdown of the report's audience by income level.
totalsByEventTypeDimension
A breakdown of event data by event type, including total events and events within the target group.
updatedAtDimension
The timestamp indicating when the record was last updated.
weekStartDimension
The start date of the reporting week in ISO 8601 format.
weeklyDimension
A weekly breakdown of report data, including metrics like reach, frequency, and costs.