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.

API name	Adverity UI name	Description	Use in Adverity
Creative Guideline	Creative Guideline	Represents a specific creative guideline identified for an asset, often part of nested structures in report data.	dimension
Creative Guideline Value	Creative Guideline Value	The value or status associated with a specific creative guideline for an asset.	metric
ad_account_id	ad_account_id	A unique identifier for the advertising account associated with the creative asset or post.	dimension
ad_format	ad_format	The format of the advertisement, such as image, video, or carousel.	dimension
ad_id	ad_id	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.	dimension
all_conversions	all_conversions	The total number of conversions attributed to the advertisement, including all types of conversion events.	metric
aspect_ratio	aspect_ratio	The proportional relationship between the width and height of a creative asset.	dimension
asset_type	asset_type	The type of creative asset, e.g., image, video, or text.	dimension
brand	brand	The brand associated with the creative assets or campaigns, used as a report dimension.	dimension
branded	branded	A flag indicating whether the creative asset is identified as branded content.	dimension
campaign_id	campaign_id	A unique identifier for the advertising campaign to which the creative asset belongs.	dimension
channel	channel	The media channel where the creative asset was published or evaluated (e.g., Facebook, Instagram, YouTube), used as a report dimension.	dimension
clicks	clicks	The total number of clicks on the creative asset or advertisement.	metric
content_type	content_type	The type of content associated with the creative asset, such as image or video.	dimension
conversions	conversions	The number of key conversion events attributed to the advertisement.	metric
cost_per_estimated_ad_recaller	cost_per_estimated_ad_recaller	The cost incurred for each estimated ad recaller, indicating the efficiency of generating ad recall.	dimension
cpc	cpc	The average cost incurred for each click on the advertisement (Cost Per Click).	metric
cpm	cpm	The average cost incurred for one thousand impressions of the advertisement (Cost Per Mille).	metric
creative_link	creative_link	A URL linking to the creative asset itself.	dimension
creative_quality_score	creative_quality_score	A proprietary score from CreativeX indicating the overall quality of the creative asset based on established guidelines.	metric
creative_quality_score_tier	creative_quality_score_tier	A categorized level representing the creative quality score of the asset.	dimension
creative_quality_tier	creative_quality_tier	A category or tier assigned to the creative based on its quality score.	dimension
creativex_asset_id	creativex_asset_id	CreativeX’s internal identifier for a creative asset.	dimension
creativex_post_id	creativex_post_id	CreativeX’s internal identifier for a social media post.	dimension
cta	cta	The call to action used in the creative, such as ‘Shop Now’ or ‘Learn More’.	dimension
ctr	ctr	The percentage of impressions that resulted in a click (Click-Through Rate).	metric
currency	currency	The currency used for financial metrics like spend, CPC, and CPM.	dimension
date_captured	date_captured	The specific date when the data for the creative asset or post was captured.	dimension
dimensions	dimensions	The set of dimensions (e.g., brand, market, channel) used for reporting and analysis.	dimension
engagement_rate	engagement_rate	The rate at which users engaged with the creative, calculated as engagements divided by impressions or reach.	metric
engagements	engagements	The total number of interactions users had with the creative, such as likes, comments, shares, and clicks.	metric
estimated_ad_recall_rate	estimated_ad_recall_rate	The estimated rate at which people remember seeing the advertisement.	metric
estimated_ad_recallers	estimated_ad_recallers	The estimated number of people who remember seeing the advertisement.	dimension
height	height	The height dimension of the creative asset.	metric
impressions	impressions	The total number of times the advertisement was shown.	metric
market	market	The geographical market associated with the creative assets or campaigns, used as a report dimension.	dimension
post_link	post_link	A URL linking to the original social media post.	dimension
publisher	publisher	The media platform or network where the creative asset was published (e.g., Facebook, Instagram).	dimension
purchase_count	purchase_count	The number of purchases attributed to the advertisement.	dimension
purchase_rate	purchase_rate	The rate at which impressions or clicks lead to a purchase.	dimension
reach	reach	The total number of unique users who saw the advertisement.	dimension
report_date	report_date	The date corresponding to the reported performance metrics.	dimension
roas	roas	The revenue generated for every dollar spent on advertising (Return On Ad Spend).	dimension
spend	spend	The total amount of money spent on the advertisement or campaign.	metric
status	status	The current status of the creative asset, post, or report (e.g., ‘DONE’ for a completed report).	dimension
unique_video_3_sec_views	unique_video_3_sec_views	The number of unique users who viewed the video creative for at least 3 seconds.	dimension
video_100_views	video_100_views	The number of times the video creative was viewed to 100% completion.	metric
video_15_sec_views	video_15_sec_views	The number of times the video creative was viewed for at least 15 seconds.	metric
video_25_views	video_25_views	The number of times the video creative was viewed to at least 25% completion.	metric
video_30_sec_views	video_30_sec_views	The number of times the video creative was viewed for at least 30 seconds.	metric
video_3_sec_views	video_3_sec_views	The number of times the video creative was viewed for at least 3 seconds.	metric
video_50_views	video_50_views	The number of times the video creative was viewed to at least 50% completion.	metric
video_75_views	video_75_views	The number of times the video creative was viewed to at least 75% completion.	metric
video_avg_time_watched	video_avg_time_watched	The average amount of time users spent watching the video creative.	dimension
video_length	video_length	The total duration of the video creative asset.	metric
width	width	The width dimension of the creative asset.	metric