Hawk DSP: Most-used fields

The table below gives information about most-used fields that you can import from Hawk DSP. 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
adServingFeesCurrency	adServingFeesCurrency	The currency used for ad serving fees, which are charges associated with delivering advertisements.	metric
adTechFeesCurrency	adTechFeesCurrency	The currency used for ad technology fees, covering costs related to the ad tech stack.	metric
advertiser	advertiser	The name or identifier of the advertiser running the campaign.	dimension
appOrSite	appOrSite	The application or website where the advertisement was displayed.	dimension
appSiteId	appSiteId	The unique identifier for the application or website where the advertisement was displayed.	dimension
appSiteName	appSiteName	The name of the application or website where the advertisement was displayed.	dimension
budget	budget	The allocated budget for a specific advertising campaign or line item.	metric
campaignEnd	campaignEnd	The end date of the advertising campaign.	dimension
campaignId	campaignId	The unique identifier for the advertising campaign.	dimension
campaignName	campaignName	The name of the advertising campaign being reported on.	dimension
campaignStart	campaignStart	The start date of the advertising campaign.	dimension
city	city	The city where the advertisement was served or where the user is located.	dimension
click	click	The number of times users clicked on an advertisement. This is a common measure in programmatic advertising.	metric
complete	complete	Indicates the number of times a video advertisement was viewed to completion.	metric
conversion	conversion	The number of times a desired action (e.g., purchase, sign-up) occurred after a user interacted with an ad. This is a common measure in programmatic advertising.	metric
country	country	The country where the advertisement was served or where the user is located. This is a common dimension in programmatic advertising.	dimension
creativeFormat	creativeFormat	The format of the advertisement creative (e.g., banner, video, native).	dimension
creativeId	creativeId	The unique identifier for the advertising creative.	dimension
creativeSize	creativeSize	The dimensions of the advertising creative (e.g., 300x250).	dimension
currency	currency	The currency code used for various financial metrics within the report, such as ‘USD’ or ‘EUR’.	dimension
day	day	The specific day for which the data is reported.	dimension
dealId	dealId	The unique identifier for a private marketplace (PMP) deal or guaranteed deal in programmatic advertising.	dimension
dealName	dealName	Represents the name of a specific advertising deal, such as a Private Marketplace (PMP) deal, within the Hawk DSP.	dimension
deviceMake	deviceMake	The manufacturer of the device used by the user (e.g., Apple, Samsung).	dimension
deviceModel	deviceModel	The specific model of the device used by the user (e.g., iPhone 13, Galaxy S21).	dimension
deviceType	deviceType	The type of device used by the user when viewing the advertisement (e.g., mobile, desktop, tablet). This is a common dimension in programmatic advertising.	dimension
exchange	exchange	The ad exchange where the impression was bought or sold.	dimension
firstQuartile	firstQuartile	Indicates the number of times a video advertisement was viewed at least 25% of its duration.	metric
impression	impression	The number of times an advertisement was displayed to a user. This is a common measure in programmatic advertising.	metric
impressions	impressions	The total count of times an advertisement was displayed to a user. This is a common measure in programmatic advertising.	metric
lineCreativeId	lineCreativeId	The unique identifier for the creative associated with a specific line item in a campaign.	dimension
lineCreativeName	lineCreativeName	The name assigned to a particular creative asset used within an advertising line item.	dimension
mediaCostCurrency	mediaCostCurrency	The currency in which the media cost (cost of ad placements) is reported.	metric
mediaCostUSD	mediaCostUSD	The cost of media placements, reported in USD.	metric
mediaFormat	mediaFormat	The format of the media where the ad was displayed (e.g., web, in-app, CTV).	dimension
mediaType	mediaType	The type of media where the advertisement was delivered (e.g., display, video, audio).	dimension
mediaplanId	mediaplanId	A unique identifier for the media plan.	dimension
mediaplanName	mediaplanName	The name of the media plan, which defines the strategy and objectives for an advertising campaign.	dimension
organizationName	organizationName	The name of the organization associated with the campaign data.	dimension
os	os	The operating system of the device used by the user (e.g., iOS, Android, Windows).	dimension
osVersion	osVersion	The version of the operating system on the device (e.g., iOS 15.0, Android 12).	dimension
publisher	publisher	The entity or company that owns the application or website where ads are displayed.	dimension
publisherId	publisherId	The unique identifier for the publisher who owns the app or site where the ad was served.	dimension
realCostCurrency	realCostCurrency	The currency of the actual cost incurred for the advertising activity.	metric
secondQuartile	secondQuartile	Indicates the number of times a video advertisement was viewed at least 50% of its duration.	metric
segmentId	segmentId	The unique identifier for an audience segment targeted by the campaign.	dimension
segmentName	segmentName	The name of the audience segment targeted by the advertising campaign.	dimension
start	start	The start date and time of the data reporting period.	metric
thirdPartyCostCurrency	thirdPartyCostCurrency	The currency used for third-party costs, which are expenses from external vendors or services.	metric
thirdQuartile	thirdQuartile	Indicates the number of times a video advertisement was viewed at least 75% of its duration.	metric
timezone	timezone	The timezone associated with the reported data, typically reflecting the geographic scope of the campaign or reporting settings.	dimension
totalCostCurrency	totalCostCurrency	The currency for the total cost of all advertising activities, including media costs and various fees.	metric
type	type	The type of data entry or event being reported.	dimension
visit	visit	The number of website or app visits attributed to advertising activity.	metric