Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
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.