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
adGroupId	adGroupId	A unique identifier for an ad group within a campaign.	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
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
conversions	conversions	The total number of conversions attributed to an ad or campaign.	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
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
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
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
sales	sales	The total sales amount generated from advertising.	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
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
url	url	The web address used for accessing a specific resource, such as a report download, product image, or an affiliate link.	dimension