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	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.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.starts_at	campaign.starts_at	The date and time when the campaign is scheduled to begin.	dimension
campaign.status	campaign.status	This field indicates the current operational state of the advertising campaign, such as whether it is active, paused, scheduled, out of budget, or ended.	dimension
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.ntb_attributed_sales_linear	event.ntb_attributed_sales_linear	Sales attributed to new-to-brand (NTB) customers using a linear attribution model, where credit is equally distributed across all ad interactions in the conversion path.	metric
event.percent_ntb_sales_last_touch	event.percent_ntb_sales_last_touch	The percentage of total sales that are attributed to new-to-brand (NTB) customers, based on a last-touch attribution model.	metric
event.percent_ntb_sales_linear	event.percent_ntb_sales_linear	The percentage of total sales that are attributed to new-to-brand (NTB) customers, based on a linear attribution model.	metric
event.spend	event.spend	The advertising spend for a specific event. Used as a column in reports.	metric
product.enabled	product.enabled	Indicates whether the product is currently enabled and eligible to be advertised.	dimension
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.	dimension
product.image_url	product.image_url	The URL of the image associated with the product.	dimension
product.name	product.name	The name of the product being advertised.	dimension
product.product_id	product.product_id	A unique identifier for the product.	dimension
product.size	product.size	The numerical amount of a unit within a product’s pack, often used in conjunction with a unit of measure. For example, for a ‘12 fl oz soda can’, this field would contain ‘12’. This can also be part of product variant specifications like different sizes for a product.	dimension
product.status	product.status	The current status of the product, indicating its availability or advertising eligibility.	dimension