Skip to main content
Instacart Ads is Instacart’s advertising platform, with Sponsored Product, Display (including Shoppable Display), and Video ads. Connecting it brings campaigns, ad groups, keywords, and products into Adriel dashboards, with delivery metrics and Instacart’s attributed sales and units, through the official Instacart Ads API.

​
Before you connect

The following are required:
  • Access to the client’s ad account in Instacart Ads Manager.
  • These permissions for the connecting user in Ads Manager. Account admins can change user permissions in Ads Manager (Instacart Ads Manager docs).
    • API Authentication: Yes
    • Campaign Management: Read
    • Customer Insights Reporting: Read
  • One OAuth application per ad account. One connection covers one ad account and creates one data source. To connect another ad account, create an OAuth application for that account and repeat the steps below.

​
Connect Instacart Ads

1

Create an OAuth application in Instacart Ads Manager

In Instacart Ads Manager, select the client account and go to Settings → OAuth Applications (Instacart Ads Manager docs). Create an OAuth application with this redirect URI:
Keep the application’s Client ID and Client Secret at hand for the next steps.
2

Open the Instacart Ads data source

In Adriel, go to Data Sources and select Instacart Ads. Connection settings opens directly.If the workspace already has an Instacart Ads connection, a Choose connection panel appears first. Click New connection and choose Instacart Ads as the connection type.
3

Enter the application credentials

In Connection settings, enter the application’s Client ID in Client ID and its Client Secret in Client Secret.
4

Authorize the application

Back in Ads Manager, click Authorize on the application. Copy the full URL of the tab that opens, paste it into Authorize URL, then click Submit.
The URL expires after 5 minutes. Do this step right after entering the Client ID and Client Secret.
5

Configure the data source

In Data source settings, choose the Account, select the teamspaces that should use this data source under Add to teamspaces, then click Submit.

​
What gets imported

The connector imports Instacart Ads reporting at the campaign, ad group, keyword, and product (UPC) levels. Delivery metrics include ad spend, impressions, clicks, and video plays. Instacart-specific metrics cover attributed sales, units, halo sales, and, for Sponsored Product, new-to-brand results, each with linear and last-touch attribution. A new connection backfills up to 2 years of data, and data refreshes daily. For the complete list of metrics, breakdowns, attribution details, and limits, see the Instacart Ads data reference.

Instacart Ads data reference

Metrics, breakdowns, attribution, refresh, and limits for Instacart Ads.

Instacart Ads FAQs

Common questions and expected behaviors for the Instacart Ads data source.

Instacart Ads release notes

Recent updates and metric changes for the Instacart Ads data source.

How to connect Criteo Retail Media

Connect another retail media data source.