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.

API name	Adverity UI name	Description	Use in Adverity
acos	acos	Advertising Cost of Sales (ACoS), representing advertising spend as a percentage of sales generated from advertising.	metric
acos14d	acos14d	The Advertising Cost of Sale (ACoS) over a 14-day period, indicating the ratio of advertising spend to the sales generated from advertising.	dimension
adConstraints	adConstraints		dimension
adGroupId	adGroupId	A unique identifier for an ad group within a campaign.	metric
adGroupName	adGroupName	The name of the ad group, which is a collection of ads with a common theme or targeting strategy within a campaign.	dimension
adId	adId	A unique identifier for a specific advertisement.	dimension
averageCpc	averageCpc	The average cost per click (CPC) on your sponsored products advertisements. It is calculated as the total advertising cost divided by the total number of clicks.	metric
averageWinningBid	averageWinningBid	The average bid amount that resulted in a won auction for an ad, keyword, or target.	metric
bidding.automaticBidDesiredAcosPercentage	bidding.automaticBidDesiredAcosPercentage	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.	metric
bidding.defaultBid	bidding.defaultBid	The default bid amount set for an ad group or keyword, used when no specific bid is provided.	metric
bidding.strategy	bidding.strategy	The strategy chosen for advertising campaigns, such as automatic or manual bidding, to optimize ad spend and achieve performance goals.	dimension
campaignId	campaignId	A unique identifier for a campaign.	metric
campaignName	campaignName	The name of the campaign.	dimension
campaignStartDate	campaignStartDate	The date when the advertising campaign officially began.	dimension
campaignType	campaignType	The classification or type of the advertising campaign, such as automatic or manual targeting.	dimension
categoryId	categoryId	A unique identifier for a product category.	metric
categoryName	categoryName	The name of the product category.	dimension
clicks	clicks	The number of clicks an ad or campaign received.	metric
conversionRate	conversionRate	The percentage of clicks that resulted in a conversion.	metric
conversionRate14d	conversionRate14d	The percentage of clicks that resulted in a conversion within 14 days of the click, attributed to the click date. It is calculated as conversions divided by clicks.	metric
conversions	conversions	The total number of conversions attributed to an ad or campaign.	metric
conversions14d	conversions14d	The total number of conversions attributed to ads over a 14-day period.	metric
cost	cost	The total amount spent on advertising for your sponsored products.	metric
countries	countries	The country or countries where the ad campaign is active or targeted.	dimension
cpc	cpc	Cost per click, the amount paid for each click on an ad.	metric
ctr	ctr	Click-through rate (CTR), the percentage of impressions that resulted in a click.	metric
dailyBudget	dailyBudget	The maximum amount of money allocated for spending on a campaign or ad group per day.	metric
dailyBudgetAmount	dailyBudgetAmount	The maximum monetary amount allocated to be spent on a campaign or ad group per day.	metric
dailyBudgetCurrency	dailyBudgetCurrency	The currency in which the daily budget amount is denominated.	dimension
dailySpendAmount	dailySpendAmount	The actual monetary amount spent on advertising within a single day.	metric
dailySpendCurrency	dailySpendCurrency	The currency in which the daily spend amount is denominated.	dimension
date	date	The specific date for which the performance metrics are reported.	dimension
defaultBid	defaultBid	The default bid amount set for an ad group or keyword, used when no specific bid is provided.	metric
directConversions14d	directConversions14d	The number of conversions directly attributed to an ad within a 14-day period, typically when a customer converts immediately after clicking an ad.	metric
ean	ean	The European Article Number, a unique identifier for a product.	metric
endDate	endDate	The end date of the reporting period or campaign duration.	dimension
exportDate	exportDate	The date when a report or data export was generated and made available, indicating the freshness and validity of the data within the report.	dimension
impressions	impressions	The total number of times an ad was displayed.	metric
indirectConversions14d	indirectConversions14d	The number of conversions indirectly attributed to an ad within a 14-day period, typically when a customer converts after interacting with an ad but not immediately.	metric
keywordMatchType	keywordMatchType	The match type of the keyword (e.g., EXACT, PHRASE, BROAD).	dimension
keywordText	keywordText	The actual text of the keyword.	dimension
name	name	The human-readable name or title of an entity, such as a campaign, ad group, product, or report.	dimension
roas	roas	Return on Advertising Spend (ROAS), representing the revenue generated for every unit of advertising cost.	metric
roas14d	roas14d	The Return On Ad Spend (ROAS) within a 14-day period following the click, attributed to the click date. It is calculated as sales within 14 days divided by the advertising cost.	metric
sales	sales	The total sales amount generated from advertising.	metric
sales14d	sales14d	The total sales revenue generated from sponsored products over a 14-day period.	metric
searchTerm	searchTerm	The actual search query entered by a user that triggered an ad.	dimension
searchVolume	searchVolume	The estimated number of times a specific search term was queried.	metric
spent	spent	The total amount of money spent on advertising.	metric
startDate	startDate	The start date of the reporting period or campaign duration.	dimension
state	state	The current status or state of an entity, such as an advertising campaign, ad group, offer, or an asynchronous report generation process.	dimension
subcategories	subcategories	A hierarchical classification of products or listings, representing categories nested under a broader main category.	dimension
targetChannels	targetChannels	The platform or device channels (e.g., desktop, mobile, app, tablet) where ads are displayed.	dimension
targetCountries	targetCountries	The countries where the advertising campaign is targeted (e.g., Netherlands, Belgium).	dimension
targetProductId	targetProductId	A unique identifier for a product that is specifically targeted by an ad campaign.	metric
targetingType	targetingType	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).	dimension
totalBudget	totalBudget	The maximum total amount of money allocated for spending throughout the entire duration of a campaign.	metric
totalBudgetAmount	totalBudgetAmount	The total maximum monetary amount allocated for an advertising campaign.	metric
totalBudgetCurrency	totalBudgetCurrency	The currency in which the total budget amount is denominated.	dimension
totalSpendAmount	totalSpendAmount	The total monetary amount spent on advertising for a campaign or ad group.	metric
totalSpendCurrency	totalSpendCurrency	The currency in which the total spend amount is denominated.	dimension
url	url	The web address used for accessing a specific resource, such as a report download, product image, or an affiliate link.	dimension