The Search Monitor: Most-used fields

The table below gives information about most-used fields that you can import from The Search Monitor. 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
ad_provider	ad_provider	The advertising platform or network where the ad was displayed (e.g., Google, Bing).	dimension
avg_rank	avg_rank	The average organic or paid search rank of an advertisement or listing for a monitored keyword or term. This metric helps assess visibility and competitive performance.	metric
campaign_id	campaign_id	Unique identifier for a marketing campaign.	dimension
countryCode	countryCode	The two-letter ISO country code where the campaign is targeted or where the data was collected.	dimension
destinationUrls	destinationUrls	The list of URLs to which an advertisement or search listing directs users. This field is crucial for tracking where competitors’ ads lead and for compliance monitoring of landing pages.	dimension
first_seen	first_seen	The date and time when a specific trademark violation or ad instance was first observed.	dimension
id	id	Unique identifier for a specific campaign.	dimension
isActive	isActive	A boolean indicator of whether the campaign is currently active.	dimension
keyword_term	keyword_term	The specific keyword or search term that is being monitored for competitive intelligence or brand compliance. This can include general keywords or trademarked terms.	dimension
languageCode	languageCode	The two-letter ISO language code for the campaign’s target language or the language of the collected data.	dimension
last_seen	last_seen	The date and time when a specific trademark violation or ad instance was most recently observed.	dimension
name	name	The name of the campaign.	dimension
result_id	result_id	A unique identifier for a specific trademark violation detection result.	dimension
searchProductIds	searchProductIds	Identifiers for products associated with a campaign that are being monitored in search advertising.	dimension
start_date	start_date	The start date for data collection or reporting, used to specify the beginning of a time range for retrieving data, such as trademark violation details.	dimension
times_seen	times_seen	The total number of times a specific ad, search listing, or violation was observed or detected by The Search Monitor’s crawling system during the monitoring period.	metric
trademarkTerms	trademarkTerms	A list of trademark terms associated with a campaign for compliance monitoring.	dimension
trademark_term	trademark_term	The specific trademark term that was found to be violated.	dimension
violation_type	violation_type	The category or nature of the trademark violation (e.g., brand bidding, direct infringement).	dimension
violator_domain	violator_domain	The domain name of the entity or advertiser committing the violation.	dimension
violator_title	violator_title	The title or headline of the ad or listing containing the trademark violation.	dimension
websiteUrls	websiteUrls	A list of official website URLs associated with the campaign.	dimension