Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
acosMetric

Advertising Cost of Sales (ACoS), representing advertising spend as a percentage of sales generated from advertising.

adGroupIdMetric

A unique identifier for an ad group within a campaign.

averageWinningBidMetric

The average bid amount that resulted in a won auction for an ad, keyword, or target.

bidding.automaticBidDesiredAcosPercentageMetric

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.defaultBidMetric

The default bid amount set for an ad group or keyword, used when no specific bid is provided.

bidding.strategyDimension

The strategy chosen for advertising campaigns, such as automatic or manual bidding, to optimize ad spend and achieve performance goals.

campaignIdMetric

A unique identifier for a campaign.

campaignNameDimension

The name of the campaign.

categoryIdMetric

A unique identifier for a product category.

categoryNameDimension

The name of the product category.

clicksMetric

The number of clicks an ad or campaign received.

conversionRateMetric

The percentage of clicks that resulted in a conversion.

conversionsMetric

The total number of conversions attributed to an ad or campaign.

countriesDimension

The country or countries where the ad campaign is active or targeted.

cpcMetric

Cost per click, the amount paid for each click on an ad.

ctrMetric

Click-through rate (CTR), the percentage of impressions that resulted in a click.

dailyBudgetMetric

The maximum amount of money allocated for spending on a campaign or ad group per day.

dateDimension

The specific date for which the performance metrics are reported.

defaultBidMetric

The default bid amount set for an ad group or keyword, used when no specific bid is provided.

eanMetric

The European Article Number, a unique identifier for a product.

endDateDimension

The end date of the reporting period or campaign duration.

exportDateDimension

The date when a report or data export was generated and made available, indicating the freshness and validity of the data within the report.

impressionsMetric

The total number of times an ad was displayed.

keywordMatchTypeDimension

The match type of the keyword (e.g., EXACT, PHRASE, BROAD).

keywordTextDimension

The actual text of the keyword.

nameDimension

The human-readable name or title of an entity, such as a campaign, ad group, product, or report.

roasMetric

Return on Advertising Spend (ROAS), representing the revenue generated for every unit of advertising cost.

salesMetric

The total sales amount generated from advertising.

searchTermDimension

The actual search query entered by a user that triggered an ad.

searchVolumeMetric

The estimated number of times a specific search term was queried.

spentMetric

The total amount of money spent on advertising.

startDateDimension

The start date of the reporting period or campaign duration.

stateDimension

The current status or state of an entity, such as an advertising campaign, ad group, offer, or an asynchronous report generation process.

subcategoriesDimension

A hierarchical classification of products or listings, representing categories nested under a broader main category.

targetProductIdMetric

A unique identifier for a product that is specifically targeted by an ad campaign.

targetingTypeDimension

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).

totalBudgetMetric

The maximum total amount of money allocated for spending throughout the entire duration of a campaign.

urlDimension

The web address used for accessing a specific resource, such as a report download, product image, or an affiliate link.