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.bid	ad_group.bid	The bid amount set for the ad group. This represents the general bid amount for ad placements within the ad group.	metric
ad_group.creative_type	ad_group.creative_type		dimension
ad_group.enabled	ad_group.enabled	Indicates whether the ad group is currently enabled and active, allowing ads within it to run.	dimension
ad_group.id	ad_group.id	The unique identifier for the ad group.	dimension
ad_group.name	ad_group.name	The name assigned to the ad group.	dimension
ad_group.state	ad_group.state	The current operational status or state of the ad group.	dimension
campaign.budget	campaign.budget	This field represents the total budget allocated for the advertising campaign. When the campaign’s spend reaches this amount, the campaign becomes inactive.	metric
campaign.enabled	campaign.enabled	Indicates whether the campaign is currently enabled and active, allowing its ad groups and ads to run.	dimension
campaign.ends_at	campaign.ends_at	The date and time when the campaign is scheduled to end.	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		dimension
campaign.pacing_type	campaign.pacing_type		dimension
campaign.payment_type	campaign.payment_type		dimension
campaign.starts_at	campaign.starts_at	The date and time when the campaign is scheduled to begin.	dimension
campaign.state	campaign.state	The current operational status of the advertising campaign, such as active, paused, scheduled, out of budget, or ended.	dimension
event.attributed_units_last_touch	event.attributed_units_last_touch	The total number of units sold attributed to an ad campaign where the last customer interaction with an ad received full credit for the conversion.	metric
event.attributed_units_linear	event.attributed_units_linear	The number of units sold attributed to an ad campaign using a linear attribution model. Instacart Ads API reporting primarily uses linear attribution for sales reporting.	metric
event.clicks	event.clicks	The total number of clicks on the advertisement for a specific event.	metric
event.cpm	event.cpm	The cost per thousand impressions (CPM) for the advertisement.	metric
event.ctr	event.ctr	The click-through rate (CTR) for the advertisement, calculated as clicks divided by impressions.	metric
event.date	event.date	The date when the ad event occurred.	dimension
event.direct_roas_last_touch	event.direct_roas_last_touch	The return on ad spend (ROAS) from direct sales attributed to an ad campaign using a last-touch attribution model.	metric
event.direct_roas_multi_touch_linear	event.direct_roas_multi_touch_linear	The return on ad spend (ROAS) from direct sales attributed to an ad campaign using a multi-touch linear attribution model.	metric
event.direct_sales_last_touch	event.direct_sales_last_touch	The total sales amount directly attributed to an ad campaign where the last customer interaction with an ad received full credit for the conversion.	metric
event.direct_sales_multi_touch_linear	event.direct_sales_multi_touch_linear	The total sales amount directly attributed to an ad campaign using a linear attribution model.	metric
event.halo_roas_last_touch	event.halo_roas_last_touch	The return on ad spend (ROAS) from ‘halo’ sales (sales beyond the directly advertised product but within the same brand) attributed to an ad campaign using a last-touch attribution model.	metric
event.halo_roas_multi_touch_linear	event.halo_roas_multi_touch_linear	The return on ad spend (ROAS) from ‘halo’ sales (sales beyond the directly advertised product but within the same brand) attributed to an ad campaign using a multi-touch linear attribution model.	metric
event.halo_sales_last_touch	event.halo_sales_last_touch	The total sales amount from ‘halo’ sales (sales beyond the directly advertised product but within the same brand) attributed to an ad campaign using a last-touch attribution model.	metric
event.halo_sales_multi_touch_linear	event.halo_sales_multi_touch_linear	The total sales amount from ‘halo’ sales (sales beyond the directly advertised product but within the same brand) attributed to an ad campaign using a multi-touch linear attribution model.	metric
event.impressions	event.impressions	The total number of impressions for the advertisement for a specific event.	metric
event.ntb_direct_sales_last_touch	event.ntb_direct_sales_last_touch	The dollar amount of direct sales attributed to an ad campaign from consumers who have not purchased any products from the overall brand in the last 26 weeks, using a last-touch attribution model.	metric
event.ntb_direct_sales_multi_touch_linear	event.ntb_direct_sales_multi_touch_linear	The dollar amount of direct sales attributed to an ad campaign from consumers who have not purchased any products from the overall brand in the last 26 weeks, using a linear attribution model.	metric
event.ntb_halo_sales_last_touch	event.ntb_halo_sales_last_touch	The total sales amount from ‘halo’ sales (sales beyond the directly advertised product but within the same brand) attributed to an ad campaign from new-to-brand consumers, using a last-touch attribution model.	metric
event.ntb_halo_sales_multi_touch_linear	event.ntb_halo_sales_multi_touch_linear	The total sales amount from ‘halo’ sales (sales beyond the directly advertised product but within the same brand) attributed to an ad campaign from new-to-brand consumers, using a multi-touch linear attribution model.	metric
event.percent_ntb_direct_sales_last_touch	event.percent_ntb_direct_sales_last_touch	The percentage of total direct sales that are attributed to new-to-brand (NTB) customers, based on a last-touch attribution model.	metric
event.percent_ntb_direct_sales_multi_touch_linear	event.percent_ntb_direct_sales_multi_touch_linear	The percentage of total direct sales that are attributed to new-to-brand (NTB) customers, based on a linear attribution model.	metric
event.percent_ntb_halo_sales_last_touch	event.percent_ntb_halo_sales_last_touch	The percentage of total ‘halo’ sales (sales beyond the directly advertised product but within the same brand) that are attributed to new-to-brand (NTB) customers, based on a last-touch attribution model.	metric
event.percent_ntb_halo_sales_multi_touch_linear	event.percent_ntb_halo_sales_multi_touch_linear	The percentage of total ‘halo’ sales (sales beyond the directly advertised product but within the same brand) that are attributed to new-to-brand (NTB) customers, based on a multi-touch linear attribution model.	metric
event.spend	event.spend	The advertising spend for a specific event. Used as a column in reports.	metric
keyword.name	keyword.name	The name or text of the keyword used for targeting in an advertising campaign.	dimension