Bol.: Most-used fields#
The table below gives information about most-used fields that you can import from Bol.. 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.
acos Metric
Advertising Cost of Sales (ACoS), representing advertising spend as a percentage of sales generated from advertising.
adGroupId Metric
A unique identifier for an ad group within a campaign.
averageWinningBid Metric
The average bid amount that resulted in a won auction for an ad, keyword, or target.
bidding.automaticBidDesiredAcosPercentage Metric
The desired ACoS (Advertising Cost of Sales) percentage set for automatic bidding strategies. This indicates the target advertising spend as a percentage of generated sales.
bidding.defaultBid Metric
The default bid amount set for an ad group or keyword, used when no specific bid is provided.
bidding.strategy Dimension
The strategy chosen for advertising campaigns, such as automatic or manual bidding, to optimize ad spend and achieve performance goals.
campaignId Metric
A unique identifier for a campaign.
campaignName Dimension
The name of the campaign.
categoryId Metric
A unique identifier for a product category.
categoryName Dimension
The name of the product category.
clicks Metric
The number of clicks an ad or campaign received.
conversionRate Metric
The percentage of clicks that resulted in a conversion.
conversions Metric
The total number of conversions attributed to an ad or campaign.
countries Dimension
The country or countries where the ad campaign is active or targeted.
cpc Metric
Cost per click, the amount paid for each click on an ad.
ctr Metric
Click-through rate (CTR), the percentage of impressions that resulted in a click.
dailyBudget Metric
The maximum amount of money allocated for spending on a campaign or ad group per day.
date Dimension
The specific date for which the performance metrics are reported.
defaultBid Metric
The default bid amount set for an ad group or keyword, used when no specific bid is provided.
ean Metric
The European Article Number, a unique identifier for a product.
endDate Dimension
The end date of the reporting period or campaign duration.
exportDate Dimension
The date when a report or data export was generated and made available, indicating the freshness and validity of the data within the report.
impressions Metric
The total number of times an ad was displayed.
keywordMatchType Dimension
The match type of the keyword (e.g., EXACT, PHRASE, BROAD).
keywordText Dimension
The actual text of the keyword.
name Dimension
The human-readable name or title of an entity, such as a campaign, ad group, product, or report.
roas Metric
Return on Advertising Spend (ROAS), representing the revenue generated for every unit of advertising cost.
sales Metric
The total sales amount generated from advertising.
searchTerm Dimension
The actual search query entered by a user that triggered an ad.
searchVolume Metric
The estimated number of times a specific search term was queried.
spent Metric
The total amount of money spent on advertising.
startDate Dimension
The start date of the reporting period or campaign duration.
state Dimension
The current status or state of an entity, such as an advertising campaign, ad group, offer, or an asynchronous report generation process.
subcategories Dimension
A hierarchical classification of products or listings, representing categories nested under a broader main category.
targetProductId Metric
A unique identifier for a product that is specifically targeted by an ad campaign.
targetingType Dimension
The method used to focus advertising efforts on a specific audience or product group, such as automatic targeting (AI-driven) or manual targeting (keyword-based).
totalBudget Metric
The maximum total amount of money allocated for spending throughout the entire duration of a campaign.
url Dimension
The web address used for accessing a specific resource, such as a report download, product image, or an affiliate link.