PromoteIQ: Most-used fields

The table below gives information about most-used fields that you can import from PromoteIQ. 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
Campaign ID	Campaign ID	A unique identifier assigned to each advertising campaign.	metric
Campaign Name	Campaign Name	The user-defined name for an advertising campaign.	dimension
Category Taxonomy	Category Taxonomy	The hierarchical classification path for the product being promoted, organizing products into categories and subcategories.	dimension
Clicks	Clicks	The total number of times an ad was clicked by users.	metric
Date	Date	The specific date when the reported advertising activity occurred.	dimension
Impressions	Impressions	The total number of times an ad was displayed to users.	metric
Placement Name	Placement Name	The specific name of the location or area on a retailer’s website or app where the advertisement was displayed.	dimension
Placement Type	Placement Type	The classification of the ad placement, indicating the general kind of advertising space used (e.g., sponsored product, banner ad, search result).	dimension
PromoteIQ Vendor ID	PromoteIQ Vendor ID	A unique identifier assigned to a vendor within the PromoteIQ platform.	metric
Promoted Product / Creative	Promoted Product / Creative	The name or description of the product or specific advertisement (creative) that was promoted.	dimension
Promoted Product / Creative ID	Promoted Product / Creative ID	A unique identifier assigned to the specific product or creative asset that was promoted.	metric
Promoted SKU	Promoted SKU	The Stock Keeping Unit (SKU) of the specific product being advertised.	metric
SKU Order Count	SKU Order Count	The total number of orders for a specific Stock Keeping Unit (SKU) associated with the promoted product or creative.	metric
Spend	Spend	The total amount of money spent on the advertising campaign or specific ad activity.	metric
Total Sales	Total Sales	The total revenue generated from sales attributed to the advertising campaign.	metric
Units Sold	Units Sold	The total number of product units sold that are attributed to the advertising campaign.	metric
Vendor Name	Vendor Name	The name of the vendor associated with the promoted products or campaigns.	dimension
campaign id	campaign id	A unique identifier assigned to each advertising campaign.	metric
campaign name	campaign name	The user-defined name for an advertising campaign.	dimension
category taxonomy	category taxonomy	The hierarchical classification path for the product being promoted, organizing products into categories and subcategories.	dimension
clicks	clicks	The total number of times an ad was clicked by users.	metric
date	date	The specific date when the reported advertising activity occurred.	dimension
impressions	impressions	The total number of times an ad was displayed to users.	metric
placement name	placement name	The specific name of the location or area on a retailer’s website or app where the advertisement was displayed.	dimension
placement type	placement type	The classification of the ad placement, indicating the general kind of advertising space used (e.g., sponsored product, banner ad, search result).	dimension
promoted product / creative	promoted product / creative	The name or description of the product or specific advertisement (creative) that was promoted.	dimension
promoted product / creative id	promoted product / creative id	A unique identifier assigned to the specific product or creative asset that was promoted.	metric
promoted sku	promoted sku	The Stock Keeping Unit (SKU) of the specific product being advertised.	metric
promoteiq vendor id	promoteiq vendor id	A unique identifier assigned to a vendor within the PromoteIQ platform.	metric
sku order count	sku order count	The total number of orders for a specific Stock Keeping Unit (SKU) associated with the promoted product or creative.	metric
spend	spend	The total amount of money spent on the advertising campaign or specific ad activity.	metric
total sales	total sales	The total revenue generated from sales attributed to the advertising campaign.	metric
units sold	units sold	The total number of product units sold that are attributed to the advertising campaign.	metric
vendor name	vendor name	The name of the vendor associated with the promoted products or campaigns.	dimension