Instacart Ads: Most-used fields

The table below gives information about most-used fields that you can import from Instacart Ads. 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
ad_group.enabled	ad_group.enabled	Indicates whether the ad group is currently enabled or disabled.	dimension
ad_group.id	ad_group.id	The unique identifier of the ad group. Used for filtering reports.	dimension
ad_group.name	ad_group.name	The name of the ad group.	dimension
ad_group.state	ad_group.state	The current operational state of the ad group.	dimension
ad_group.status	ad_group.status	The current operational status of the ad group, indicating whether it is active, paused, or archived.	dimension
ad_name	ad_name	The name or identifier of a specific advertisement within an ad group.	dimension
campaign.budget	campaign.budget	The allocated budget for the advertising campaign.	metric
campaign.enabled	campaign.enabled	A boolean indicator specifying whether the campaign is currently active and eligible to run.	dimension
campaign.id	campaign.id	The unique identifier of the campaign. Used as a column in reports.	dimension
campaign.name	campaign.name	The name of the campaign.	dimension
campaign.objective	campaign.objective	The primary goal or objective of the advertising campaign.	dimension
campaign.optimized_bidding_goal	campaign.optimized_bidding_goal	The specific objective or metric that the campaign’s bidding strategy is optimized to achieve, such as maximizing conversions, clicks, or impressions.	dimension
campaign.starts_at	campaign.starts_at	The timestamp when the advertising campaign is scheduled to start.	dimension
campaign.state	campaign.state	The current operational state of the advertising campaign.	dimension
campaign.status	campaign.status	The current operational status of the campaign, indicating whether it is active, paused, or completed.	dimension
campaign.target_daily_budget	campaign.target_daily_budget	The target amount of money a campaign is set to spend per day.	metric
event.attributed_sales_linear	event.attributed_sales_linear	The total sales amount attributed to ad events using a linear attribution model, where credit is equally distributed across all touchpoints in the customer journey.	metric
event.clicks	event.clicks	The total number of clicks on the advertisement for a specific event.	metric
event.date	event.date	The date when the ad event occurred.	dimension
event.direct_sales_multi_touch_linear	event.direct_sales_multi_touch_linear	Direct sales attributed to ad events using a multi-touch linear attribution model.	metric
event.halo_sales_multi_touch_linear	event.halo_sales_multi_touch_linear	Sales generated from products other than the one advertised, influenced by ad interactions and attributed using a multi-touch linear model. This captures the ‘halo’ effect where ads drive sales for a broader range of a brand’s products.	metric
event.impressions	event.impressions	The total number of impressions for the advertisement for a specific event.	metric
event.ntb_attributed_sales_linear	event.ntb_attributed_sales_linear	Sales from customers identified as ‘New to Brand’ (NTB) that are attributed to ad events using a linear attribution model.	metric
event.ntb_direct_sales_multi_touch_linear	event.ntb_direct_sales_multi_touch_linear	Direct sales of the advertised product to ‘New to Brand’ (NTB) customers, attributed using a multi-touch linear model.	metric
event.ntb_halo_sales_multi_touch_linear	event.ntb_halo_sales_multi_touch_linear	Sales generated from products other than the one advertised, made by ‘New to Brand’ (NTB) customers, influenced by ad interactions and attributed using a multi-touch linear model.	metric
event.spend	event.spend	The advertising spend for a specific event. Used as a column in reports.	metric