Analytics Glossary

The following list represents the metrics available in Celtra's Analytics and also provides basic usage details.

Analytics Glossary

Metrics and dimensions indicated with a are deprecated and will be removed according to the schedule here.

Requested impressions

Term	Definition
Requested impressions `sessions`	The number of ad requests received by Celtra.
Invalid requested impressions `invalidSessions`	The number of impressions that were invalid. Break down by `Invalid impression reason` dimension.
Creative load attempts `creativeLoadAttempts`	The number of ad requests received by Celtra with potential to be loaded.
Successfull creative responses `creativeResponses`	The number of ad responses that can be displayed/played.

Requested impressions (Identity)

Term	Definition
Impressions with advertising identifier requested in the tag `sessionsWithPlatformAdvIdRequested`	The number of impressions for which the platform advertising id was requested in the Celtra tag. Does not matter whether the ad server then subsequently passed the valid advertiser id or not.
Impressions with advertising identifier passed `sessionsWithPlatformAdvIdPassed`	The number of impressions with advertising identifier passed through the tag or URL.
Impressions with advertising identifier tracking limited `sessionsWithPlatformAdvIdTrackingLimited`	The number of impressions for which we know that the user has limited advertising tracking.
Impressions with advertising identifier tracking unlimited `sessionsWithPlatformAdvIdTrackingUnlimited`	The number of impressions for which we know that the user has not limited advertising tracking.
Platform advertising ID requested in tag rate `platformAdvIdRequestedRate`	The ratio of `Impressions with advertising identifier requested in the tag` to `Requested impressions`.
Platform advertising ID passed rate `platformAdvIdPassedRate`	The ratio of `Impressions with advertising identifier passed` to `Impressions with advertising identifier requested in the tag`.

Loaded impressions

Term	Definition
Loaded impressions `creativeLoads`	The number of times where the creative was loaded to the point where it could be displayed. The Base and first page of the banner unit have loaded and the SDK must have initialized.
Load rate `creativeLoadRate`	The ratio of `Loaded impressions` to `Creative load attempts`.
Mean time to render `avgTrimmedLoadingTime`	The mean time from the ad request until the creative is loaded and ready to render. The Mean Time to Render is calculated by trimming the fastest and slowest 5 % of impressions.

Rendered impressions

Term	Definition
Rendered impressions `creativeRenders`	The number of `Loaded impressions` in which the creative content appeared (best-effort, optimistic) and started playing (if animated or video). For display ad formats, this is counted when the first page of the first unit (excluding the Base, Loading and change orientation pages) is displayed. For video-first formats, this is counted when the playback began. Rendered impression is a necessary condition for any user-initiated actions (such as engagements or clicks).
Render rate `creativeRenderRate`	The ratio of `Rendered impressions` to `Loaded impressions`.
Effective render rate `effectiveRenderRate`	The ratio of `Rendered impressions` to `Creative load attempts`.

Display

Term	Definition
Exposure time `viewableTime`	The aggregate time (in seconds) in which some portion of the creative is displayed, as detectable in the current environment. For each `Impressions with exposure time` the value is capped at 60 seconds, so any value greater than 60 will be replaced with 60. Exposure time is tracked when both following conditions are met: 1) More than 1 px of the creative is in view for more than 0 seconds, 2) Browser tab is in focus.
Impressions with exposure time `sessionsWithViewableTime`	The number of impressions where `Exposure time` is greater than zero.
Avg. exposure time `avgViewableTime`	The ratio of `Exposure time` to `Impressions with exposure time`.

Expansions

Term	Definition
Ad expansions `sessionsWithExpandAttempt`	The number of impressions in which the ad expanded. The expansion is typically but not necessarily triggered by a user action within the banner unit.
Intentional ad expansions `sessionsWithIntentionalExpandAttempt`	The number of impressions in which the user intentionally expanded the ad. Expansions are deemed intentional when either 1) time between banner display on screen and click to expand is ≥ 700ms or 2) time between user banner expansion and dismissal (while loading screen is displayed) is ≥ 700ms.
Ad expansion rate `expansionRate`	The ratio of `Ad expansions` to `Rendered impressions`.

Creative structure

Term	Definition
Unit views `unitShows`	The number of times a creative `Unit` has been displayed to the user. There may be several `Unit views` in a single impression, but only one `Unit views` of a particular `Unit`. Matches the `Page views` of the first page of the unit.
Unit variant views `unitVariantShows`	The number of times a creative `Unit variant` has been displayed to the user. There may be several `Unit variant views` in a single impression, but only one `Unit variant views` of a particular `Unit variant`. Available only for universal formats.
Primary unit views `primaryUnitShows`	The number of times primary unit has been displayed to the user. A unit is considered viewed at most once per impression. Primary unit is defined for each format. If format supports expanded unit, views of the expanded unit are counted. For other formats, views of banner unit are counted.
Banner unit views `bannerUnitShows`	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. A unit is considered viewed at most once per impression.
Modal unit views `modalUnitShows`	The number of times modal unit has been displayed to the user. A unit is considered viewed at most once per impression. Metric is not defined for formats that do not support modal unit.
Page views `screenShows`	The number of times a `Page name` has been displayed to the user. There may be several `Page views` in a single impression, but only one `Page views` of a particular `Page name`. Matches the `Page views` of the first page of the unit. The loading screen, if viewed, is not considered a page.

Engagement

Term	Definition
Ad engagements `sessionsWithInteraction`	The number of impressions where the user interacted with the creative. For any ad format that can be closed or dismissed, doing so is not considered an interaction. This metric may be lower than expansions if the creative was configured to expand automatically.
Video interactions `sessionsWithVideoInteraction`	The number of interactions on video.
Ad engagement rate `interactionRate`	The ratio of `Ad engagements` to `Rendered impressions`.
Unit engagements `unitShowsWithInteraction`	The number of unit views in which the user interacted with the unit. For formats with multiple units (e.g. Expandable Banner), break down by the `Unit` dimension or filter by a specific value.
Primary unit engagements `primaryUnitShowsWithInteraction`	The number of primary unit views in which the user interacted with the unit. Primary unit is defined for each format. If format supports expanded unit, unit engagement rate is calculated for the expanded unit. For other formats, banner unit is used.
Banner unit engagements `bannerUnitShowsWithInteraction`	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.
Modal unit engagements `modalUnitShowsWithInteraction`	The number of modal unit views in which the user interacted with the unit. Counted only for formats supporting modal unit.
Unit engagement rate `unitInteractionRate`	The ratio of `Unit engagements` to `Unit views`.
Primary unit engagement rate `creativeUnitInteractionRate`	The number of unit shows with interaction on primary unit divided by unit shows of the primary unit. Primary unit is defined for each format. If format supports expanded unit, unit engagement rate is calculated for the expanded unit. For other formats, banner unit is used.
Unit variant engagements `unitVariantShowsWithInteraction`	The number of `Unit variant views` where the user interacted with the creative. Available only for universal formats.
Unit variant engagement rate `unitVariantInteractionRate`	The ratio of `Unit variant engagements` to `Unit variant views`. Available only for universal formats.
Page engagements `screenShowsWithInteraction`	The number of page views in which the user interacted with the page.
Page engagement rate `screenInteractionRate`	The ratio of `Page engagements` to `Page views`.
Time spent `timeOnScreen`	The aggregate time users have spent with the ad content (in seconds). The time is measured from when a page is first displayed until the last detectable interaction (closing the ad included). We assume 0 when there is no detectable interaction.
Avg. time spent on page `avgTimeOnScreen`	The ratio of `Time spent` to `Page views`. The average time users have spent viewing the page(s). Break down by the `Page name` dimension.
Avg. time spent on unit `avgTimeOnUnit`	The ratio of `Time spent` to `Unit views`. The average time users have spent viewing the unit(s). Break down by the `Unit` dimension.
Time on primary unit `timeOnPrimaryUnit`	The `Time spent` on primary unit. Primary unit is defined for each format. If format supports expanded unit, time spent on the expanded unit is measured. For other formats, time spent on banner unit is measured.
Time on banner unit `timeOnBannerUnit`	The `Time spent` on banner unit. Calculated only for formats that support banner unit and do not support modal unit.
Time on modal unit `timeOnModalUnit`	The `Time spent` on modal unit for formats that support modal unit.
Avg. time spent on primary unit `avgTimeOnCreativeUnit`	The average time users have spent viewing the primary unit. Primary unit is defined for each format. If format supports expanded unit, average time is calculated for the expanded unit. For other formats, banner unit is used.
Clicks reported to external ad server `sessionsWithClickReportedToExternalAdServer`	The number of impressions where a click was reported to external ad server. A click is reported to external ad server by calling the URL passed in the clickUrl parameter of the tag/URL. This metric may differ from `Clicks` if a URL was not provided, or if external ad server overrode the event to consider as a click.
Clicks `sessionsWithClick`	The number of impressions where a click occured. By default, all `Ad engagements` are considered clicks, but a more specific event may be chosen for the creative by changing the Click event definition.

Study

Term	Definition
Study parameter choices `clientExperimentParameterChoices`	The number of times a particular study choice was chosen.
Client experiment choices unique by experimental unit value. `clientExperimentChoicesUniqueByExperimentalUnitValue`	The number of unique sessions by experimental unit for client experiment. This metric is available only for selected accounts.
Client experiment choices with rendered `clientExperimentChoicesWithRender`	The number of unique rendered sessions by experimental unit for client experiment. This metric is available only for selected accounts.
Client experiment choices with interaction `clientExperimentChoicesWithInteraction`	The number of unique sessions with interaction by experimental unit for client experiment. This metric is available only for selected accounts.
Successes unique by experimental unit value `successesUniqueByExperimentalUnitValue`	The number of unique conversions by experimental unit for client experiment. This metric is available only for selected accounts.
Probability selected variant performs best `clientExperimentProbBest`	The probability that this creative variant will perform best for specified event. This metric is available only for selected accounts.

Actions

Term	Definition
Custom event occurrences `customEventOccurs`	The number of custom event occurrences.
Custom event occurrences on views `viewCustomEventOccurs`	The number of custom event occurrences on screen.
Custom event occurrences on video `videoCustomEventOccurs`	The number of custom event occurrences on video.
Custom event occurrences unique by impression `customEventOccursUniqueBySession`	The number of custom event occurrences unique by Impression and Reporting label.
Website opens `urlOpens`	The sum of `Website opens on screen` and `Video website opens`.
Website opens on screen `urlOpensOnScreen`	The number of times the user was led to an external website, from a particular screen. Multiple occurrences of this metric in the same session and on the same screen with the same label and URL are deduplicated..
App store opens `storeOpens`	The number of times the user was led to the app store. Multiple occurrences of this metric in the same session and on the same screen/video with the same label and app URI are deduplicated.
App store opens on screen `storeOpensOnScreen`	The number of times the user was led to the app store from a screen. Multiple occurrences of this metric in the same session and on the same screen with the same label and app URI are deduplicated.
App store opens on video `storeOpensOnVideo`	The number of times the user was led to the app store from a video. Multiple occurrences of this metric in the same session with the same label and app URI are deduplicated.
Phone calls `phoneCalls`	The number of phone calls initiated from the ad. Multiple occurrences of this metric in the same session and on the same screen with the same label and number are deduplicated.
Photo selections `photoSelections`	The number of times the user selected a photo. For Desktop platform this means that the user selected an image from the file browser, whereas for mobile this can be a consequence of the user taking a photo or selecting it from existing photos on the device. Multiple occurrences of this metric in the same session and on the same screen with the same label are deduplicated.
Facebook share attempts `facebookShareAttempts`	The number of times users attempted to share creative content on Facebook. Multiple occurrences of this metric in the same session and on the same screen with the same type, label, URL and thumbnail are deduplicated.
Twitter share attempts `twitterShareAttempts`	The number of times users attempted to share creative content on Twitter.
WhatsApp share attempts `whatsAppShareAttempts`	The number of times users attempted to share creative content on WhatsApp.
Twitter profile opens `twitterProfileOpens`	The number of times users have opened a Twitter profile. Multiple occurrences of this metric in the same session and on the same screen with the same label are deduplicated.
Tweet attempts `tweetPageOpens`	The number of times the user was led to the Twitter tweet page. Multiple occurrences of this metric in the same session and on the same screen with the same type, label, URL and image are deduplicated.
Form submission attempts `formSubmissionAttempts`	The number of times users have attempted to submit a form.
Form submission successes `formSubmissionSuccesses`	The number of times users successfully submitted a form.
Save image attempts `saveImageAttempts`	The number of times users attempted to save an image. Multiple occurrences of this metric in the same session and on the same screen with the same label and image are deduplicated.
Save the date attempts `dateSaves`	The number of times users attempted to save the date. Multiple occurrences of this metric in the same session and on the same screen with the same label are deduplicated.

Inline and 360 Video

Term	Definition
Inline video feature views `inlineVideoShows`	The number of times a particular Inline video feature has been displayed to the user.
User-initiated inline video feature views `inlineVideoManualShows`	The number of times a particular Inline video feature with User-initiated play setting has been displayed to the user.
Inline video play rate `inlineVideoManualPlayRate`	The ratio of `User-initiated inline video plays` to `User-initiated inline video feature views`. This metric is not defined for automatic inline video plays, inline video plays from 'Play Video' and 'Play Video from URL' actions and inline video plays from Youtube component.
Inline video plays `inlineVideoPlays`	The number of times the inline video component started loading a video file.
Measurable inline video plays `inlineVideoTrackablePlays`	The number of `Inline video plays` in which video tracking was available.
Inline video measured rate `inlineVideoPctTrackable`	The ratio of `Measurable inline video plays` to `Inline video plays`.
Inline video starts `inlineVideoUniqueStarts`	The number of `Measurable inline video plays` in which the video has been played for at least 1 second.
Inline video start rate `inlineVideoStartRate`	The ratio of `Inline video starts` to `Measurable inline video plays`.
Automatic inline video plays `inlineVideoAutoPlays`	The number of `Inline video plays` in which the video was configured to start automatically.
User-initiated inline video plays `inlineVideoManualPlays`	The number of `Inline video plays` that happened as a consequence of a user interaction (and not automatically).
Inline video plays initially muted `inlineVideoPlaysWithSoundOff`	The number of `Inline video plays` where the video was initially muted.
Inline video plays initially audible `inlineVideoPlaysWithSoundOn`	The number of `Inline video plays` where the inline video was initially audible.
Inline video mutes `inlineVideoMutes`	The number of `Inline video plays initially audible`, in which the video was subsequently muted.
Inline video mute rate `inlineVideoMuteRate`	The ratio of `Inline video mutes` to `Inline video plays initially audible`.
Inline video unmutes `inlineVideoUnmutes`	The number of `Inline video plays initially muted`, in which the inline video was subsequently unmuted.
Inline video unmute rate `inlineVideoUnmuteRate`	The ratio of `Inline video unmutes` to `Inline video plays initially muted`.
Inline video play time `inlineVideoPlayTime`	The aggregate time (in seconds) an inline video has played through.
Avg. inline video play time `inlineVideoAvgPlayTime`	The ratio of `Inline video play time` to `Inline video starts`. The average time an inline video has played through. Can be more than `Video length` if the video has played through more than once in an impression.
Unique inline video play time `inlineVideoUniquePlayTime`	The aggregate non-overlapping time (in seconds) an inline video has played through. Overlapping segments of the same inline video play are counted only once.
Inline video mute time `inlineVideoMuteTime`	The aggregate time (in seconds) an inline video has played through with sound disabled.
Avg. inline video mute time `inlineVideoAvgMuteTime`	The ratio of `Inline video mute time` to `Inline video starts`. The average time an inline video has played through with muted audio.
Inline video audible time `inlineVideoAudibleTime`	The aggregate time (in seconds) an inline video has played through with audible sound. Audibility is measured through the video player and not by device audio settings.
Avg. audible inline video time `inlineVideoAvgAudibleTime`	The ratio of `Inline video audible time` to `Inline video starts`. The average time a video has played through with audible sound.
Inline video audibility rate `inlineVideoAudibilityRate`	The ratio of `Inline video audible time` to `Inline video play time`. The average percent of video played with audible sound.
Inline video sound off play rate `inlineVideoSoundOffPlayRate`	The ratio of `Inline video plays initially muted` to `Inline video plays`.
Inline video sound on play rate `inlineVideoSoundOnPlayRate`	The ratio of `Inline video plays initially audible` to `Inline video plays`.
Inline video completions `inlineVideoUniqueFinishes`	The number of `Inline video starts` in which the inline video played to the end. Inline video is assumed to have played until the end if it played until last two seconds before the end.
Inline video completion rate `inlineVideoFinishRate`	The ratio of `Inline video completions` to `Inline video starts`.
Inline video second marker unique views `inlineVideoSecondUniqueViews`	The number of times inline video played through a specific 'second marker' of the video, unique per Video play. Break down by the `Second marker` dimension to display per-second video attention.
Inline video quarter marker unique views `inlineVideoQuarterUniqueViews`	The number of times inline video played through a specific 'quarter marker' of the video, unique per Inline video play. Break down by the `Quarter marker` dimension to display per-quarter video attention.
Consumable inline video seconds `inlineVideoSeconds`	The product of `Inline video starts` and `Video length`. For every Inline video start, the length of the Inline Video is added to `Consumable inline video seconds`.
Inline video consumption rate `inlineVideoConsumptionRate`	The ratio of `Unique inline video play time` to `Consumable inline video seconds`. The average percent of video consumed.
Inline video first quarter views `inlineVideoFirstQuarterUniqueViews`	The number of `Inline video starts` in which the inline video played through the first `Quarter marker` of the video.
Inline video second quarter views `inlineVideoSecondQuarterUniqueViews`	The number of `Inline video starts` in which the video played through the second `Quarter marker` of the video.
Inline video third quarter views `inlineVideoThirdQuarterUniqueViews`	The number of `Inline video starts` in which the inline video played through the third `Quarter marker` of the video.
Inline video fourth quarter views `inlineVideoFourthQuarterUniqueViews`	The number of `Inline video starts` in which the video played through the fourth `Quarter marker` of the video.
Inline video first quarter play rate `inlineVideoFirstQuarterUniquePlayRate`	The ratio of `Inline video first quarter views` to `Inline video starts`.
Inline video second quarter play rate `inlineVideoSecondQuarterUniquePlayRate`	The ratio of `Inline video second quarter views` to `Inline video starts`.
Inline video third quarter play rate `inlineVideoThirdQuarterUniquePlayRate`	The ratio of `Inline video third quarter views` to `Inline video starts`.
Inline video fourth quarter play rate `inlineVideoFourthQuarterUniquePlayRate`	The ratio of `Inline video fourth quarter views` to `Inline video starts`.
360 video quadrant 1 views `inlineVideoQuadrant1Views`	The number of times user saw quadrant 1 [-45° to 45°). The sphere is split into four 90° quadrants (enumerated in clockwise direction when looking at it from the top) like a watermelon. Quadrant 1 is centered to the middle of the original video file (regardless of the initial view direction). A quadrant is considered viewed at most once per impression. This metric is defined only for 360 video.
360 video quadrant 2 views `inlineVideoQuadrant2Views`	The number of times user saw quadrant 2 [45° to 135°). The sphere is split into four 90° quadrants (enumerated in clockwise direction when looking at it from the top) like a watermelon. Quadrant 1 is centered to the middle of the original video file (regardless of the initial view direction). A quadrant is considered viewed at most once per impression. This metric is defined only for 360 video.
360 video quadrant 3 views `inlineVideoQuadrant3Views`	The number of times user saw quadrant 3 [135° to 225°). The sphere is split into four 90° quadrants (enumerated in clockwise direction when looking at it from the top) like a watermelon. Quadrant 1 is centered to the middle of the original video file (regardless of the initial view direction). A quadrant is considered viewed at most once per impression. This metric is defined only for 360 video.
360 video quadrant 4 views `inlineVideoQuadrant4Views`	The number of times user saw quadrant 4 [225° to 315°). The sphere is split into four 90° quadrants (enumerated in clockwise direction when looking at it from the top) like a watermelon. Quadrant 1 is centered to the middle of the original video file (regardless of the initial view direction). A quadrant is considered viewed at most once per impression. This metric is defined only for 360 video.
Average 360 video quadrant views `inlineVideoAvgQuadrantViews`	The average number of quadrants seen. The sphere is split into four 90° quadrants (enumerated in clockwise direction when looking at it from the top) like a watermelon. Quadrant 1 is centered to the middle of the original video file (regardless of the initial view direction). This metric is defined only for 360 video.
360 video swipes `inlineVideoSwipeInteractions`	The number of times users change view direction for more than 30° by swiping. This metric is defined only for 360 video and is unique per video play.
360 video swipe interaction rate `inlineVideoSwipeInteractionRate`	The ratio of `360 video swipes` to `Inline video starts`. This metric is defined only for 360 video.
360 video tilts `inlineVideoTiltInteractions`	The number of times users change view direction for more than 30° by tilting the device. This metric is defined only for 360 video and is unique per video play.
360 video tilt interaction rate `inlineVideoTiltInteractionRate`	The ratio of `360 video tilts` to `Inline video starts`. This metric is defined only for 360 video.
360 video degrees panned `inlineVideoDegreesPanned`	The sum of distances between consecutive view directions in longitude-latitude space. This metric is defined only for 360 video.
360 video average panning speed `inlineVideoAvgPanningSpeed`	The average panning (angular) speed in longitude-latitude space (in degrees per second). This metric is defined only for 360 video.

Video

Term	Definition
Requested video impressions `videoSessions`	The number of ad requests for video creatives received by Celtra.
Video starts `videoStarts`	The number of times a video was loaded and playback began.
Avg. video play time `videoAvgUniquePlayTime`	The ratio of `Video play time` to `Video starts`. The average amount of time (in seconds) a video has played through.
Video play time `videoUniquePlayTime`	The aggregate non-overlapping time (in seconds) a video has played through. Overlapping seconds of the same video play are counted only once.
Video consumable seconds `videoConsumableSeconds`	The product of `Video starts` and `Video length`. For every video start, the length of the video is added to `Video consumable seconds`.
Video consumption rate `videoConsumptionRate`	The ratio of `Video play time` to `Video consumable seconds`. The average percent of video consumed.
1st quartile video completes `videoFirstQuartileViews`	The number of `Video starts` in which the video played for at least 25% of the duration.
2nd quartile video completes `videoMidpointQuartileViews`	The number of `Video starts` in which the video played for at least 50% of the duration.
3rd quartile video completes `videoThirdQuartileViews`	The number of `Video starts` in which the video played for at least 75% of the duration.
Video completes `videoCompletions`	The number of `Video starts` in which the video was fully played.
Video completion rate `videoCompletionRate`	The ratio of `Video completes` to `Video starts`. The percentage of Video starts in which the video was fully played.
End card engagements `videoEndCardInteractions`	The number of impressions where the user interacted with the end card of the Video format.
End card engagement rate `videoEndCardInteractionRate`	The ratio of `End card engagements` to `Video completes`.
Video website opens `urlOpensOnVideo`	The number of times the user was led to an external website, for Video. Multiple occurrences of this metric in the same session and on the same screen with the same label and URL are deduplicated.
Video clicks `videoClicks`	The number of `Video starts` in which a click occured.
Video CTR `videoClickRate`	The ratio of `Video clicks` to `Video starts`.
End card clickthroughs `videoEndCardClickThroughs`	The number of `Video completes` in which a clickthrough occurred on the end card. Only available for formats that pause at the end of the video and allow user to click.
End card CTR `videoEndCardClickThroughRate`	The ratio of `End card clickthroughs` to `Video completes`.
VAST companion ad views `vastCompanionAdViews`	The number of views of a particular VAST companion ad.
VAST companion ad click-throughs `vastCompanionAdClickThroughs`	The number of click-throughs of a particular VAST companion ad.

A/B testing

Term	Definition
A/B test variant choices `abVariantChoices`	The number of times a particular `A/B test variant` was chosen.
A/B test exposures `abExposures`	The number of times a particular `A/B test variant` was chosen and displayed to users. The metric will be lower than `A/B test variant choices`, for example when the experiment takes place on second page of modal unit or when creative is not viewable.
A/B test successes `abSuccesses`	The number of times a particular `A/B test variant` was successful. A/B test success is defined in the creative by using 'Mark A/B Test Successful' action.

Errors

Term	Definition
Errors `errors`	The number of times an error occurred. This metric is 0 or 1 per Requested impression for a specific `Error`.
Impressions with error 'More than one sticky ad served into page.' `sessionsWithErrorMultipleStickyAds`	The number of impressions in which 'More than one sticky ad served into page.' error occurred.
Impressions with error 'Ad served into a non-friendly iframe.' `sessionsWithErrorNonFriendlyIFrame`	The number of impressions in which 'Ad served into a non-friendly iframe.' error occurred.
Impressions with error 'Ad served into a webpage that is not mobile-optimized.' `sessionsWithErrorNonMobileOptimized`	The number of impressions in which 'Ad served into a webpage that is not mobile-optimized.' error occurred.
Impressions with error 'Ad exceeded the maximum allowed CPU usage.' `sessionsWithErrorHeavyAdCPUIntervention`	The number of impressions in which 'Ad exceeded the maximum allowed CPU usage.' error occurred.
Impressions with error 'Ad exceeded the maximum allowed network bandwidth.' `sessionsWithErrorHeavyAdNetworkIntervention`	The number of impressions in which 'Ad exceeded the maximum allowed network bandwidth.' error occurred.
Impressions with error 'mraid object doesn't exist.' `sessionsWithErrorMissingMraidObject`	The number of impressions in which 'mraid object doesn't exist.' error occurred.
Impressions with error 'Exit URI is empty.' `sessionsWithErrorExitUriIsEmpty`	The number of impressions in which 'Exit URI is empty.' error occurred. The number of impressions in which the exit action was triggered without a defined exit URI.
Impressions with error 'Unsupported OS on mobile device or browser on non-mobile device.' `sessionsWithErrorUnsupportedBrowserOrOS`	The number of impressions in which 'Unsupported OS on mobile device or browser on non-mobile device.' error occurred.
Impressions with error 'Ad placement is Interstitial, but creative is not.' `sessionsWithErrorMraidMismatchPlacementInterstitial`	The number of impressions in which 'Ad placement is Interstitial, but creative is not.' error occurred.
Impressions with error 'Creative is Interstitial format, but ad placement is not.' `sessionsWithErrorMraidMismatchPlacementInline`	The number of impressions in which 'Creative is Interstitial format, but ad placement is not.' error occurred.
Impressions with error 'Unused.' `sessionsWithErrorMraidNotCompliant`	The number of impressions in which 'Unused.' error occurred.
Impressions with error 'clickUrl is non-empty and contains a value that is not a URL.' `sessionsWithErrorClickUrlNotExpanded`	The number of impressions in which 'clickUrl is non-empty and contains a value that is not a URL.' error occurred.
Impressions with error 'mraid.getPlacementType is not available or returns an invalid value.' `sessionsWithErrorMraidPlacementTypeNotCompliant`	The number of impressions in which 'mraid.getPlacementType is not available or returns an invalid value.' error occurred.
Impressions with error 'Tracking event limit reached.' `sessionsWithErrorEventLimitReached`	The number of impressions in which 'Tracking event limit reached.' error occurred.
Impressions with error 'VPAID is not available.' `sessionsWithErrorVpaidNotSupported`	The number of impressions in which 'VPAID is not available.' error occurred.
Impressions with error 'VPAID Creative; No Video component on the first page.' `sessionsWithErrorMissingVideoObject`	The number of impressions in which 'VPAID Creative; No Video component on the first page.' error occurred.
Impressions with error 'VPAID Creative; No Main Video component on the Base page.' `sessionsWithErrorMissingMasterVideoObject`	The number of impressions in which 'VPAID Creative; No Main Video component on the Base page.' error occurred.
Impressions with error 'Creative referencing feed column with no values available.' `sessionsWithErrorFeedValueMissing`	The number of impressions in which 'Creative referencing feed column with no values available.' error occurred.
Impressions with error 'Creative referencing feed column which has changed type or is no longer available.' `sessionsWithErrorFeedValueUnlinked`	The number of impressions in which 'Creative referencing feed column which has changed type or is no longer available.' error occurred.
Impressions with error 'Creative expanded before appearing.' `sessionsWithErrorExpandBeforeAppear`	The number of impressions in which 'Creative expanded before appearing.' error occurred.
Impressions with error 'Placement is too small to fit any of the unit variants defined on the Creative.' `sessionsWithErrorUnitVariantsDoNotFitPlacement`	The number of impressions in which 'Placement is too small to fit any of the unit variants defined on the Creative.' error occurred.
Impressions with error 'Unit of randomization (e.g. platformAdvId) was unavailable.' `sessionsWithErrorExperimentalUnitUnavailable`	The number of impressions in which 'Unit of randomization (e.g. platformAdvId) was unavailable.' error occurred.
Impressions with error 'Identifier is in multiple derived audiences.' `sessionsWithErrorIdentifierInMultipleDerivedAudiences`	The number of impressions in which 'Identifier is in multiple derived audiences.' error occurred.
Impressions with error 'Identifier not matched any derived audience.' `sessionsWithErrorIdentifierNotInAnyDerivedAudience`	The number of impressions in which 'Identifier not matched any derived audience.' error occurred.

Locator

Term	Definition
Locator feature views `locatorShows`	The number of times the locator component has been displayed to the user.
Locator engagements `locatorShowsWithInteraction`	The number of times the locator component has been displayed to the user and the user interacted with the component.
Locator engagement rate `locatorInteractionRate`	The ratio of `Locator engagements` to `Locator feature views`.
Locator list views `locatorListViews`	The number of times the list view has been displayed to users.
Locator map views `locatorMapViews`	The number of times the map view has been displayed to users.
Location direction clicks `locationDirectionClicks`	The number of times users tapped on the direction icon of the location.
Location email clicks `locationEmailClicks`	The number of times users clicked on the email icon of the location.
Location website opens `locationUrlOpens`	The number of times the user was led to an external website of the location.
Location phone calls `locationPhoneCalls`	The number of phone calls initiated from the location.
Location views `locationShows`	The number of times the location has been displayed to the user. Counts every time the user taps on a location in the Locator list view.
Locator search clicks `locatorSearchClicks`	The number of times users tapped on the location search button.

Snapchat

Term	Definition
Snapchat impressions `snapchatImpressions`	The number of Snapchat impressions. This metric is the best approximate to the `Video starts` metric used in other Celtra Video products. It is pulled from Snapchat’s reporting service (impressions).
Snapchat video views `snapchatVideoViews`	The number of Snapchat impressions that meet the qualifying video view criteria of at least 2 seconds of consecutive watch time or a swipe up action on the Top Snap. This metric is pulled from Snapchat reporting service (video_views).
Snapchat video view rate `snapchatVideoViewRate`	The ratio of `Snapchat video views` to `Snapchat impressions`. This metric is pulled from Snapchat reporting service (video_views / impressions).
Snapchat swipe ups `snapchatSwipes`	The number of Snapchat swipe ups. This metric is pulled from Snapchat reporting service (swipes).
Snapchat swipe up rate `snapchatSwipeRate`	The ratio of `Snapchat swipe ups` to `Snapchat impressions`. This metric is pulled from Snapchat reporting service (swipes / impressions).
Snapchat screen time `snapchatScreenTime`	The time spent on Top Snap ad (in milliseconds). This metric is pulled from Snapchat reporting service (screen_time_millis).
Snapchat avg. screen time `snapchatAvgScreenTime`	The ratio of `Snapchat screen time` to `Snapchat impressions`. The average time spent on Top Snap ad (in milliseconds). This metric is pulled from Snapchat reporting service (screen_time_millis / impressions).
Snapchat 25% quartile `snapchatFirstQuartileViews`	The number of `Snapchat video views` to 25%. This metric is pulled from Snapchat reporting service (quartile_1).
Snapchat 50% quartile `snapchatMidpointQuartileViews`	The number of `Snapchat video views` to 50%. This metric is pulled from Snapchat reporting service (quartile_2).
Snapchat 75% quartile `snapchatThirdQuartileViews`	The number of `Snapchat video views` to 75%. This metric is pulled from Snapchat reporting service (quartile_3).
Snapchat completions `snapchatCompletions`	The number of `Snapchat video views` to completion. This metric is pulled from Snapchat reporting service (view_completion).
Snapchat 25% quartile rate `snapchatFirstQuartileRate`	The ratio of `Snapchat 25% quartile` to `Snapchat impressions`. This metric is pulled from Snapchat reporting service (quartile_1 / impressions).
Snapchat 50% quartile rate `snapchatMidpointQuartileRate`	The ratio of `Snapchat 50% quartile` to `Snapchat impressions`. This metric is pulled from Snapchat reporting service (quartile_2 / impressions).
Snapchat 75% quartile rate `snapchatThirdQuartileRate`	The ratio of `Snapchat 75% quartile` to `Snapchat impressions`. This metric is pulled from Snapchat reporting service (quartile_3 / impressions).
Snapchat video completion rate `snapchatCompletionRate`	The ratio of `Snapchat completions` to `Snapchat impressions`. This metric is pulled from Snapchat reporting service (view_completion / impressions).
Snapchat spend `snapchatSpend`	The amount spent on Snapchat (in micro-currency). This metric is pulled from Snapchat reporting service (spend).
Snapchat uniques `snapchatUniques`	The number of unique impressions. Can only be provided in combination with `Snapchat ad ID` dimension. This metric is pulled from Snapchat reporting service (uniques).
Snapchat frequency `snapchatFrequency`	The average number of impressions per user reached. Can only be provided in combination with `Snapchat ad ID` dimension. This metric is pulled from Snapchat reporting service (frequency).
Snapchat attachment view time `snapchatAttachmentViewTime`	The attachment view time (in milliseconds). Available for any ad type with attachment. This metric is pulled from Snapchat reporting service (attachment_total_view_time_millis).
Snapchat avg. attachment screen time `snapchatAvgAttachmentViewTime`	The average attachment view time (in milliseconds). Can only be provided in combination with `Snapchat ad ID` dimension. Available for any ad type with attachment. This metric is pulled from Snapchat reporting service (attachment_avg_view_time_millis).
Snapchat attachment uniques `snapchatAttachmentUniques`	The number of unique attachment impressions. Can only be provided in combination with `Snapchat ad ID` dimension. Available for any ad type with attachment. This metric is pulled from Snapchat reporting service (attachment_uniques).
Snapchat attachment frequency `snapchatAttachmentFrequency`	The average number of attachment views per user reached. Can only be provided in combination with `Snapchat ad ID` dimension. Available for any ad type with attachment. This metric is pulled from Snapchat reporting service (attachment_frequency).
Snapchat installs `snapchatInstalls`	The number of app installs. Available only for ads with APP_INSTALL attachment. This metric is pulled from Snapchat reporting service (total_installs).
Snapchat iOS installs `snapchatIOSInstalls`	The number of iOS app installs. Available only for ads with APP_INSTALL attachment. This metric is pulled from Snapchat reporting service (ios_installs).
Snapchat Android installs `snapchatAndroidInstalls`	The number of Android app installs. Available only for ads with APP_INSTALL attachment. This metric is pulled from Snapchat reporting service (android_installs).
Snapchat 25% attachment quartile `snapchatAttachmentFirstQuartileViews`	The number of long form video views to 25%. Available only for ads with LONGFORM_VIDEO attachment. This metric is pulled from Snapchat reporting service (attachment_quartile_1).
Snapchat 50% attachment quartile `snapchatAttachmentMidpointQuartileViews`	The number of long form video views to 50%. Available only for ads with LONGFORM_VIDEO attachment. This metric is pulled from Snapchat reporting service (attachment_quartile_2).
Snapchat 75% attachment quartile `snapchatAttachmentThirdQuartileViews`	The number of long form video views to 75%. Available only for ads with LONGFORM_VIDEO attachment. This metric is pulled from Snapchat reporting service (attachment_quartile_3).
Snapchat attachment completions `snapchatAttachmentCompletions`	The number of long form video views to completion. Available only for ads with LONGFORM_VIDEO attachment. This metric is pulled from Snapchat reporting service (attachment_view_completion).

Facebook

Term	Definition
Facebook impressions `facebookImpressions`	The number of times ad seen on screen. This metric is pulled from Facebook report service (impressions).
Facebook page likes `facebookLikes`	The number of page likes attributed to your ads. This metric is pulled from Facebook report service (like).
Facebook clicks `facebookClicks`	The number of clicks on your ads. This metric is pulled from Facebook report service (clicks).
Facebook post engagement `facebookPostEngagements`	The number of comments, clicks, shares, views etc. This metric is pulled from Facebook report service (post_engagement).
Facebook post reactions `facebookPostReactions`	The number of reactions people had to your ads. This metric is pulled from Facebook report service (post_reactions).
Facebook page engagements `facebookPageEngagements`	The number of interactions with the page and its posts. This metric is pulled from Facebook report service (page_engagement).
Facebook link clicks `facebookLinkClicks`	The number of clicks on any area of the ad. This metric is pulled from Facebook report service (link_click).
Facebook video fifteen seconds played `facebookVideoFifteenSecondsPlayed`	The number of times video was played for an aggregate of at least 15 seconds, or for nearly its length, whichever happened first. This metric is pulled from Facebook report service (video_thruplay_watched_actions).
Facebook 1st quartile video views `facebookFirstQuartileViews`	The number of times video was played at 25% of its length, including watches that skipped to this point. This metric is pulled from Facebook report service (video_p25_watched_actions).
Facebook 2nd quartile video views `facebookMidpointQuartileViews`	The number of times video was played at 50% of its length, including watches that skipped to this point. This metric is pulled from Facebook report service (video_p50_watched_actions).
Facebook 3nd quartile video views `facebookThirdQuartileViews`	The number of times video was played at 75% of its length, including watches that skipped to this point. This metric is pulled from Facebook report service (video_p75_watched_actions).
Facebook completions `facebookCompletions`	The number of times video was played at 100% of its length, including watches that skipped to this point. This metric is pulled from Facebook report service (video_p100_watched_actions).
Facebook desktop app engagements `facebookAppEngagements`	The number of desktop app engagements. This metric is pulled from Facebook report service (actions.app_engagement).
Facebook desktop app installs `facebookAppInstalls`	The number of desktop app installs. This metric is pulled from Facebook report service (actions.app_install).
Facebook app installs `facebookOmniAppInstalls`	The number of omni app installs. This metric is pulled from Facebook report service (actions.omni_app_install).
Facebook desktop app uses `facebookAppUses`	The number of desktop app uses. This metric is pulled from Facebook report service (actions.app_use).
Facebook post comments `facebookComments`	The number of post comments. This metric is pulled from Facebook report service (actions.comment).
Facebook landing page views `facebookLandingPageViews`	The number of landing page views. This metric is pulled from Facebook report service (actions.landing_page_view).
Facebook mobile app installs `facebookMobileAppInstalls`	The number of mobile app installs. This metric is pulled from Facebook report service (actions.mobile_app_install).
Facebook outbound clicks `facebookOutboundClicks`	The number of facebook outbound clicks. This metric is pulled from Facebook report service (actions.outbound_click).
Facebook post shares `facebookPostShares`	The number of facebook post shares. This metric is pulled from Facebook report service (actions.post).
Facebook app custom events `facebookAppCustomEvents`	The number of facebook app custom events. This metric is pulled from the Facebook report service and is a sum of all action metrics that are prefixed with app_custom_event (fb_mobile_achievement_unlocked, fb_mobile_activate_app, fb_mobile_add_payment_info, fb_mobile_add_to_cart, fb_mobile_add_to_wishlist, fb_mobile_complete_registration, fb_mobile_content_view, fb_mobile_initiated_checkout, fb_mobile_level_achieved, fb_mobile_purchase, fb_mobile_rate, fb_mobile_search, fb_mobile_spent_credits, fb_mobile_tutorial_completion, other).
Facebook off site conversions `facebookOffSiteConversions`	The number of off site conversions. This metric is pulled from the Facebook report service and is a sum of all action metrics that are prefixed with offsite_conversion (custom., fb_pixel_add_payment_info, fb_pixel_add_to_cart, fb_pixel_add_to_wishlist, fb_pixel_complete_registration, fb_pixel_custom, fb_pixel_initiate_checkout, fb_pixel_lead, fb_pixel_purchase, fb_pixel_search, fb_pixel_view_content).
Facebook on site conversions `facebookOnSiteConversions`	The number of on site conversions. This metric is pulled from the Facebook report service and is a sum of all action metrics that are prefixed with onsite_conversion (flow_complete, messaging_block, messaging_conversation_started_7d, messaging_first_reply, post_save, purchase).
Facebook cost per conversion `facebookCostPerConversion`	The average cost of a conversion across all channels. This metric is pulled from Facebook report service (cost_per_conversion - conversions include contact, customize_product, donate, find_location, schedule, start_trial, submit_application, subscribe.).
Facebook frequency `facebookFrequency`	The est. avg. number of times each person saw ad. This metric is pulled from Facebook report service (frequency).
Facebook reach `facebookReach`	The est. number of people who viewed ad once+. This metric is pulled from Facebook report service (reach).
Facebook CPC `facebookCPC`	The cost per each facebook click. This metric is pulled from Facebook report service (cpc).
Facebook CPM `facebookCPM`	The cost per 1000 facebook impressions. This metric is pulled from Facebook report service (cpm).
Facebook CPP `facebookCPP`	The estimated average cost to reach 1000 people. This metric is pulled from Facebook report service (ctr).
Facebook CTR `facebookCTR`	The % of times people saw and clicked on ad. This metric is pulled from Facebook report service (ctr).
Facebook mobile app purchase return on ad spend `facebookMobileAppPurchaseReturnOnAdSpend`	The return on ad spend from in-app purchases. This metric is pulled from Facebook report service (mobile_app_purchase_roas).
Facebook purchase return on ad spend `facebookPurchaseReturnOnAdSpend`	The return on ad spend from purchases. This metric is pulled from Facebook report service (purchase_roas).

Twitter

Term	Definition
Twitter impressions `twitterImpressions`	The number of Twitter ad impressions. This metric is pulled from Twitter reporting service (impressions).
Twitter engagements `twitterEngagements`	The number of Twitter ad engagements. This metric is pulled from Twitter reporting service (engagements).
Twitter clicks `twitterClicks`	The number of Twitter ad clicks. This metric is pulled from Twitter reporting service (clicks).
Twitter retweets `twitterRetweets`	The number of Twitter ad retweets. This metric is pulled from Twitter reporting service (retweets).
Twitter replies `twitterReplies`	The number of Twitter ad replies. This metric is pulled from Twitter reporting service (replies).
Twitter follows `twitterFollows`	The number of Twitter follows. This metric is pulled from Twitter reporting service (follows).
Twitter likes `twitterLikes`	The number of Twitter ad likes. This metric is pulled from Twitter reporting service (likes).
Twitter app clicks `twitterAppClicks`	The number of Twitter app clicks. This metric is pulled from Twitter reporting service (app_clicks).
Twitter video views `twitterVideoViews`	The number of Twitter ad video views. This metric is pulled from Twitter reporting service (video_total_views).
Twitter video starts `twitterStarts`	The number of Twitter ad video starts. This metric is pulled from Twitter reporting service (video_content_starts).
Twitter 1st quartile views `twitterFirstQuartileViews`	The number of Twitter ad video first quartile views. This metric is pulled from Twitter reporting service (video_views_25).
Twitter 2nd quartile views `twitterMidpointQuartileViews`	The number of Twitter ad video midpoint quartile views. This metric is pulled from Twitter reporting service (video_views_50).
Twitter 3rd quartile views `twitterThirdQuartileViews`	The number of Twitter ad video third quartile views. This metric is pulled from Twitter reporting service (video_views_75).
Twitter video completions `twitterCompletions`	The number of Twitter ad video completions. This metric is pulled from Twitter reporting service (video_views_100).

Fallback

Term	Definition
Fallback component views `fallbackShows`	The number of times Fallback component has been displayed to the user. This counts all shows of Fallback component, regardless which group (Available, Not Available) was selected.
Fallback content available shows `fallbackShowsWithAvailableContainer`	The number of Fallback component views in which the fallback element was available. This counts when the 'Available' group of the component was selected, which means that the value was provided to the component from the feed.
Fallback availability rate `fallbackAvailabilityRate`	The ratio of `Fallback content available shows` to `Fallback component views`.

External events

Term	Definition
External event occurrences `externalEventOccurs`	The number of times an external event occurred.

Feeds

Term	Definition
Feed selections `feedSelections`	The number of times a feed row was selected.

Surveys

Term	Definition
Survey question responses `surveyQuestionResponses`	The number of responses to the `Survey question ID`. This metric is available only for selected accounts.
Survey answer selections `surveyAnswerSelections`	The number of selections of a particular `Survey answer ID`. This metric is available only for selected accounts.

Soundtrack

Term	Definition
Soundtrack plays `soundtrackPlays`	The number of times a soundtrack was played.
Soundtrack pauses `soundtrackPauses`	The number of times a soundtrack was paused.
Soundtrack replays `soundtrackReplays`	The number of times a soundtrack was replayed.

Sustainability

Term	Definition
CO2e emissions `CO2Emissions`	The generated CO2e emissions in grams. This metric is available after enabling the Emissions Reporting add-on. The data is refreshed once per day and is available for up to the previous day.
Average creative weight `averageCreativeWeight`	The average weight of the creative in kB. Learn more about the average creative weight in Celtra Help Center.

QR code scans

Term	Definition
QR code scans `qrCodeScans`	The number of scanned QR codes. The number of scanned QR codes for Video Plus creatives. The QR code scans are independant of impressions and can be counted multiple times per session.

Time (UTC)

Term	Definition
Request timestamp (UTC) `utcRequestTimestamp`	The timestamp presented in the 'yyyy-MM-dd hh:mm:ss.SSS' format.
Date (UTC) `utcDate`	The date in UTC timezone presented in 'yyyy-mm-dd' format.
Year (UTC) `utcYear`	The year in UTC timezone presented in 'yyyy' format.
Month (UTC) `utcMonth`	The month in UTC timezone presented in 'mm' format.
Week (UTC) `utcWeek`	The week in UTC timezone presented in format 'yyyy-ww' where ww is in 01-53 (ISO week, starting on Monday).
Day (UTC) `utcDay`	The day in UTC timezone presented in the 'dd' format.
Hour of day (UTC) `utcHour`	The hour in UTC timezone presented in the 'hh' format.
Hour timestamp (UTC) `utcHourTimestamp`	The timestamp of the beginning of the hour in UTC timezone presented in the 'yyyy-MM-dd hh:mm:ss' format.

Time (account)

Term	Definition
Date (account) `accountDate`	The date in the account's timezone. For Celtra metrics, Celtra's account timezone is used. For external metrics (e.g. Snapchat), external account's timezone is used.
Year (account) `accountYear`	The year in the account's timezone. For Celtra metrics, Celtra's account timezone is used. For external metrics (e.g. Snapchat), external account's timezone is used.
Month (account) `accountMonth`	The month in the account's timezone. For Celtra metrics, Celtra's account timezone is used. For external metrics (e.g. Snapchat), external account's timezone is used.
Week (account) `accountWeek`	The week of the year in the account's timezone. Week format is 'yyyy-ww' where ww is in 01-53 (ISO week, starting on Monday).
Day (account) `accountDay`	The day in the account's timezone. For Celtra metrics, Celtra's account timezone is used. For external metrics (e.g. Snapchat), external account's timezone is used.
Hour of day (account) `accountHour`	The hour in account's timezone.
Hour timestamp (account) `accountHourTimestamp`	The timestamp of the beginning of the hour in the account's timezone presented in the 'yyyy-MM-dd hh:mm:ss' format.

Account

Term	Definition
Account ID `accountId`	The ID of the account. The ID is presented as an 8 character alpha-numeric value.
Account name `accountName`	The name of the account.
Account identifier `accountIdentifier`	The subdomain of the account.

Campaign

Term	Definition
Campaign ID `campaignId`	The ID of the campaign. The ID is presented as an 8 character alpha-numeric value.
Campaign name `campaignName`	The name of the campaign.
Goals `goals`	The goals of the campaign. JSON-encoded list, for example: ["brandAwareness","productAwareness","userAcquisition"]
Campaign countries `campaignCountries`	Countries running campaign.
Campaign creation date (UTC) `campaignCreationDate`	UTC date when campaign was created.

Creative

Term	Definition
Creative ID `creativeId`	The ID of the creative.
Creative name `creativeName`	The name of the creative.
Creative set ID `creativeSetId`	The ID of the creative set the creative belongs to. Can be '(unknown)' if the creative is not a part of a creative set.
Source ad product ID `sourceAdProductId`	The ID of the Ad Product used to create the creative. This dimension is available only for selected accounts.
Source ad product name `sourceAdProductName`	The name of the Ad Product used to create the creative. This dimension is available only for selected accounts.
Product `product`	The product id on which the creative is built. For example: 'STDA', 'RICH'. Refer to products for a full list of possible values.
Product ID `productId`	The product id on which the creative is built. For example: 'STDA', 'RICH'. Refer to products for a full list of possible values.
Product name `productName`	The product name on which the creative is built. For example: 'Display', 'Rich Media'. Refer to products for a full list of possible values.
Format `format`	The format id of the creative. Possible values are: 'AnimatedBanner', 'AppleNewsDoubleBanner', 'AppleNewsDoubleExpandableBanner', 'AppleNewsIAB300x250Banner', 'AppleNewsIAB300x250ExpandableBanner', 'AppleNewsIAB300x600Banner', 'AppleNewsIAB300x600ExpandableBanner', 'AppleNewsIAB320x320Banner', 'AppleNewsIAB320x320ExpandableBanner', 'AppleNewsIAB320x50Banner', 'AppleNewsIAB320x50ExpandableBanner', 'AppleNewsIAB728x90Banner', 'AppleNewsIAB728x90ExpandableBanner', 'AppleNewsIAB970x250Banner', 'AppleNewsIAB970x250ExpandableBanner', 'AppleNewsInterstitialBanner', 'AppleNewsLargeBanner', 'AppleNewsLargeExpandableBanner', 'AppleNewsMRECBanner', 'AppleNewsMRECExpandableBanner', 'AppleNewsStandardBanner', 'AppleNewsStandardExpandableBanner', 'AppleNewsVideo', 'Banner', 'CrossScreenBanner', 'CrossScreenExpandable', 'CrossScreenInterstitial', 'CrossScreenMiniscroller', 'CrossScreenReveal', 'CrossScreenBackgroundSkin', 'CrossScreenMultiUnitSkin', 'ExpandableBanner', 'ExportableFastLoadingAnimatedBanner', 'ExportableFastLoadingCrossScreenBanner', 'ExportableImage', 'ExportableVideo', 'FacebookCarouselAdPost', 'FacebookPhotoAdPost', 'FacebookVideoAdPost', 'FastLoadingCrossScreenBanner', 'FastLoadingCrossScreenExpandable', 'FastLoadingCrossScreenInterstitial', 'FlockOfBirds', 'InstaAdFacebook', 'InstaAdHtml', 'InstaAdInstagram', 'InstaAdSnapchat', 'InstaAdSnapchatWithAppInstall', 'InstaAdSnapchatWithLongformVideo', 'InstaAdSnapchatWithWebView', 'InstaAdTwitter', 'InstaAdVideoBillboard', 'InstaAdVideoHalfPage', 'InstaAdVideoInterscroller', 'InstaAdVideoInterstitial', 'InstaAdVideoPagebreak', 'InstaAdVideoRectangle', 'InstaAdVideoReveal', 'InstaAdVideoSquarePagebreak', 'InstaAdVideoTallBillboard', 'InstaAdVideoVerticalPagebreak', 'InstaAdYouTube', 'InStreamInteractiveVideo', 'InteractiveVideo', 'Interscroller', 'Interstitial', 'LandingPage', 'Lazerbird', 'MultiImageTweet', 'PlainTextTweet', 'PromotedVideoTweet', 'Pull', 'Reveal', 'ShazamForTV', 'ShazamForTVExpandable', 'ShazamInterstitial', 'SingleImageTweet', 'Slider', 'Snapchat', 'SnapchatWebView', 'SnapchatWithAppInstall', 'SnapchatWithLongformVideo', 'SnapchatWithWebView', 'SocialRichMedia', 'Stardust', 'TweetWithImageAppCard', 'TweetWithImageWebsiteCard', 'TweetWithVideoAppCard', 'TweetWithVideoWebsiteCard', 'UniversalInteractiveVideo', 'UniversalVideo', 'UniversalVideoWithCompanion', 'UniversalVideo2', 'YouTubeBumperAds', 'YouTubePreferredInventory', 'YouTubeTrueView', 'ExternallyProvidedHTML'.
Format ID `formatId`	The format id of the creative. Possible values are: 'AnimatedBanner', 'AppleNewsDoubleBanner', 'AppleNewsDoubleExpandableBanner', 'AppleNewsIAB300x250Banner', 'AppleNewsIAB300x250ExpandableBanner', 'AppleNewsIAB300x600Banner', 'AppleNewsIAB300x600ExpandableBanner', 'AppleNewsIAB320x320Banner', 'AppleNewsIAB320x320ExpandableBanner', 'AppleNewsIAB320x50Banner', 'AppleNewsIAB320x50ExpandableBanner', 'AppleNewsIAB728x90Banner', 'AppleNewsIAB728x90ExpandableBanner', 'AppleNewsIAB970x250Banner', 'AppleNewsIAB970x250ExpandableBanner', 'AppleNewsInterstitialBanner', 'AppleNewsLargeBanner', 'AppleNewsLargeExpandableBanner', 'AppleNewsMRECBanner', 'AppleNewsMRECExpandableBanner', 'AppleNewsStandardBanner', 'AppleNewsStandardExpandableBanner', 'AppleNewsVideo', 'Banner', 'CrossScreenBanner', 'CrossScreenExpandable', 'CrossScreenInterstitial', 'CrossScreenMiniscroller', 'CrossScreenReveal', 'CrossScreenBackgroundSkin', 'CrossScreenMultiUnitSkin', 'ExpandableBanner', 'ExportableFastLoadingAnimatedBanner', 'ExportableFastLoadingCrossScreenBanner', 'ExportableImage', 'ExportableVideo', 'FacebookCarouselAdPost', 'FacebookPhotoAdPost', 'FacebookVideoAdPost', 'FastLoadingCrossScreenBanner', 'FastLoadingCrossScreenExpandable', 'FastLoadingCrossScreenInterstitial', 'FlockOfBirds', 'InstaAdFacebook', 'InstaAdHtml', 'InstaAdInstagram', 'InstaAdSnapchat', 'InstaAdSnapchatWithAppInstall', 'InstaAdSnapchatWithLongformVideo', 'InstaAdSnapchatWithWebView', 'InstaAdTwitter', 'InstaAdVideoBillboard', 'InstaAdVideoHalfPage', 'InstaAdVideoInterscroller', 'InstaAdVideoInterstitial', 'InstaAdVideoPagebreak', 'InstaAdVideoRectangle', 'InstaAdVideoReveal', 'InstaAdVideoSquarePagebreak', 'InstaAdVideoTallBillboard', 'InstaAdVideoVerticalPagebreak', 'InstaAdYouTube', 'InStreamInteractiveVideo', 'InteractiveVideo', 'Interscroller', 'Interstitial', 'LandingPage', 'Lazerbird', 'MultiImageTweet', 'PlainTextTweet', 'PromotedVideoTweet', 'Pull', 'Reveal', 'ShazamForTV', 'ShazamForTVExpandable', 'ShazamInterstitial', 'SingleImageTweet', 'Slider', 'Snapchat', 'SnapchatWebView', 'SnapchatWithAppInstall', 'SnapchatWithLongformVideo', 'SnapchatWithWebView', 'SocialRichMedia', 'Stardust', 'TweetWithImageAppCard', 'TweetWithImageWebsiteCard', 'TweetWithVideoAppCard', 'TweetWithVideoWebsiteCard', 'UniversalInteractiveVideo', 'UniversalVideo', 'UniversalVideoWithCompanion', 'UniversalVideo2', 'YouTubeBumperAds', 'YouTubePreferredInventory', 'YouTubeTrueView', 'ExternallyProvidedHTML'.
Format name `formatName`	The format name of the creative. Possible values are: 'Animated Banner', 'App Install', 'Apple News Double Banner', 'Apple News Double Expandable Banner', 'Apple News Interstitial Banner', 'Apple News Large Banner', 'Apple News Large Expandable Banner', 'Apple News MREC Banner', 'Apple News MREC Expandable Banner', 'Apple News Standard Banner', 'Apple News Standard Expandable Banner', 'Apple News Video', 'Banner', 'BumperAds', 'Carousel', 'Custom Full Screen', 'Expandable Banner', 'Exportable Banner', 'Facebook Video', 'Flock of Birds', 'Google Preferred', 'IAB 300x250 Banner', 'IAB 300x250 Expandable Banner', 'IAB 300x600 Banner', 'IAB 300x600 Expandable Banner', 'IAB 320x50 Banner', 'IAB 320x50 Expandable Banner', 'IAB 320x320 Banner', 'IAB 320x320 Expandable Banner', 'IAB 728x90 Banner', 'IAB 728x90 Expandable Banner', 'IAB 970x250 Banner', 'IAB 970x250 Expandable Banner', 'Image App Card', 'Image Website Card', 'Image', 'In-banner (300x250)', 'In-banner (300x600)', 'In-banner (970x250)', 'In-banner (970x550)', 'Insta Ad html', 'Instagram Video', 'Interactive Video', 'Interscroller', 'Interstitial', 'Landing Page', 'Landscape In-article', 'Lazerbird', 'Long-Form Video', 'Long-form Video', 'Multi Image', 'Plain Text', 'Promoted Video', 'Pull Banner', 'Reveal', 'Rich Media Interactive Video', 'Served Animated Banner', 'Shazam for TV Expandable', 'Shazam for TV', 'Single Image & GIF', 'Slider Banner', 'Social Rich Media', 'Square In-article', 'Stardust', 'Static Banner', 'Top Snap', 'TrueView', 'Twitter Video', 'Fast-Loading Banner', 'Universal Banner', 'Fast-Loading Expandable', 'Universal Expandable', 'Fast-Loading Interstitial', 'Universal Interstitial', 'Universal Miniscroller', 'Universal Reveal', 'Background Skin', 'Multi-unit Skin', 'Universal VAST Video With Companion', 'Universal VAST Video', 'Vertical In-article', 'Video App Card', 'Video File', 'Video Website Card', 'Video', 'Web View Attachment', 'Web View', 'Externally Provided Creative'.
Intended device type `intendedDeviceType`	The device type for which the creative was intended. Possible values: 'Phone','Tablet','Desktop', 'Any' or 'UnknownDeviceType' (for old data in case no creative was rendered, e.g. loading interrupted).
Creative version `creativeVersion`	The version of the creative that was loaded. The creative version is updated and automatically incremented every time a change happens on the creative. This includes creative changes saved in the Builder as well as changes to creative properties (eg. creative name, custom attributes, click event definition, etc).
Creative creation date (UTC) `creativeCreationDate`	UTC date when creative was created.
Source ad product creation date (UTC) `sourceAdProductCreationDate`	UTC date when the source Ad Product used to build this creative was created. This dimension is available only for selected accounts.
Unit variant width (first rendered per impression) `firstUnitVariantWidth`	Width of the unit variant that was the first one rendered in an impression. The value of this dimension will be '(unknown)' for impressions that were not rendered and for non-universal formats.
Unit variant height (first rendered per impression) `firstUnitVariantHeight`	Height of the unit variant that was the first one rendered in an impression. The value of this dimension will be '(unknown)' for impressions that were not rendered and for non-universal formats.
Unit variant (first rendered per impression) `firstUnitVariantName`	Name of the unit variant that was the first one rendered in an impression. The value of this dimension will be '(unknown)' for impressions that were not rendered and for non-universal formats.

Snapchat

Term	Definition
Creative name `creativeName`	The name of the creative.
Snapchat ad ID `snapchatAdId`	The id of the Snapchat ad. This dimension is pulled from Snapchat reporting service. Break down by the `Creative name` dimension to get human-readable names. Note that different versions of the creative will have the same `Creative name`, but different `Snapchat ad ID`.
Snapchat ad name `snapchatAdName`	The name of the Snapchat ad. This dimension is pulled from Snapchat reporting service.
Snapchat ad type `snapchatAdType`	The type of Snapchat ad. This dimension is pulled from Snapchat reporting service. Possible values are 'SNAP_AD', 'LONGFORM_VIDEO', 'APP_INSTALL', and 'REMOTE_WEBPAGE'.
Snapchat ad status `snapchatAdStatus`	The status of Snapchat ad. This dimension is pulled from Snapchat reporting service. Possible values are 'ACTIVE' and 'PAUSED'.
Snapchat ad review status `snapchatAdReviewStatus`	The ad review status of Snapchat ad. This dimension is pulled from Snapchat reporting service. Possible values are 'PENDING', 'APPROVED', and 'REJECTED'.
Snapchat account name `snapchatAccountName`	The name of Snapchat account. This dimension is pulled from Snapchat reporting service.
Snapchat account timezone `snapchatAccountTimezone`	The timezone of Snapchat account. This dimension is pulled from Snapchat reporting service.
Snapchat ad squad ID `snapchatAdSquadId`	The ad squad ID of Snapchat ad. This dimension is pulled from Snapchat reporting service.
Snapchat creative ID `snapchatCreativeId`	The creative ID of Snapchat ad. This dimension is pulled from Snapchat reporting service.

Placement

Term	Definition
Placement ID `placementId`	The ID of the placement in which the creative was trafficked.
Placement name `placementName`	The name of the placement in which the creative was trafficked.
Placement creation date (UTC) `placementCreationDate`	UTC date when placement was created.

Partner

Term	Definition
Supplier ID `supplierId`	The ID of the supplier.
Supplier name `supplierName`	The name of the supplier.
Brand ID `brandId`	The ID of the brand/advertiser.
Brand name `brandName`	The name of the brand/advertiser.

External ad server

Term	Definition
External ad server `externalAdServer`	The ID of the external Ad Server through which the ad was trafficked.
External ad server name `externalAdServerName`	The external Ad Server name through which the ad was trafficked.
External campaign ID `externalCampaignId`	The ID of the campaign on the external Ad Server.
External campaign name `externalCampaignName`	The name of the campaign on the external Ad Server.
External creative ID `externalCreativeId`	The ID of the creative on the external Ad Server.
External creative name `externalCreativeName`	The name of the creative on the external Ad Server.
External placement ID `externalPlacementId`	The ID of the placement on the external Ad Server.
External placement name `externalPlacementName`	The name of the placement on the external Ad Server.
External site ID `externalSiteId`	The ID of the site on the external Ad Server.
External site name `externalSiteName`	The name of the site on the external Ad Server.
External supplier ID `externalSupplierId`	The ID of the supplier (publisher or exchange) on the external Ad Server.
External supplier name `externalSupplierName`	The name of the supplier (publisher or exchange) on the external Ad Server.
External impression ID `externalSessionId`	The external impression identifier.
External line item ID `externalLineItemId`	The ID of the line item on the external Ad Server.
External line item name `externalLineItemName`	The name of the external line item on the external Ad Server.
External bundle ID `externalBundleId`	The Bundle ID of the app inventory, e.g., com.company.app, as provided by the external Ad Server.
External creative width `externalCreativeWidth`	The width of the creative, as provided by the external Ad Server.
External creative height `externalCreativeHeight`	The height of the creative, as provided by the external Ad Server.
External creative size `externalCreativeSize`	The consolidated size dimension of the creative, as provided by the external Ad Server. Eg. '300x250'.
External audience id `externalAudienceId`	The first external audience ID from external audience IDs, as provided by the external Ad Server. This dimension is available only for selected accounts.

External user id

Term	Definition
External user id `externalUserId`	The id of the user on the external Ad Server.

SDK

Term Definition

Term	Definition
SDK `sdk`	The SDK used for serving the ad. Possible values: 'AMP', 'AOL', 'AdMarvel', 'AdMob', 'Amazon', 'AppleNews', 'DFP', 'Facebook', 'Jumptap', 'MRAID', 'MRAIDVPAID', 'MillennialMedia', 'Mobclix', 'MobileWeb', 'NexageORMMA', 'ORMMA', 'Pandora', 'SafeFrame', 'Shazam', 'Snapchat', 'Twitter', 'Unknown', 'VAST', 'VPAID', 'YouTube', 'GoogleAds'. Can be '(unknown)' for VPAID sdk if the video player does not make a subsequent request for .
Fallback SDK `fallbackSdk`	The SDK used for serving the ad, after the original SDK failed. In certain situations, when SDK is configured or detected as MRAID, but later the 'mraid' object is not found, another SDK will be attempted, typically 'MobileWeb' or 'Standalone'.

SDK sdk

The SDK used for serving the ad.

Possible values: 'AMP', 'AOL', 'AdMarvel', 'AdMob', 'Amazon', 'AppleNews', 'DFP', 'Facebook', 'Jumptap', 'MRAID', 'MRAIDVPAID', 'MillennialMedia', 'Mobclix', 'MobileWeb', 'NexageORMMA', 'ORMMA', 'Pandora', 'SafeFrame', 'Shazam', 'Snapchat', 'Twitter', 'Unknown', 'VAST', 'VPAID', 'YouTube', 'GoogleAds'. Can be '(unknown)' for VPAID sdk if the video player does not make a subsequent request for .

Fallback SDK fallbackSdk

The SDK used for serving the ad, after the original SDK failed.

In certain situations, when SDK is configured or detected as MRAID, but later the 'mraid' object is not found, another SDK will be attempted, typically 'MobileWeb' or 'Standalone'.

Device

Term	Definition
Device type `actualDeviceType`	The device type that was recorded in an impression. Possible values: 'Phone','Tablet','Desktop', 'ConnectedTV' or 'UnknownDeviceType'.
Platform `platform`	The platform on which the creative was loaded. Possible values: 'Android', 'BlackBerry', 'Desktop', 'DesktopPlatform', 'IOS', 'WAPBrowser', 'WebOS', 'WindowsPhone' or 'UnknownPlatform'.
Language `language`	The language, provided by the HTTP Request for the browser. Relies on 'Accept-Language' HTTP header, in ISO-639 code format, expressed as a 2 or 3-character string.

Display

Term	Definition
Exposure time 3s bucket `viewableTimeBucket`	The grouping of `Impressions with exposure time` in a bucket of specific `Exposure time`. The value is capped at 60 seconds, so any value greater than 60 will be replaced with 60. Possible values are '0', '3', '6', ..., '50', '60', '(unknown)'.

Creative structure

Term	Definition
Unit `unitName`	The name of the unit, for example: 'banner', 'modal'.
Is unit view accidental `isUnitShowAccidental`	Indicates if the unit was rendered to the user as a result of an unintentional interaction. Will be 'N/A' for all non-modal units and 'Yes' or 'No' for modal units.
Unit variant Local ID `unitVariantLocalId`	The Local ID of the unit variant.
Page depth `screenDepth`	The number of unique pages in the unit visited as part of the impression. This number can be expressed as 1, 2, 3, etc. or 20+
Time on page known `timeOnScreenKnown`	Indicates if the time the user spent on the page is known or not. Possible values are 'Yes' and 'No'.
Page Local ID `screenLocalId`	The Local ID of the page.
Page name `screenTitle`	The name of the page.
Unit variant width `unitVariantWidth`	Width of the unit variant for impressions. '(unknown)' for non-universal formats.
Unit variant height `unitVariantHeight`	Height of the unit variant for impressions. '(unknown)' for non-universal formats.
Unit variant `unitVariantName`	Name of the unit variant for impressions. '(unknown)' for non-universal formats.

Social

Term	Definition
Shared url `sharedUrl`	The URL that was shared in a message or on a social network.
Shared type `shareType`	The type of object that was shared in a message or on a social network.
Shared asset blob hash `sharedAssetBlobHash`	The blob hash of the asset (predefined image, video or user-generated content) that was shared in a message or on a social network.

Study

Term	Definition
Study ID `clientExperimentId`	The ID of the study. This dimension is available only for selected accounts.
Study name `clientExperimentName`	The name of the study. This dimension is available only for selected accounts.
Study type `studyType`	The type of the study. Possible values: 'creativeLiftStudy', and 'splitTest'. This dimension is available only for selected accounts.
Unit of randomization `experimentalUnit`	The unit used for randomization into Treatment(s) / Control groups in the study. Possible values: 'platformAdvId', 'sessionId', 'adobeCookieId', 'celtraCookieId', 'externalUserId', and 'customUserIdentifier'. This dimension is available only for selected accounts.
Experimental unit value `experimentalUnitValue`	The value of `Unit of randomization`. This dimension is available only for selected accounts.
Study success event `experimentPrimaryKPIEvent`	The event that is considered a success in the study. Possible values: 'interaction', 'click' and 'custom'. This dimension is available only for selected accounts.
Study group choice ID `clientExperimentParameterChoiceId`	The ID of the chosen study group. This dimension is available only for selected accounts.
Study group choice name `clientExperimentParameterChoiceName`	The name of the chosen study group. This dimension is available only for selected accounts.
Study group choice weight `clientExperimentParameterChoiceWeight`	The (non-normalized) weight of the chosen study group. When equal split is configured, the values for all study groups will be 1. This dimension is available only for selected accounts.
Baseline study group choice `clientExperimentParameterChoiceIsBaseline`	Indicates that study group choice is the baseline (the one that is shown to the control group for Creative Lift Study). Possible values are 'Yes' and 'No'. This dimension is available only for selected accounts.
Adobe cookie ID `adobeCookieId`	The ID of the Adobe cookie.
Derived audience ID `derivedAudienceId`	The ID of the derived audience. Defined when derived audience was used in a study, '(unknown)' otherwise. This dimension is available only for selected accounts.
Event source `eventSource`	Name of the event source (e.g. Celtra). This dimension is available only for selected accounts.
Event name `eventName`	The name of conversion event, as defined by the external or interval source (e.g. Celtra). This dimension is available only for selected accounts.
Event group `eventGroup`	Name of the event group. This dimension is available only for selected accounts.

Inline and 360 Video

Term	Definition
Inline Video Local ID `inlineVideoLocalId`	The Local ID of the video.
Reporting label `label`	A text description used for reporting, as specified in the creative.
Source type `inlineVideoSourceType`	The source type of the video file. Either 'FILE' or 'URL'.
Source `inlineVideoSource`	The source of the video. When the `Source type` is 'File', the source will be the video blobHash. When the `Source type` is URL, the source is the URL of the video. The max length for this field is 64 characters, so URLs may be cropped.
Filename `inlineVideoFilename`	Filename of uploaded video asset. The value of this dimension will be '(unknown)' for PlayFromUrlAction and Youtube video player component.
Player mode `inlineVideoPlayerMode`	Indicates the player mode. Possible values: 'display', 'display-action' and '(unknown)'.
Inline video length `inlineVideoLength`	The length of the inline video in seconds, rounded up to the nearest second. If the inline video length cannot be determined, the value will be '(unknown)'.
Play audibility `inlineVideoActualAudibility`	Indicates whether a given Inline Video was played with or without sound. Possible values are 'audible', 'muted' and '(unknown)'.
Intended audibility `inlineVideoIntendedAudibility`	Intended audibility for a given Inline Video component. Possible values are 'audible', 'muted' and '(unknown)'. Does not necessarily mean that the Inline Video actually started playing with or without sound, just what the setting was.
Play setting `inlineVideoPlaySetting`	The initial setting of how a given Inline Video play started. Possible values are 'Autoplay', 'User-initiated' and '(unknown)'.
Second marker `inlineVideoSecond`	Indicates what specific second a video has played through using each individual second in the length (capped at 120 seconds) of the inline video as an index. '0' represents the start of first second, '1' the next second and videoLength - 1 represents the last second. The metric `Inline video second marker unique views` is available by this dimension.
Quarter marker `inlineVideoQuarter`	Indicates what specific quarter an Inline Video has played through using each quarter within the entire length of the video as an index. One of '0' (start of the first quarter, equal to starts), '1' (end of Q1, start of Q2), '2', '3', '4' (end of Q4, equal to finishes). Metric `Inline video quarter marker unique views` is available by this dimension.
Is 360 video `inlineVideoIs360`	Indicates whether the inline video is a 360 video or not. Possible values are 'Yes', 'No' and '(unknown)'.

Actions

Term	Definition
Reporting label `label`	A text description used for reporting, as specified in the creative.
Image blob hash `imageBlobHash`	The blob hash of the image that the user attempted to download.

Video

Term	Definition
Video length `videoLength`	The length of the video in seconds, rounded up to the nearest second. If the video length cannot be determined, the value will be '(unknown)'.
VAST version `vastVersion`	The VAST version. If VAST version cannot be determined, the value will be '(unknown)'.
VAST companion ad ID `vastCompanionAdId`	The ID of VAST companion ad. This dimension is available only for selected accounts.
VAST companion ad width `vastCompanionAdWidth`	The width of VAST companion ad. This dimension is available only for selected accounts.
VAST companion ad height `vastCompanionAdHeight`	The height of VAST companion ad. This dimension is available only for selected accounts.
VAST companion ad size `vastCompanionAdSize`	The size of VAST companion ad in 'width x height' format. This dimension is available only for selected accounts.
VAST companion ad type `vastCompanionAdType`	The type of VAST companion ad. Possible values: 'Static', 'ExternalUrl' or 'RichMedia'. This dimension is available only for selected accounts.

A/B testing

Term	Definition
A/B test `abTest`	Name of the A/B test, as defined in the creative.
A/B test optimized `abTestOptimized`	Whether the A/B test had optimization enabled or not in the creative.
A/B test variant `abVariant`	Variant of the `A/B test`.

Locator

Term	Definition
Object local ID `objectLocalId`	Local ID of the component.
Object name `objectName`	The name of the component.
Location id `locationId`	Location ID of the location stored in a location table.
Location name `locationName`	Name of the location as stored in a location table.
Location address `locationAddress`	Address of the location as stored in a location table.
Location city `locationCity`	City where the location is located as stored in a location table.
Location state `locationState`	State where the location is located as stored in a location table.
Location country `locationCountry`	Country where the location is located as stored in a location table.

Errors

Term	Definition
Type of error `errorType`	The type of `Error`.
Error `error`	The specific error.

Requested impressions

Term Definition

Term	Definition
Invalid impression reason `invalidSessionReason`	The reason for impression to be deemed invalid. This can be a consequence of General Invalid Traffic filtration or due to incomplete, erroneous or abnormal data received. Possible values: 'IgnoredSubnet' (request made from any client/proxy IP that belongs to a subnet, ignored by the account), 'Robot' (included in IAB Industry Robot List), 'InvalidBrowser' (not included in IAB Industry Valid Browser List), 'DataCenterTraffic' (known data-center traffic), 'ModelConstraint' (incomplete, erroneous or abnormal data received) or 'NoError' (valid impression).

Invalid impression reason invalidSessionReason

The reason for impression to be deemed invalid. This can be a consequence of General Invalid Traffic filtration or due to incomplete, erroneous or abnormal data received.

Possible values: 'IgnoredSubnet' (request made from any client/proxy IP that belongs to a subnet, ignored by the account), 'Robot' (included in IAB Industry Robot List), 'InvalidBrowser' (not included in IAB Industry Valid Browser List), 'DataCenterTraffic' (known data-center traffic), 'ModelConstraint' (incomplete, erroneous or abnormal data received) or 'NoError' (valid impression).

Impression

Term	Definition
Session ID `sessionId`	The Celtra Session ID.

User

Term	Definition
Platform advertising ID `platformAdvId`	The unmodified value of platform advertising ID (IDFA for iOS, AAID for Android).

GeoIP

Term	Definition
Country code `countryCode`	ISO 3166-1 two-letter ISO country code.
Country `countryName`	The country name associated to countryCode.
State/province code `principalSubdivisionCode`	State or province. The second part of ISO 3166-2, up to three alphanumeric characters.
State/province `principalSubdivisionName`	The state or province name associated to principalSubdivisionCode.
City `cityName`	The city name.
City geo name ID `cityGeoNameId`	The city geo name ID.

Facebook

Term	Definition
Facebook account ID `facebookAccountId`	The unique ID of the Facebook account. This dimension is pulled from Facebook reporting service (account_id).
Facebook account name `facebookAccountName`	Name of the Facebook ad account. This dimension is pulled from Facebook reporting service (account_name).
Facebook campaign ID `facebookCampaignId`	The unique ID of the Facebook campaign. This dimension is pulled from Facebook reporting service (campaign_id).
Facebook campaign name `facebookCampaignName`	Name of the Facebook campaign. This dimension is pulled from Facebook reporting service (campaign_name).
Facebook ad set ID `facebookAdSetId`	The unique id of the Facebook ad set. This dimension is pulled from Facebook reporting service (adset_id).
Facebook ad set name `facebookAdSetName`	Name of the Facebook ad set. This dimension is pulled from Facebook reporting service (adset_name).
Facebook ad ID `facebookAdId`	The unique ID of the Facebook ad. This dimension is pulled from Facebook reporting service (ad_id).
Facebook ad name `facebookAdName`	Name of the Facebook ad. This dimension is pulled from Facebook reporting service (ad_name).
Facebook page ID `facebookPageId`	The unique id of the Facebook page. This dimension is pulled from Facebook reporting service.
Facebook conversion rate ranking `facebookConversionRateRanking`	The ranking of your ad's expected conversion rate. Your ad is ranked against ads with your optimization goal that competed for the same audience. Possible values include BELOW_AVERAGE_10, BELOW_AVERAGE_20, BELOW_AVERAGE_35, AVERAGE, ABOVE_AVERAGE, or UNKNOWN if there's not enough information about the ad. This metric is pulled from Facebook report service (conversion_rate_ranking).
Facebook device `facebookDevice`	Device used by viewer. Can be Android phone/tablet, desktop, ipad/iphone, other. This dimension is pulled from Facebook reporting service (action_device). Possible values are 'android_smartphone', 'android_tablet', 'desktop', 'ipad', 'iphone', 'other'.
Facebook publisher platform `facebookPublisherPlatform`	Name of publisher platform. This dimension is pulled from Facebook reporting service (publisher_platform). Possible values are 'Facebook', 'Instagram' depending on where the ad has appeared.
Facebook platform position `facebookPlatformPosition`	Includes feed, instant_article, right_hand_column where ad was shown. This dimension is pulled from Facebook reporting service (platform_position). Some of possible values are 'feed', 'instant_article', 'right_hand_column' depending on where the ad has appeared.
Facebook region `facebookRegion`	Region where the ad was shown. This dimension is pulled from Facebook reporting service (region).
Facebook country `facebookCountry`	Country where the ad was shown. This dimension is pulled from Facebook reporting service (country).
Facebook gender `facebookGender`	Gender of the viewer. This dimension is pulled from Facebook reporting service (gender).
Facebook age `facebookAge`	Age of the viewer. This dimension is pulled from Facebook reporting service (age).

Twitter

Term	Definition
Twitter ad ID `twitterAdId`	Twitter ad ID. This dimension is pulled from Twitter reporting service.
Twitter ad group ID `twitterAdGroupId`	Twitter ad group ID. This dimension is pulled from Twitter reporting service.
Twitter ad status `twitterAdStatus`	Twitter ad status. This dimension is pulled from Twitter reporting service.
Twitter account ID `twitterAccountId`	Twitter account ID. This dimension is pulled from Twitter reporting service.
Twitter account timezone `twitterAccountTimeZone`	Twitter account timezone. This dimension is pulled from Twitter reporting service.
Twitter placement `twitterPlacement`	Twitter placement. This dimension is pulled from Twitter reporting service. Possible values are 'ALL_ON_TWITTER' or 'PUBLISHER_NETWORK' based on where the ad was served.

External events

Term	Definition
External event source `externalEventSource`	Name of the external event source.
Event set ID `userEventSetId`	The ID of the Celtra event set in which the external event was registered.
Event set name `userEventSetName`	The name of the Celtra event set in which the external event was registered.
External event app ID `externalAppId`	The ID of external app or site in which the external event was registered or '(unknown)' if not applicable.
External event app name `externalAppName`	The name of external app or site in which the external event was registered or '(unknown)' if not applicable.
External event ID `externalEventId`	External event ID. The ID of conversion event, as defined by the external source.
External event name `externalEventName`	External event name. The name of conversion event, as defined by the external source.

Audience

Term Definition

Matched audience ID strategyDerivedAudienceIdMatch

The ID of the 'external line item audience' that was matched in an impression.

External line item audience is matched when External line item ID provided to Celtra matches one of the external line item IDs defined for this audience. '(unknown)' when External line item ID was not provided to Celtra or does not match any audiences used in a strategy. This dimension is available only for selected accounts.

Matched audience name strategyDerivedAudienceNameMatch

The name of the 'external line item audience' that was matched in an impression.

External line item audience is matched when External line item ID provided to Celtra matches one of the external line item IDs defined for this audience. '(unknown)' when External line item ID was not provided to Celtra or does not match any audiences used in a strategy. This dimension is available only for selected accounts.

Decision tree

Term	Definition
Decision tree ID `decisionTreeId`	The internal ID of the decision tree. Can be '(unknown)' when decision tree is not used. This dimension is available only for selected accounts.
Decision tree version `decisionTreeVersion`	The version of the decision tree. Can be '(unknown)' when decision tree is not used. Decision tree version is incremented every time a decision tree is changed. This dimension is available only for selected accounts.
Decision tree outcome node ID `decisionTreeOutcomeNodeId`	The ID of the outcome node of a decision tree. Can be '(unknown)' when decision tree is not used. This dimension is available only for selected accounts.

Feeds

Term	Definition
Feed ID `feedId`	Feed ID. The ID of the feed used to provide content to the creative.
Feed name `feedName`	Feed name. The name of the feed used to provide content to the creative.
Feed field key `feedFieldKey`	Feed field key. Uniquely identifies each feed field that is part of real-time, rule-based or location-based feed.
Feed field ID `feedFieldId`	Feed field ID.
Feed field name `feedFieldName`	Feed field name.
Feed field value `feedFieldValue`	Feed field value.
Feed row position `feedRowPosition`	Feed row position (0 based). A position of a feed field value in a list of returned feed field values.
Feed report label `feedReportLabel`	Feed report label. A text description used for reporting of feed selections. This uses reportLabel field for real-time, rule-based or location-based feed.

Surveys

Term	Definition
Survey ID `surveyId`	ID of survey. This dimension is available only for selected accounts.
Survey name `surveyName`	Name of survey. This dimension is available only for selected accounts.
Survey question ID `surveyQuestionId`	ID of question in the survey. This dimension is available only for selected accounts.
Survey question text `surveyQuestionText`	Text of question in the survey. This dimension is available only for selected accounts.
Survey question position `surveyQuestionOrderIndex`	Position of survey question in the survey. This dimension is available only for selected accounts.
Survey question type `surveyQuestionType`	Type of question in the survey. Possible values are 'Single', 'Scale' or 'Multi'. This dimension is available only for selected accounts.
Survey answer ID `surveyAnswerId`	ID of the survey answer in survey question. This dimension is available only for selected accounts.
Survey answer text `surveyAnswerText`	Text of the survey answer in survey question. This dimension is available only for selected accounts.
Survey answer position `surveyAnswerOrderIndex`	Position of the survey answer in survey question. This dimension is available only for selected accounts.
Survey answer value `surveyAnswerValue`	Value associated with a survey answer selection. For scale questions, the values might be 1-5 or for multi questions the values might be 0-1 (marking one answer with 1). This dimension is available only for selected accounts.

Soundtrack

Term	Definition
Name `soundtrackName`	A soundtrack's name. The name of the soundtrack.
Source `soundtrackSource`	A soundtrack's source. The source is the URL of the soundtrack. The max length for this field is 64 characters, so URLs may be cropped.

Error Descriptions

For steps on how to troubleshoot the trafficking issues and analytics errors described below, click here.

Ad placement is Interstitial, but creative is not `sessionsWithErrorMraidMismatchPlacementInline`	This error applies to MRAID SDKs only. MRAID SDKs categorize placements in one of two ways: Inline Interstitial If a Celtra interstitial creative is trafficked to an inline placement, or if a non-interstitial creative is trafficked to an interstitial placement the creative will record one of these errors. The impact on performance is dependent on how the SDK handles a creative/placement mismatch. Some SDKS will allow the ad to display, at the expense of a degraded user experience.
Ad served into a webpage that is not mobile-optimized `sessionsWithErrorNonMobileOptimized`	This error indicates that a page is zoomable on mobile devices, which negatively impacts user experience. By itself, this does not impact performance metrics. However, in many cases, this is an indicator of poor-quality inventory for mobile ads and may show unrelated performance issues.
Ad served into non-friendly iframe `sessionsWithErrorNonFriendlyIFrame`	Occurs when an incompatible ad format is served into a non-IAB-friendly iframe. When this happens, the ad cannot access the top window of a page, potentially impacting rendering and behavior. Ensure the creative is being served into an IAB-friendly iframe or no iframe at all.
Navigation URL is empty. `sessionsWithErrorNavigationUrlIsEmpty`	This error occurs when either the openClickThroughDestination, goToURL, or getApp action is present in creative and is triggering but there is no exit URI defined for any of them.
clickUrl is non-empty and contains a value that is not a URL. `sessionsWithErrorClickUrlNotExpanded`	A value in the `clickURL` field cannot be read as a URL. For example: `%`
Creative expanded before appearing	Occurs when a creative is expanded before it has appeared - a scenario Celtra creatives do not support.
Creative is interstitial format, but ad placement is not `sessionsWithErrorMraidMismatchPlacementInterstitial`	This error applies to MRAID SDKs only. MRAID SDKs categorize placements in one of two ways: Inline Interstitial If a Celtra interstitial creative is trafficked to an inline placement, or if a non-interstitial creative is trafficked to an interstitial placement the creative will record one of these errors. The impact on performance is dependent on how the SDK handles a creative/placement mismatch. Some SDKS will allow the ad to display, at the expense of a degraded user experience.
Feed value was unavailable `FeedValueMissing`	This error only applies to components that support dynamic content feeds (Texty, Picture, Video, and Choice Feed component), and the relevant actions (goToFeedURL and checkChoiceFeed). When this error occurs, your campaign may serve blanks because of the following possible reasons: A feed value is missing or empty No rules match A corresponding rule value from the CSV is empty
More than one sticky ad served into page `sessionsWithErrorMultipleStickyAds`	Sticky ad formats (pull banners, sticky/adhesion banners) will interfere with the functionality of other sticky formats if more than one are rendered on the same screen. To prevent this issue, Celtra will not serve sticky format ads on screens which already have an active sticky unit.
mraid.getPlacementType is not available or returns invalid value `sessionsWithErrorMraidPlacementTypeNotCompliant`	This error applies to MRAID SDKs only. All MRAID SDKs must implement the method `getPlacementType` according to IAB specifications. The creative records this error when the method: is missing returns a value that does not match the IAB specifications This error does not directly impact performance, but indicates that an SDK is not fully MRAID compliant, and could lead to additional issues.
MRAID object doesn't exist `sessionsWithErrorMissingMraidObject`	MRAID tags must be trafficked to environments that: implement the MRAID standard provide an `mraid.js` object with which the ad can interact When an Celtra MRAID tag serves to a publisher environment that does not provide the `mraid.js` object, this error is recorded.
Placement is too small to fit any of the Unit Variants placed on the creative `sessionsWithErrorUnitVariantsDoNotFitPlacement`	This error occurs when a creative is served into a small placement and none of its unit variants can fully fit into the placement. For example: If a creative has unit variants 50x50 and 100x50, but the placement is 100x49, the height is too small to accommodate either variant and the error is fired.
Tracking Event Limit Reached `sessionsWithErrorEventLimitReached`	Celtra limits 1000 tracking events per session. After that limit is reached, no additional events are tracked except for user errors.
Unsupported OS on mobile device or browser on non-mobile device. `sessionsWithErrorUnsupportedBrowserOrOS`	Appears when the creative attempts to serve to an unsupported browser or device. See here which browsers and devices are supported.
VPAID creative; no video component on the first screen `sessionsWithErrorMissingVideoObject`	When a VPAID creative is built without a video component on the first screen, this error occurs as a courtesy to the builder. VPAID is a video-based format and should always include a video.
VPAID is not available `sessionsWithErrorVpaidNotSupported`	The creative is trafficked to an environment where the MRAID implementation does not include VPAID support.
Exit URI is empty. `sessionsWithErrorExitUriIsEmpty`	This error will occur when either: Open Website, Open Click-Through Destination, Open Website (from feed) or Get App action is present in the creative and was triggered without a defined exit URI. The clickthrough URI is not defined in the Outstream Video Creative and a URI open/exit attempt was made. Please define a destination for the actions above before proceeding.
Impressions with error 'Ad exceeded the maximum allowed CPU usage.'`sessionsWithErrorHeavyAdCPUIntervention`	The number of impressions in which 'Ad exceeded the maximum allowed CPU usage.' error occurred.
Impressions with error 'Ad exceeded the maximum allowed network bandwidth.'`sessionsWithErrorHeavyAdNetworkIntervention`	The number of impressions in which 'Ad exceeded the maximum allowed network bandwidth.' error occurred.

Troubleshoot Trafficking Errors

Analytics Glossary open Created with Sketch.