Hivestack: Most-used fields

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.

FieldAdverity UI nameType
ACCOUNT Dimension

The identifier or name of the advertising account to which the campaign or data belongs.

ACCOUNT_ID Dimension

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.

ADVERTISER Dimension

The name of the company or entity advertising.

ADVERTISER_CPM Metric

Cost Per Mille (CPM) from the advertiser's perspective, representing the cost per one thousand impressions for an ad.

ADVERTISER_ID Dimension

A unique identifier for the advertiser.

ADVERTISER_SPEND Metric

The total amount of money spent by the advertiser for the campaign.

AUDIENCE_CODE Dimension

A unique alphanumeric identifier representing a specific audience segment targeted by an advertising campaign, used for demographic breakdown and targeting in DOOH advertising.

AUDIENCE_IMPRESSIONS Metric

The number of times an ad was seen by the target audience.

AUDIENCE_NAME Dimension

The human-readable name of an audience segment, describing the demographic or behavioral characteristics of the target audience for an advertising campaign.

BUYER_NET_SPEND Metric

The net amount of money spent by the programmatic buyer on ad inventory.

CAMPAIGN Dimension

The name of the advertising campaign.

CAMPAIGN_BUDGET Dimension

The total financial allocation or budget set for a specific advertising campaign.

CAMPAIGN_END_DATE Dimension

The date when the advertising campaign concluded.

CAMPAIGN_ID Dimension

A unique identifier for the advertising campaign.

CAMPAIGN_START_DATE Dimension

The date when the advertising campaign began.

CITY Dimension

The city where the ad screens are located.

CONCENTRATION Metric

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.

COUNTRY Dimension

The country where the ad screens are located.

CPM Metric

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.

CREATIVE Dimension

The name or description of the specific advertisement asset (e.g., video, image) that was displayed.

CREATIVE_ID Dimension

A unique identifier for the specific advertisement asset.

DATE Dimension

The specific date for which the report data is aggregated.

DEAL Dimension

The name or description of a specific programmatic advertising deal, often used to define terms between buyers and sellers for ad inventory.

HOUR Dimension

The hour of the day for which the report data is aggregated.

IMPRESSIONS Metric

The total number of times an advertisement was displayed or viewed.

LINE_ITEM Dimension

A specific component within an advertising campaign, defining targeting and budget.

LINE_ITEM_BUDGET Metric

The financial allocation or budget specifically assigned to an individual line item within an advertising campaign.

LINE_ITEM_FLIGHT_FROM Dimension

The scheduled start date for a specific line item within an advertising campaign, indicating when its impressions or activities begin.

LINE_ITEM_FLIGHT_TO Dimension

The scheduled end date for a specific line item within an advertising campaign, indicating when its impressions or activities conclude.

LINE_ITEM_ID Dimension

A unique identifier for the advertising line item.

MARKET Dimension

The defined geographic market where advertising campaigns are run.

MEDIA_OWNER Dimension

The owner of the digital out-of-home (DOOH) inventory/screens.

MEDIA_OWNER_ID Metric

A unique identifier for the media owner.

MEDIA_TYPE Dimension

The type of media asset used for the advertisement, such as video or static image.

MEDIA_TYPE_CHILD Dimension

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.

MEDIA_TYPE_GRANDCHILD Dimension

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.

NETWORK Dimension

The digital out-of-home (DOOH) network where the ads were displayed.

NETWORK_ID Dimension

A unique identifier for the digital out-of-home (DOOH) network.

PLAYS Metric

The number of times an advertisement was played on a screen.

PROGRAMMATIC_BUYER Dimension

Represents the entity or advertiser (e.g., a Demand-Side Platform user) responsible for purchasing the digital out-of-home ad inventory programmatically.

PROGRESS Metric

The current completion percentage of an ongoing report generation process.

PURCHASE_TYPE Dimension

The method of inventory acquisition, e.g., programmatic or direct buy.

REGION Dimension

The geographic region where the ad screens are located.

SCREEN Dimension

A specific digital display unit where advertisements are shown.

SCREEN_ID Dimension

A unique identifier for the individual digital screen.

SCREEN_LATITUDE Metric

The latitude coordinate of the screen's physical location.

SCREEN_LONGITUDE Metric

The longitude coordinate of the screen's physical location.

SITE Dimension

The physical location or venue where the digital screens are installed.

SITE_ID Dimension

A unique identifier for the physical location or venue.

SPEND Metric

The total monetary amount spent on advertising for a specific campaign or ad creative.

SPOT_LENGTH Metric

The duration, in seconds, for which an advertisement is displayed on a screen or player.

SSP Dimension

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.

TIMEZONE Dimension

The timezone of the screen's location, relevant for scheduling and reporting.

UNIT_ID Metric

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.