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_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
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
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_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
estimated_ad_recall_rate	estimated_ad_recall_rate	The estimated rate at which people remember seeing the advertisement.	metric
height	height	The height, in pixels, of the creative asset, such as an image or video.	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
report_date	report_date	The date corresponding to the reported performance metrics.	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
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_length	video_length	The total duration of the video creative asset.	metric
width	width	The width, in pixels, of the creative asset, such as an image or video.	metric