Hivestack: Most-used fields

The table below gives information about most-used fields that you can import from Hivestack. 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
ADVERTISER	ADVERTISER	The name of the company or entity advertising.	dimension
ADVERTISER_ID	ADVERTISER_ID	A unique identifier for the advertiser.	dimension
ADVERTISER_SPEND	ADVERTISER_SPEND	The total amount of money spent by the advertiser for the campaign.	metric
AUDIENCE_IMPRESSIONS	AUDIENCE_IMPRESSIONS	The number of times an ad was seen by the target audience.	metric
BUYER_NET_SPEND	BUYER_NET_SPEND	The net amount of money spent by the programmatic buyer on ad inventory.	metric
CAMPAIGN	CAMPAIGN	The name of the advertising campaign.	dimension
CAMPAIGN_END_DATE	CAMPAIGN_END_DATE	The date when the advertising campaign concluded.	dimension
CAMPAIGN_ID	CAMPAIGN_ID	A unique identifier for the advertising campaign.	dimension
CAMPAIGN_START_DATE	CAMPAIGN_START_DATE	The date when the advertising campaign began.	dimension
CITY	CITY	The city where the ad screens are located.	dimension
CONCENTRATION	CONCENTRATION	This field represents a calculated score indicating the density or presence of target audience devices around a specific Digital Out-of-Home (DOOH) asset at a given time. A higher concentration score suggests a greater number of devices belonging to the target audience were observed near the DOOH screen.	metric
COUNTRY	COUNTRY	The country where the ad screens are located.	dimension
CPM	CPM	The cost-per-thousand impressions, calculated as total ad spend divided by the number of impressions, multiplied by 1000. It measures the cost efficiency of a campaign in reaching a thousand viewers.	metric
CREATIVE	CREATIVE	The name or description of the specific advertisement asset (e.g., video, image) that was displayed.	dimension
CREATIVE_ID	CREATIVE_ID	A unique identifier for the specific advertisement asset.	dimension
DATE	DATE	The specific date for which the report data is aggregated.	dimension
DEAL	DEAL	The name or description of a specific programmatic advertising deal, often used to define terms between buyers and sellers for ad inventory.	dimension
HOUR	HOUR	The hour of the day for which the report data is aggregated.	dimension
IMPRESSIONS	IMPRESSIONS	The total number of times an advertisement was displayed or viewed.	metric
LINE_ITEM	LINE_ITEM	A specific component within an advertising campaign, defining targeting and budget.	dimension
LINE_ITEM_ID	LINE_ITEM_ID	A unique identifier for the advertising line item.	dimension
MARKET	MARKET	The defined geographic market where advertising campaigns are run.	dimension
MEDIA_OWNER	MEDIA_OWNER	The owner of the digital out-of-home (DOOH) inventory/screens.	dimension
MEDIA_OWNER_ID	MEDIA_OWNER_ID	A unique identifier for the media owner.	dimension
MEDIA_TYPE_CHILD	MEDIA_TYPE_CHILD	This field represents a sub-category within a broader media type where digital out-of-home (DOOH) advertisements are displayed. It allows for a more granular breakdown of campaign performance and spend based on specific media environments. For example, if a primary media type is ‘Outdoor’, a MEDIA_TYPE_CHILD could be ‘Billboard’ or ‘Transit Shelter’.	dimension
MEDIA_TYPE_GRANDCHILD	MEDIA_TYPE_GRANDCHILD	This field provides an even more specific classification within a ‘MEDIA_TYPE_CHILD’, enabling highly detailed analysis of campaign delivery across various digital out-of-home (DOOH) media environments. For instance, if ‘Billboard’ is a MEDIA_TYPE_CHILD, a MEDIA_TYPE_GRANDCHILD could specify ‘Digital Billboard’ or ‘Static Billboard’.	dimension
NETWORK	NETWORK	The digital out-of-home (DOOH) network where the ads were displayed.	dimension
NETWORK_ID	NETWORK_ID	A unique identifier for the digital out-of-home (DOOH) network.	dimension
PLAYS	PLAYS	The number of times an advertisement was played on a screen.	metric
PROGRAMMATIC_BUYER	PROGRAMMATIC_BUYER	Represents the entity or advertiser (e.g., a Demand-Side Platform user) responsible for purchasing the digital out-of-home ad inventory programmatically.	dimension
PROGRESS	PROGRESS	The current completion percentage of an ongoing report generation process.	metric
PURCHASE_TYPE	PURCHASE_TYPE	The method of inventory acquisition, e.g., programmatic or direct buy.	dimension
REGION	REGION	The geographic region where the ad screens are located.	dimension
SCREEN	SCREEN	A specific digital display unit where advertisements are shown.	dimension
SCREEN_ID	SCREEN_ID	A unique identifier for the individual digital screen.	dimension
SCREEN_LATITUDE	SCREEN_LATITUDE	The latitude coordinate of the screen’s physical location.	metric
SCREEN_LONGITUDE	SCREEN_LONGITUDE	The longitude coordinate of the screen’s physical location.	metric
SITE	SITE	The physical location or venue where the digital screens are installed.	dimension
SITE_ID	SITE_ID	A unique identifier for the physical location or venue.	dimension
SPEND	SPEND	The total monetary amount spent on advertising for a specific campaign or ad creative.	metric
TIMEZONE	TIMEZONE	The timezone of the screen’s location, relevant for scheduling and reporting.	dimension