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
ACCOUNT	ACCOUNT		dimension
ACCOUNT_ID	ACCOUNT_ID	A unique identifier for the organization within the Hivestack platform. This ID is used to associate report definitions and executions with a specific client or entity.	dimension
ADVERTISER	ADVERTISER	The name of the company or entity advertising.	dimension
ADVERTISER_CPM	ADVERTISER_CPM		metric
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_CODE	AUDIENCE_CODE	A unique alphanumeric identifier representing a specific audience segment targeted by an advertising campaign, used for demographic breakdown and targeting in DOOH advertising.	dimension
AUDIENCE_IMPRESSIONS	AUDIENCE_IMPRESSIONS	The number of times an ad was seen by the target audience.	metric
AUDIENCE_NAME	AUDIENCE_NAME	The human-readable name of an audience segment, describing the demographic or behavioral characteristics of the target audience for an advertising campaign.	dimension
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_BUDGET	CAMPAIGN_BUDGET		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_BUDGET	LINE_ITEM_BUDGET		metric
LINE_ITEM_FLIGHT_FROM	LINE_ITEM_FLIGHT_FROM	The scheduled start date for a specific line item within an advertising campaign, indicating when its impressions or activities begin.	dimension
LINE_ITEM_FLIGHT_TO	LINE_ITEM_FLIGHT_TO	The scheduled end date for a specific line item within an advertising campaign, indicating when its impressions or activities conclude.	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.	metric
MEDIA_TYPE_CHILD	MEDIA_TYPE_CHILD	The secondary classification or sub-category of the digital out-of-home (DOOH) inventory where campaigns are displayed, providing a more granular breakdown of media types than the primary media type.	dimension
MEDIA_TYPE_GRANDCHILD	MEDIA_TYPE_GRANDCHILD	The tertiary classification or a further sub-category within a child media type, offering the most detailed breakdown of the digital out-of-home (DOOH) inventory where campaigns are displayed.	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
SPOT_LENGTH	SPOT_LENGTH	The duration, typically in seconds, for which an advertising creative is displayed on a DOOH screen. This can be a variable length depending on the creative.	metric
SSP	SSP	A Supply-Side Platform (SSP) is a technology platform used by digital out-of-home (DOOH) media owners to manage their advertising inventory, fill it with ads, and monetize it.	dimension
TIMEZONE	TIMEZONE	The timezone of the screen’s location, relevant for scheduling and reporting.	dimension
UNIT_ID	UNIT_ID	A unique identifier for an individual digital out-of-home (DOOH) display or screen, referred to as a ‘Player’ or ‘Unit’ in the Hivestack platform, where advertisements are shown.	metric