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 Guideline Dimension
Represents a specific creative guideline identified for an asset, often part of nested structures in report data.
Creative Guideline Value Metric
The value or status associated with a specific creative guideline for an asset.
ad_account_id Dimension
A unique identifier for the advertising account associated with the creative asset or post.
ad_format Dimension
The type or style of the ad creative.
ad_id Dimension
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_conversions Dimension
Total number of all conversion events tracked, such as website visits, sign-ups, or purchases, following an ad interaction.
aspect_ratio Dimension
The proportional relationship between the width and height of a creative asset.
asset_type Dimension
The type of creative asset, e.g., image, video, or text.
brand Dimension
The brand associated with the creative assets or campaigns, used as a report dimension.
campaign_id Dimension
A unique identifier for the advertising campaign to which the creative asset belongs.
channel Dimension
The media channel where the creative asset was published or evaluated (e.g., Facebook, Instagram, YouTube), used as a report dimension.
clicks Metric
The total number of clicks on the creative asset or advertisement.
content_type Dimension
The classification of the creative asset, such as an image, video, or carousel. This is a standard dimension for data segmentation.
conversions Metric
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_recaller Metric
The average cost incurred for each estimated ad recaller, where an ad recaller is an individual estimated to remember seeing the advertisement.
cpc Metric
The average cost incurred for each click on the advertisement (Cost Per Click).
cpm Metric
The average cost incurred for one thousand impressions of the advertisement (Cost Per Mille).
creative_link Dimension
A URL linking to the creative asset itself.
creative_quality_score Metric
A proprietary score from CreativeX indicating the overall quality of the creative asset based on established guidelines.
creative_quality_tier Dimension
A category or tier assigned to the creative based on its quality score.
creativex_asset_id Dimension
CreativeX's internal identifier for a creative asset.
creativex_post_id Dimension
CreativeX's internal identifier for a social media post.
cta Dimension
The call to action used in the creative, such as 'Shop Now' or 'Learn More'.
ctr Metric
The percentage of impressions that resulted in a click (Click-Through Rate).
currency Dimension
The currency used for financial metrics like spend, CPC, and CPM.
date_captured Dimension
The specific date when the data for the creative asset or post was captured.
dimensions Dimension
The set of dimensions (e.g., brand, market, channel) used for reporting and analysis.
engagement_rate Metric
The percentage of people who interacted with the creative content (e.g., likes, comments, shares, clicks) relative to its reach or impressions.
engagements Metric
The total number of interactions users had with the creative content, such as likes, comments, shares, or clicks.
estimated_ad_recall_rate Metric
The estimated rate at which people remember seeing the advertisement.
estimated_ad_recallers Metric
The estimated number of people who remember seeing the advertisement.
height Dimension
The height, in pixels, of the creative asset, such as an image or video.
impressions Metric
The total number of times the advertisement was shown.
market Dimension
The geographical market associated with the creative assets or campaigns, used as a report dimension.
post_link Dimension
A URL linking to the original social media post.
publisher Dimension
The media platform or network where the creative asset was published (e.g., Facebook, Instagram).
purchase_count Dimension
The total number of purchases attributed to the creative content or ad campaigns.
purchase_rate Dimension
The percentage of users who made a purchase after interacting with the creative content.
reach Metric
The total number of unique users who have seen the ad creative.
report_date Dimension
The date corresponding to the reported performance metrics.
roas Metric
The Return On Ad Spend, calculated as the revenue generated for every dollar spent on advertising through CreativeX campaigns.
spend Metric
The total amount of money spent on the advertisement or campaign.
status Dimension
The current status of the creative asset, post, or report (e.g., 'DONE' for a completed report).
unique_video_3_sec_views Metric
The number of unique viewers who watched the video creative for at least 3 seconds.
video_100_views Metric
The number of times the video creative was viewed to 100% completion.
video_15_sec_views Metric
The number of times the video creative was viewed for at least 15 seconds.
video_25_views Metric
The number of times the video creative was viewed to at least 25% completion.
video_30_sec_views Metric
The number of times the video creative was viewed for at least 30 seconds.
video_3_sec_views Metric
The number of times the video creative was viewed for at least 3 seconds.
video_50_views Metric
The number of times the video creative was viewed to at least 50% completion.
video_75_views Metric
The number of times the video creative was viewed to at least 75% completion.
video_avg_time_watched Metric
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_length Metric
The total duration of the video creative asset.
width Dimension
The width, in pixels, of the creative asset, such as an image or video.