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
2nd quartile video completes	2nd quartile video completes	The number of video plays that completed at least 50% of the video duration.	metric
Account ID	Account ID	The unique identifier 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 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.	metric
Banner unit views	Banner unit views	The number of times a banner unit has been displayed to the user.	metric
Brand ID	Brand ID	The unique identifier of the brand or advertiser.	dimension
Brand name	Brand name	The name of the brand or advertiser.	dimension
Campaign ID	Campaign ID	The unique identifier of the advertising campaign.	dimension
Campaign countries	Campaign countries	A list of countries where the campaign is currently running or has run.	dimension
Campaign creation date (UTC)	Campaign creation date (UTC)	The date, in UTC, when the campaign was created.	dimension
Campaign name	Campaign name	The name of the advertising campaign.	dimension
Clicks	Clicks	The total number of clicks recorded for the creative or ad unit.	metric
Clicks reported to external ad server	Clicks reported to external ad server	The number of clicks that were successfully reported to an external ad server.	metric
Country	Country	The name of the country.	dimension
Country code	Country code	The ISO 3166-1 two-letter country code (e.g., US, GB).	dimension
Creative ID	Creative ID	The unique identifier of the creative asset.	dimension
Creative name	Creative name	The name of the creative asset.	dimension
Custom event occurrences	Custom event occurrences	The number of times a custom-defined event occurred within the creative.	metric
Date (UTC)	Date (UTC)	The date of the event in Coordinated Universal Time (UTC).	dimension
Date (account)	Date (account)	The date of the event in the account’s specified timezone.	dimension
Device type	Device type	The type of device (e.g., mobile, tablet, desktop) where the ad was displayed.	dimension
Exposure time	Exposure time	The total non-overlapping time (in seconds) that an ad was on screen.	metric
External campaign ID	External campaign ID	The unique identifier of the campaign on an external Ad Server.	dimension
External campaign name	External campaign name	The name of the campaign on an external Ad Server.	dimension
External site ID	External site ID	The unique identifier of the site on an external Ad Server.	dimension
External site name	External site name	The name of the site on an external Ad Server.	dimension
Fallback component views	Fallback component views	The number of times a fallback component has been displayed to the user.	metric
Format name	Format name	The name of the ad format used for the creative.	dimension
Impressions with advertising identifier passed	Impressions with advertising identifier passed	The number of impressions for which the platform advertising ID was requested in the Celtra tag.	metric
Inline video completions	Inline video completions	The number of unique video plays in which the inline video was fully played.	metric
Inline video feature views	Inline video feature views	The number of times a specific inline video feature has been displayed to the user.	metric
Inline video first quarter views	Inline video first quarter views	The number of unique video plays in which the inline video played for at least 25% of its duration.	metric
Inline video plays	Inline video plays	The number of times an inline video started playing.	metric
Inline video second quarter views	Inline video second quarter views	The number of unique video plays in which the inline video played for at least 50% of its duration.	metric
Inline video starts	Inline video starts	The number of unique times an inline video started playing.	metric
Inline video third quarter views	Inline video third quarter views	The number of unique video plays in which the inline video played for at least 75% of its duration.	metric
Intended device type	Intended device type	The device type for which the creative was designed.	dimension
Language	Language	The language associated with the creative or user environment.	dimension
Loaded impressions	Loaded impressions	The number of ad requests received by Celtra where a creative was loaded and displayable on a user’s device.	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
Modal unit engagements	Modal unit engagements	The number of modal unit views in which the user interacted with the unit.	metric
Modal unit views	Modal unit views	The number of times a 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 where the creative was displayed.	metric
Page views	Page views	The number of times a page has been displayed to the user.	metric
Placement ID	Placement ID	The unique identifier 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 a primary unit has been displayed to the user.	metric
Product	Product	The name of the Celtra product used.	dimension
Rendered impressions	Rendered impressions	The number of loaded impressions in which the creative content appeared and started playing (if it included animations 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 from the creative.	metric
State/province	State/province	The name of the state or province associated with the geographic location.	dimension
Time on banner unit	Time on banner unit	The total non-overlapping time (in seconds) that a banner unit was on screen.	metric
Time on modal unit	Time on modal unit	The total non-overlapping time (in seconds) that a modal unit was on screen.	metric
Time on primary unit	Time on primary unit	The total non-overlapping time (in seconds) that a primary unit was on screen.	metric
Unit engagements	Unit engagements	The number of unit views in which the user interacted with the unit.	metric
Unit variant engagements	Unit variant engagements	The number of unit variant views where the user interacted with the creative, applicable only to universal formats.	metric
Unit variant views	Unit variant views	The number of times a specific unit variant has been displayed to the user.	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
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 occurred.	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, representing the percentage of video starts in which the video was fully played.	metric
Video consumable seconds	Video consumable seconds	The total potential duration of video content that started playing, calculated as the sum of video lengths for each video start.	metric
Video consumption rate	Video consumption rate	The ratio of Video play time to Video consumable seconds, representing the average percentage of video consumed.	metric
Video interactions	Video interactions	The total number of interactions users performed with video content.	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	The actual type of device (e.g., mobile, tablet, desktop) where the ad was displayed.	dimension
brandName	brandName	The name of the brand or advertiser.	dimension
campaignId	campaignId	The unique identifier of the advertising campaign.	dimension
campaignName	campaignName	The name of the advertising campaign.	dimension
creativeId	creativeId	The unique identifier of the creative asset.	dimension
creativeLoads	creativeLoads	The number of times the creative was loaded and displayable on a user’s device.	metric
creativeName	creativeName	The name of the creative asset.	dimension
creativeRenders	creativeRenders	The number of times the creative content appeared and started playing (if it included animations or video).	metric
inlineVideoFirstQuarterUniqueViews	inlineVideoFirstQuarterUniqueViews	The number of unique video plays in which the inline video played for at least 25% of its duration.	metric
inlineVideoPlays	inlineVideoPlays	The number of times an inline video started playing.	metric
inlineVideoSecondQuarterUniqueViews	inlineVideoSecondQuarterUniqueViews	The number of unique video plays in which the inline video played for at least 50% of its duration.	metric
inlineVideoThirdQuarterUniqueViews	inlineVideoThirdQuarterUniqueViews	The number of unique video plays in which the inline video played for at least 75% of its duration.	metric
inlineVideoUniqueFinishes	inlineVideoUniqueFinishes	The number of unique video plays in which the inline video was fully played.	metric
inlineVideoUniqueStarts	inlineVideoUniqueStarts	The number of unique times an inline video started playing.	metric
intendedDeviceType	intendedDeviceType	The device type for which the creative was designed.	dimension
placementId	placementId	The unique identifier of the placement in which the creative was trafficked.	dimension
placementName	placementName	The name of the placement in which the creative was trafficked.	dimension
product	product	The name of the Celtra product used.	dimension
sessions	sessions	The total number of user sessions recorded.	metric
sessionsWithClick	sessionsWithClick	The number of sessions that included at least one click.	metric
sessionsWithInteraction	sessionsWithInteraction	The number of sessions that included at least one user interaction with the creative.	metric
utcDate	utcDate	The date of the event in Coordinated Universal Time (UTC).	dimension
viewableTime	viewableTime	The total aggregate time, in seconds, that users spent viewing the ad content.	metric