Ligatus: Most-used fields

The table below gives information about most-used fields that you can import from Ligatus. 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_id	account_id	A unique identifier for the advertising account. This dimension is used to group data by specific accounts.	dimension
ad_campaign_id	ad_campaign_id	A unique identifier for the ad within a specific campaign, linking an ad to its parent campaign.	dimension
ad_id	ad_id	A unique identifier for an individual advertisement. This dimension allows for granular reporting on specific ad creatives.	dimension
ad_name	ad_name	The name of the ad creative or unit. This field provides a human-readable identifier for individual advertisements.	dimension
advertiser_account_id	advertiser_account_id	A unique identifier for the advertiser’s account within the platform.	dimension
advertiser_account_name	advertiser_account_name	The name of the advertiser’s account.	dimension
advertiser_customer_id	advertiser_customer_id	Unique identifier for the advertiser customer within the LiquidM platform, used to segment reporting data by individual customers.	dimension
advertiser_customer_name	advertiser_customer_name	Human-readable name of the advertiser customer in the LiquidM platform, used for displaying customer-specific reporting data.	dimension
age	age	The age demographic of the audience targeted or reached by the ad. This is a dimension for audience segmentation.	dimension
bid_requests	bid_requests	The total number of bid requests received for ad opportunities. This metric indicates the potential inventory available.	metric
bids	bids	The total number of bids submitted for ad opportunities. This metric reflects the platform’s activity in auctioning ad inventory.	metric
campaign_id	campaign_id	A unique identifier for an advertising campaign. This dimension allows for reporting and analysis at the campaign level.	dimension
campaign_name	campaign_name	The human-readable name of the advertising campaign. This field provides context for the associated campaign ID.	dimension
clicks	clicks	The total number of times an ad was clicked. This metric measures direct user engagement with advertisements.	metric
date	date	The specific date for which the reporting data is aggregated. This is a key dimension for time-series analysis.	dimension
devicetype	devicetype	The specific type of device used (e.g., smartphone, smart TV). This dimension provides more detailed device information.	dimension
earnings	earnings	The total revenue generated from the ad impressions and clicks. This metric measures the financial outcome of advertising activities.	metric
gender	gender	The gender demographic of the audience targeted or reached by the ad. This is a dimension for audience segmentation.	dimension
video_firstquartile	video_firstquartile	The number of times a video ad was played to at least 25% of its duration. This metric indicates initial video ad engagement.	metric
video_midpoint	video_midpoint	The number of times a video ad was played to at least 50% of its duration. This metric indicates sustained video ad engagement.	metric
video_thirdquartile	video_thirdquartile	The number of times a video ad was played to at least 75% of its duration. This metric indicates strong video ad engagement.	metric