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.category Dimension
The category for a specific age group within the demographic breakdown of the report.
ageCategory.personsHitrate Metric
The persons hit rate for a specific age group, indicating the percentage of the target audience reached within that category.
ageCategory.share Metric
The share of the audience falling into a specific age category within the demographic breakdown.
children.category Dimension
The category indicating the presence or absence of children within the demographic breakdown of the report (e.g., 'Yes' or 'No').
children.personsHitrate Metric
The persons hit rate for the children category, indicating the percentage of the target audience reached within that category.
children.share Metric
The share of the audience falling into a specific children category within the demographic breakdown.
clientAccountId Metric
A unique identifier for the client account within AudienceReport.
configuredItems Dimension
A list of items configured for the report, including their ID, display name, and whether they are included in the report.
costCurrency Dimension
The three-letter ISO 4217 code representing the currency used for cost calculations.
costReportingEnabled Dimension
A boolean flag indicating whether cost reporting is enabled for the report.
costs.costPerEventsInTargetGroup Metric
The cost incurred per event recorded within the specified target group.
costs.costPerIncrementalReachInTargetGroup Metric
The cost incurred per incremental reach achieved within the specified target group.
costs.costPerReachInTargetGroup Metric
The cost incurred per reach achieved within the specified target group.
costs.investment Metric
The total investment or spend associated with the campaign or channel.
createdAt Dimension
The timestamp indicating when the record was created.
creator.id Dimension
The unique identifier of the user who created the report.
creator.name Dimension
The name of the user who created the report.
education.category Dimension
The category for a specific education level within the demographic breakdown of the report.
education.personsHitrate Metric
The persons hit rate for a specific education level, indicating the percentage of the target audience reached within that category.
education.share Metric
The share of the audience falling into a specific education category within the demographic breakdown.
employment.category Dimension
The category for a specific employment status within the demographic breakdown of the report.
employment.personsHitrate Metric
The persons hit rate for a specific employment status, indicating the percentage of the target audience reached within that category.
employment.share Metric
The share of the audience falling into a specific employment category within the demographic breakdown.
eventType Dimension
The specific type of event, such as 'Impression', 'VideoStart', or 'Click'.
events Metric
The total number of collected events, such as impressions or clicks, for a campaign or report item.
eventsInTargetGroup Metric
The total number of specified events (e.g., impressions, clicks, video views) that occurred within the target audience.
frequency Metric
The average number of times each unique visitor was exposed to the campaign or triggered a report item event.
gender.category Dimension
The category for gender within the demographic breakdown of the report (e.g., 'Male', 'Female').
gender.personsHitrate Metric
The persons hit rate for a specific gender category, indicating the percentage of the target audience reached within that category.
gender.share Metric
The share of the audience falling into a specific gender category within the demographic breakdown.
householdSize.category Dimension
The category for a specific household size within the demographic breakdown of the report.
householdSize.personsHitrate Metric
The persons hit rate for a specific household size category, indicating the percentage of the target audience reached within that category.
householdSize.share Metric
The share of the audience falling into a specific household size category within the demographic breakdown.
id Metric
The unique identifier for the report.
income.category Dimension
The category for a specific income level within the demographic breakdown of the report.
income.personsHitrate Metric
The persons hit rate for a specific income category, indicating the percentage of the target audience reached within that category.
income.share Metric
The share of the audience falling into a specific income category within the demographic breakdown.
incrementalReachInTargetGroup Metric
The incremental reach achieved within the defined target group, typically calculated on a weekly basis.
incrementalReachInTargetGroupV2 Metric
The updated version of incremental reach achieved within the defined target group, often provided per channel or sub-item.
incrementalReachPersonsInTargetGroupV2 Metric
The updated version of incremental reach in terms of persons within the defined target group, often provided per channel or sub-item.
isArchived Dimension
A boolean flag indicating whether the report is archived.
lastCalculatedAt Dimension
The timestamp indicating the last time the report data was processed or updated.
name Dimension
The name of the report, channel, or item.
personsHitrate Metric
The percentage of individuals within the measured audience who were successfully reached or engaged, often specifically within the defined target group.
populationSize Metric
The total number of individuals in the overall population relevant to the report's scope.
reach Metric
The percentage of the target group that was exposed to the campaign or report item.
reachInTargetGroup Metric
The percentage of the defined target group that was reached by the campaign or measured activity.
reachPersons Metric
The number of unique individuals reached by the campaign or report item.
reachPersonsInTargetGroup Metric
The absolute number of unique individuals reached within the defined target group.
reportChannelCosts Dimension
A list of cost details per channel, including channel ID, impressions purchased, and total spend.
report_id Dimension
The unique identifier for the report.
report_name Dimension
The name of the report.
shareInTargetGroup Metric
The percentage or proportion of a specific metric (e.g., total reach, events) that is attributed to the defined target group.
subItems Dimension
A list of sub-items associated with a reported item or channel, often containing their own detailed breakdown data.
targetGroup.country Dimension
An object containing details about the country of the target audience, including country code, name, and currency information.
targetGroup.countryCode Dimension
The two-letter country code (ISO 3166-1) that defines the target audience's country.
targetGroup.demographics Dimension
An object defining the demographic criteria used to specify the target audience for the report, such as age, gender, and education.
targetGroup.period.endDate Dimension
The end date of the reporting period for the target group, in ISO 8601 format.
targetGroup.period.startDate Dimension
The start date of the reporting period for the target group, in ISO 8601 format.
targetGroupSize Metric
The total size of the selected demographic target group for the campaign.
targetRatingPoints Metric
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.ageCategory Dimension
A demographic breakdown of the report's audience by age category.
totalsByDemographics.children Dimension
A demographic breakdown of the report's audience by presence of children.
totalsByDemographics.education Dimension
A demographic breakdown of the report's audience by education level.
totalsByDemographics.employment Dimension
A demographic breakdown of the report's audience by employment status.
totalsByDemographics.gender Dimension
A demographic breakdown of the report's audience by gender.
totalsByDemographics.householdSize Dimension
A demographic breakdown of the report's audience by household size.
totalsByDemographics.income Dimension
A demographic breakdown of the report's audience by income level.
totalsByEventType Dimension
A breakdown of event data by event type, including total events and events within the target group.
updatedAt Dimension
The timestamp indicating when the record was last updated.
weekStart Dimension
The start date of the reporting week in ISO 8601 format.
weekly Dimension
A weekly breakdown of report data, including metrics like reach, frequency, and costs.