Celtra: Most-used fields

The table below gives information about most-used fields that you can import from Celtra. 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
1st quartile video completes	1st quartile video completes	The number of Video starts in which the video played for at least 25% of the duration.	metric
Account ID	Account ID	The ID of the account.	dimension
Account name	Account name	The name of the account.	dimension
Ad engagements	Ad engagements	The number of impressions where the user interacted with the creative.	metric
Ad expansions	Ad expansions	The number of impressions in which the ad expanded.	metric
Avg. exposure time	Avg. exposure time	The ratio of Exposure time to Impressions with exposure time.	metric
Avg. video play time	Avg. video play time	The ratio of Video play time to Video starts. The average amount of time (in seconds) a video has played through.	metric
Banner unit engagements	Banner unit engagements	The number of banner unit views in which the user interacted with the unit. Counted only for formats supporting banner unit and not supporting modal unit.	metric
Banner unit views	Banner unit views	The number of times banner unit has been displayed to the user. Counted only for formats that support banner unit and do not support modal unit.	metric
Brand ID	Brand ID	The ID of the brand/advertiser.	dimension
Brand name	Brand name	The name of the brand/advertiser.	dimension
Campaign ID	Campaign ID	The ID of the campaign.	dimension
Campaign countries	Campaign countries	Countries running campaign.	dimension
Campaign creation date (UTC)	Campaign creation date (UTC)	UTC date when campaign was created.	dimension
Campaign name	Campaign name	The name of the campaign.	dimension
Clicks	Clicks	The number of impressions where a click occured.	metric
Clicks reported to external ad server	Clicks reported to external ad server	The number of impressions where a click was reported to external ad server.	metric
Country	Country	The country name associated to countryCode.	dimension
Country code	Country code	ISO 3166-1 two-letter ISO country code.	dimension
Creative ID	Creative ID	The ID of the creative.	dimension
Creative name	Creative name	The name of the creative.	dimension
Custom event occurrences	Custom event occurrences	The number of custom event occurrences.	metric
Date (UTC)	Date (UTC)	The date in UTC timezone presented in ‘yyyy-mm-dd’ format.	dimension
Date (account)	Date (account)	The date in the account’s timezone.	dimension
Device type	Device type	The device type that was recorded in an impression.	dimension
Exposure time	Exposure time	The aggregate time (in seconds) in which some portion of the creative is displayed- as detectable in the current environment.	metric
External campaign ID	External campaign ID	The ID of the campaign on the external Ad Server.	dimension
External campaign name	External campaign name	The name of the campaign on the external Ad Server.	dimension
External site ID	External site ID	The ID of the site on the external Ad Server.	dimension
External site name	External site name	The name of the site on the external Ad Server.	dimension
Fallback component views	Fallback component views	The number of times Fallback component has been displayed to the user.	metric
Format name	Format name		dimension
Impressions with advertising identifier passed	Impressions with advertising identifier passed	The number of impressions with advertising identifier passed through the tag or URL.	metric
Inline video completions	Inline video completions	The number of Inline video starts in which the inline video played to the end.	metric
Inline video feature views	Inline video feature views	The number of times a particular Inline video feature has been displayed to the user.	metric
Inline video first quarter views	Inline video first quarter views	The number of Inline video starts in which the inline video played through the first Quarter marker of the video.	metric
Inline video plays	Inline video plays	The number of times the inline video component started loading a video file.	metric
Inline video second quarter views	Inline video second quarter views	The number of Inline video starts in which the video played through the second Quarter marker of the video.	metric
Inline video starts	Inline video starts	The number of Measurable inline video plays in which the video has been played for at least 1 second.	metric
Inline video third quarter views	Inline video third quarter views	The number of Inline video starts in which the inline video played through the third Quarter marker of the video.	metric
Intended device type	Intended device type	The device type for which the creative was intended.	dimension
Loaded impressions	Loaded impressions	The number of times where the creative was loaded to the point where it could be displayed.	metric
Location direction clicks	Location direction clicks	The number of times users tapped on the direction icon of the location.	metric
Locator feature views	Locator feature views	The number of times the locator component has been displayed to the user.	metric
Mean time to render	Mean time to render		metric
Modal unit engagements	Modal unit engagements	The number of modal unit views in which the user interacted with the unit. Counted only for formats supporting modal unit.	metric
Modal unit views	Modal unit views	The number of times modal unit has been displayed to the user.	metric
Page engagements	Page engagements	The number of page views in which the user interacted with the page.	metric
Page name	Page name	The name of the page.	metric
Page views	Page views	The number of times a Page name has been displayed to the user.	metric
Placement ID	Placement ID	The ID of the placement in which the creative was trafficked.	dimension
Placement name	Placement name	The name of the placement in which the creative was trafficked.	dimension
Primary unit engagements	Primary unit engagements	The number of primary unit views in which the user interacted with the unit.	metric
Primary unit views	Primary unit views	The number of times primary unit has been displayed to the user.	metric
Product	Product	The Product on which the creative is built.	dimension
Rendered impressions	Rendered impressions	The number of Loaded impressions in which the creative content appeared (best-effort- optimistic) and started playing (if animated or video).	metric
Reporting label	Reporting label	A text description used for reporting- as specified in the creative.	dimension
Requested impressions	Requested impressions	The number of ad requests received by Celtra.	metric
Save image attempts	Save image attempts	The number of times users attempted to save an image.	metric
State/province	State/province	The state or province name associated to principalSubdivisionCode.	dimension
Time on banner unit	Time on banner unit	The Time spent on banner unit. Calculated only for formats that support banner unit and do not support modal unit.	metric
Time on modal unit	Time on modal unit	The Time spent on modal unit for formats that support modal unit.	metric
Time on primary unit	Time on primary unit	The Time spent on primary unit.	metric
Unit engagements	Unit engagements	The number of unit views in which the user interacted with the unit.	metric
Unit views	Unit views	The number of times a creative Unit has been displayed to the user.	metric
User-initiated inline video plays	User-initiated inline video plays	The number of Inline video plays that happened as a consequence of a user interaction (and not automatically).	metric
VAST companion ad click-throughs	VAST companion ad click-throughs		metric
VAST companion ad views	VAST companion ad views		metric
Video CTR	Video CTR	The ratio of Video clicks to Video starts.	metric
Video clicks	Video clicks	The number of Video starts in which a click occured.	metric
Video completes	Video completes	The number of Video starts in which the video was fully played.	metric
Video completion rate	Video completion rate	The ratio of Video completes to Video starts. The percentage of Video starts in which the video was fully played.	metric
Video consumable seconds	Video consumable seconds	The product of Video starts and Video length.	metric
Video consumption rate	Video consumption rate	The ratio of Video play time to Video consumable seconds. The average percent of video consumed.	metric
Video interactions	Video interactions		metric
Video play time	Video play time	The aggregate non-overlapping time (in seconds) a video has played through.	metric
Video starts	Video starts	The number of times a video was loaded and playback began.	metric
Website opens	Website opens	The sum of Website opens on screen and Video website opens.	metric
actualDeviceType	actualDeviceType		dimension
brandName	brandName		dimension
campaignId	campaignId		dimension
campaignName	campaignName		dimension
creativeId	creativeId		dimension
creativeLoads	creativeLoads		metric
creativeName	creativeName		dimension
creativeRenders	creativeRenders		metric
inlineVideoFirstQuarterUniqueViews	inlineVideoFirstQuarterUniqueViews		metric
inlineVideoPlays	inlineVideoPlays		metric
inlineVideoSecondQuarterUniqueViews	inlineVideoSecondQuarterUniqueViews		metric
inlineVideoThirdQuarterUniqueViews	inlineVideoThirdQuarterUniqueViews		metric
inlineVideoUniqueFinishes	inlineVideoUniqueFinishes		metric
inlineVideoUniqueStarts	inlineVideoUniqueStarts		metric
intendedDeviceType	intendedDeviceType		dimension
placementId	placementId		dimension
placementName	placementName		dimension
product	product		dimension
sessions	sessions		metric
sessionsWithClick	sessionsWithClick		metric
sessionsWithInteraction	sessionsWithInteraction		metric
utcDate	utcDate		dimension
viewableTime	viewableTime		metric