CreativeX: Most-used fields
The table below gives information about most-used fields that you can import from CreativeX. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
Creative GuidelineDimension
Represents a specific creative guideline identified for an asset, often part of nested structures in report data.
Creative Guideline ValueMetric
The value or status associated with a specific creative guideline for an asset.
ad_account_idDimension
A unique identifier for the advertising account associated with the creative asset or post.
ad_formatDimension
The type or style of the ad creative.
ad_idDimension
Unique identifier for an individual ad (post) within the CreativeX platform. This ID is used to access data on the level of a specific ad.
all_conversionsDimension
Total number of all conversion events tracked, such as website visits, sign-ups, or purchases, following an ad interaction.
aspect_ratioDimension
The proportional relationship between the width and height of a creative asset.
asset_typeDimension
The type of creative asset, e.g., image, video, or text.
brandDimension
The brand associated with the creative assets or campaigns, used as a report dimension.
campaign_idDimension
A unique identifier for the advertising campaign to which the creative asset belongs.
channelDimension
The media channel where the creative asset was published or evaluated (e.g., Facebook, Instagram, YouTube), used as a report dimension.
clicksMetric
The total number of clicks on the creative asset or advertisement.
content_typeDimension
The classification of the creative asset, such as an image, video, or carousel. This is a standard dimension for data segmentation.
conversionsMetric
Total number of specific desired actions or events completed by users, such as a lead submission or a download, after interacting with creative content.
cost_per_estimated_ad_recallerMetric
The average cost incurred for each estimated ad recaller, where an ad recaller is an individual estimated to remember seeing the advertisement.
cpcMetric
The average cost incurred for each click on the advertisement (Cost Per Click).
cpmMetric
The average cost incurred for one thousand impressions of the advertisement (Cost Per Mille).
creative_linkDimension
A URL linking to the creative asset itself.
creative_quality_scoreMetric
A proprietary score from CreativeX indicating the overall quality of the creative asset based on established guidelines.
creative_quality_tierDimension
A category or tier assigned to the creative based on its quality score.
creativex_asset_idDimension
CreativeX's internal identifier for a creative asset.
creativex_post_idDimension
CreativeX's internal identifier for a social media post.
ctaDimension
The call to action used in the creative, such as 'Shop Now' or 'Learn More'.
ctrMetric
The percentage of impressions that resulted in a click (Click-Through Rate).
currencyDimension
The currency used for financial metrics like spend, CPC, and CPM.
date_capturedDimension
The specific date when the data for the creative asset or post was captured.
dimensionsDimension
The set of dimensions (e.g., brand, market, channel) used for reporting and analysis.
engagement_rateMetric
The percentage of people who interacted with the creative content (e.g., likes, comments, shares, clicks) relative to its reach or impressions.
engagementsMetric
The total number of interactions users had with the creative content, such as likes, comments, shares, or clicks.
estimated_ad_recall_rateMetric
The estimated rate at which people remember seeing the advertisement.
estimated_ad_recallersMetric
The estimated number of people who remember seeing the advertisement.
heightDimension
The height, in pixels, of the creative asset, such as an image or video.
impressionsMetric
The total number of times the advertisement was shown.
marketDimension
The geographical market associated with the creative assets or campaigns, used as a report dimension.
post_linkDimension
A URL linking to the original social media post.
publisherDimension
The media platform or network where the creative asset was published (e.g., Facebook, Instagram).
purchase_countDimension
The total number of purchases attributed to the creative content or ad campaigns.
purchase_rateDimension
The percentage of users who made a purchase after interacting with the creative content.
reachMetric
The total number of unique users who have seen the ad creative.
report_dateDimension
The date corresponding to the reported performance metrics.
roasMetric
The Return On Ad Spend, calculated as the revenue generated for every dollar spent on advertising through CreativeX campaigns.
spendMetric
The total amount of money spent on the advertisement or campaign.
statusDimension
The current status of the creative asset, post, or report (e.g., 'DONE' for a completed report).
unique_video_3_sec_viewsMetric
The number of unique viewers who watched the video creative for at least 3 seconds.
video_100_viewsMetric
The number of times the video creative was viewed to 100% completion.
video_15_sec_viewsMetric
The number of times the video creative was viewed for at least 15 seconds.
video_25_viewsMetric
The number of times the video creative was viewed to at least 25% completion.
video_30_sec_viewsMetric
The number of times the video creative was viewed for at least 30 seconds.
video_3_sec_viewsMetric
The number of times the video creative was viewed for at least 3 seconds.
video_50_viewsMetric
The number of times the video creative was viewed to at least 50% completion.
video_75_viewsMetric
The number of times the video creative was viewed to at least 75% completion.
video_avg_time_watchedMetric
This metric represents the average duration, in seconds, that a video creative was watched by users. It is a key indicator of audience engagement and content effectiveness for individual video ads or posts, available through the CreativeX Reporting API as part of attention data.
video_lengthMetric
The total duration of the video creative asset.
widthDimension
The width, in pixels, of the creative asset, such as an image or video.