Shopalyst: Most-used fields

The table below gives information about most-used fields that you can import from Shopalyst. 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
availability	availability	The on-shelf availability status of a product, indicating whether it is in stock or available for purchase.	dimension
brand	brand	The name or identifier of a product’s brand.	dimension
brandCategory	brandCategory	The category associated with a brand, used for categorization and filtering in analytics and reporting.	dimension
brandDivision	brandDivision	The division to which a brand belongs, used for organizational structure and segmentation in analytics.	dimension
categories	categories	A list of categories to which a product belongs.	dimension
code	code	A unique identifier for a product, such as an EAN (European Article Number) or UPC (Universal Product Code), used to retrieve product-specific information and performance metrics within the Shopalyst platform.	metric
competitors	competitors	A list of competitor brands or products used for comparative analysis in various reports like ‘Best Sellers Trending Products’ or ‘Pricing’.	dimension
country	country	The country code (e.g., ‘us’ for USA, ‘in’ for India) relevant to the product data or market analysis.	dimension
createdDate	createdDate	The initial date an item, product, or record was first published or created on the requested channel or platform.	dimension
date	date	The specific date or time period for which the collected data or insights are relevant. This field is commonly used as a filter for retrieving historical data from various insight endpoints like pricing, ratings, or share of search.	dimension
discountPct	discountPct	The percentage of discount applied to a product.	metric
division	division	The product division to which an item belongs (e.g., ‘beauty’, ‘electronics’).	dimension
errorCode	errorCode	A numerical code indicating the specific type of error that occurred during an API request or data processing.	dimension
keyword	keyword	A term or phrase used in search queries, often associated with insights related to ‘Share of Search’ or audience targeting within marketing campaigns.	dimension
keywords	keywords	A collection of words or phrases associated with a product or search context, crucial for product discovery and audience targeting.	dimension
merchant	merchant	The name or identifier of the merchant selling the product, such as ‘amazon’ or ‘walmart’.	dimension
merchantDivisions	merchantDivisions	A collection of product divisions or categories within a merchant’s catalog, often used for best-seller reporting.	dimension
message	message	A descriptive textual message providing additional information about the status of an API request, a process, or an error.	dimension
name	name	The human-readable name of an entity, such as a brand name, merchant division name, product name, or category name.	dimension
offerPrice	offerPrice	The current discounted price or special offer price of the product.	metric
page	page	Refers to a specific page number in paginated results or a type of page where an ad or product is displayed.	dimension
productImage	productImage	The URL of the primary image associated with a product.	dimension
result	result	A container key in the API response that holds the primary data payload or a list of data records for a given request.	dimension
salePrice	salePrice	The Maximum Retail Price (MRP) or original selling price of the product before any discounts.	metric
score	score	A numerical value representing a performance metric or an evaluated rating, such as a product rating, a share metric (e.g., Share of Search, Share of Voice), or another quantitative indicator.	metric
searchKeywords	searchKeywords	Keywords that consumers actively use to search for products, directly impacting product visibility and discovery.	dimension
share	share	The proportion or percentage representing market presence or visibility, such as a product’s ‘Share of Search’ or ‘Share of Voice’.	metric
skuId	skuId	The Stock Keeping Unit identifier, a unique code used to identify a specific product or item, commonly found in product-related reports like ‘Trending Products’ or ‘Pricing’.	dimension
success	success	A boolean indicator (true/false) denoting whether an operation, API request, or data processing task was completed successfully.	dimension
title	title	The main title or name of the product as displayed on the merchant’s website.	dimension
updatedDate	updatedDate	The last date and time when the information or attributes of an item, product, or record were changed or modified.	dimension