> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect

> How to connect the Instacart Ads data source to Adriel: create an OAuth application in Instacart Ads Manager, enter its credentials, authorize it, and choose the ad account.

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](https://docs.instacart.com/ads_manager/managing_your_account)).
  * **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](https://docs.instacart.com/ads_manager/managing_your_account)). Create an OAuth application with this redirect URI:

```text theme={null}
https://api.adriel.com/api/link/instacartAds/callback
```

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**.

> [!WARNING]
>
> 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](https://docs.adriel.com/data-sources/g-n/instacart-ads/data-reference.md).

## Related

> [card] [Instacart Ads data reference](https://docs.adriel.com/data-sources/g-n/instacart-ads/data-reference.md)
>
> Metrics, breakdowns, attribution, refresh, and limits for Instacart Ads.

> [card] [Instacart Ads FAQs](https://docs.adriel.com/data-sources/g-n/instacart-ads/faqs.md)
>
> Common questions and expected behaviors for the Instacart Ads data source.

> [card] [Instacart Ads release notes](https://docs.adriel.com/data-sources/g-n/instacart-ads/release-notes.md)
>
> Recent updates and metric changes for the Instacart Ads data source.

> [card] [How to connect Criteo Retail Media](https://docs.adriel.com/data-sources/a-f/criteo-retail-media/how-to-connect.md)
>
> Connect another retail media data source.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.