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
Device	Device	The type of device on which the ad was displayed (e.g., mobile, tablet, desktop). This is a dimension used for segmenting performance data.	dimension
account_id	account_id	A unique identifier for the advertising account. This dimension is used to group data by specific accounts.	dimension
account_name	account_name	The human-readable name of the advertising account. This field provides context for the associated account ID.	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
carrier	carrier	The mobile network carrier of the device on which the ad was displayed. This is a dimension for audience segmentation.	metric
category	category	Represents the IAB category for ad placements, enabling the segmentation of data by content categories.	metric
clicks	clicks	The total number of times an ad was clicked. This metric measures direct user engagement with advertisements.	metric
conversion_rate	conversion_rate	The percentage of clicks or impressions that resulted in a desired action (e.g., purchase, signup). This metric indicates campaign effectiveness.	metric
country	country	The geographical country where the ad was displayed or the audience is located. This is a dimension for geographic segmentation.	metric
ctr	ctr	The Click-Through Rate, calculated as clicks divided by impressions, expressed as a percentage. This metric measures ad appeal.	metric
date	date	The specific date for which the reporting data is aggregated. This is a key dimension for time-series analysis.	dimension
device_brand	device_brand	The brand of the device on which the ad was displayed (e.g., Samsung, Apple). This is a dimension for device segmentation.	dimension
devicetype	devicetype	The specific type of device used (e.g., smartphone, smart TV). This dimension provides more detailed device information.	metric
e_cpc	e_cpc	The Effective Cost Per Click, representing the total cost divided by the total number of clicks. This metric reflects the average cost for each click.	metric
e_cpm	e_cpm	The Effective Cost Per Mille (thousand impressions), representing the total cost divided by the total number of impressions, then multiplied by 1000. This metric indicates the average cost for every thousand ad impressions.	metric
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
os_version	os_version	The operating system version of the device on which the ad was displayed (e.g., iOS 15, Android 12). This is a dimension for device segmentation.	dimension
region	region	The geographical region or state where the ad was displayed. This provides a more granular geographic dimension than country.	metric
site_id	site_id	A unique identifier for the website or application where the ad was displayed. This dimension allows reporting on publisher performance.	dimension
site_name	site_name	The human-readable name of the website or application where the ad was displayed. This field provides context for the associated site ID.	dimension
supply_type	supply_type	The type of inventory source where the ad was served (e.g., mobile app, mobile web, desktop web). This is a dimension for inventory analysis.	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
win_rate	win_rate	The percentage of bid requests won out of the total bids made. This metric indicates the success rate in programmatic auctions.	metric