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.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
campaign.budget	campaign.budget	The allocated budget for the advertising campaign.	metric
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.pacing_type	campaign.pacing_type		dimension
campaign.payment_type	campaign.payment_type		dimension
campaign.status	campaign.status	The current operational status of the campaign, indicating whether it is active, paused, or completed.	dimension
event.2_second_views	event.2_second_views	The number of times a video ad has been viewed for at least 2 continuous seconds, with 50% of the video player on the screen.	metric
event.attributed_sales_last_touch	event.attributed_sales_last_touch	The total sales amount attributed to an ad campaign where the last customer interaction with an ad received full credit for the conversion. Instacart Ads historically used last touch attribution for sales reporting.	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.attributed_units_last_touch	event.attributed_units_last_touch	The number of units sold attributed to an ad campaign using a last-touch attribution model, where the last ad interaction receives full credit for the conversion. This aligns with historical attribution reporting by Instacart Ads.	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.date	event.date	The date when the ad event occurred.	dimension
event.impressions	event.impressions	The total number of impressions for the advertisement for a specific event.	metric
event.ntb_attributed_sales_last_touch	event.ntb_attributed_sales_last_touch	The dollar amount of 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. These New-to-Brand metrics are available through the API.	metric
event.percent_ntb_attributed_sales_last_touch	event.percent_ntb_attributed_sales_last_touch	The percentage of attributed sales that came from consumers who have not purchased any products from the overall brand in the last 26 weeks, using a last-touch attribution model. These New-to-Brand metrics are available through the API.	metric
event.spend	event.spend	The advertising spend for a specific event. Used as a column in reports.	metric
product.id	product.id	A unique identifier for a product. This ID is used in various event tracking contexts for sponsored products, display items, and brand pages.	metric
product.name	product.name		dimension
product.size	product.size		dimension
product.status	product.status		dimension