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

# Integrations overview

> Connect Google Search Console, Google Analytics 4 and Google Ads to a site and manage the connections.

Integrations bring data from your Google accounts into Perquery. Perquery shows this data next to your AI visibility on the **Search Performance** page.

You can connect these sources:

| Source | What Perquery reads |
| - | - |
| [Google Search Console](https://docs.perquery.ai/en/integrations/google-search-console.md) | The search queries of your website, with impressions, clicks and position. |
| [Google Analytics 4](https://docs.perquery.ai/en/integrations/google-analytics.md) | Sessions, conversions and revenue from AI assistants, organic search and paid channels. |
| [Google Ads](https://docs.perquery.ai/en/integrations/google-ads.md) | The keywords of your campaigns, with impressions, clicks, cost and conversions. |

Each site has its own connections. A connection on one site does not apply to your other sites.

The number of integrations depends on your plan. For the plans, see [perquery.ai/en/pricing](https://perquery.ai/en/pricing).

## Open the Integrations page

In the sidebar, click **Integrations**. The page shows a card for each source. You can also connect a source from the cards on the **Search Performance** page.

## Connect a source

**1. Start the connection**

On the card of the source, click **Connect**. Perquery opens the Google sign-in page.

**2. Give access**

Sign in with the Google account that has access to the data. Read the access that Google shows, and allow it.

**3. Go back to Perquery**

Google sends you back to the **Integrations** page. The page shows **Connected. Choose a property to start importing.**

**4. Select the property**

Under **Property**, select the property, the site or the account that Perquery reads. Click **Save**.

Perquery imports nothing until you select a property. After you save the property, the first import starts.

Perquery only reads data from your Google accounts. It does not change them.

## The state of a connection

The card of each source shows its state.

| State | Meaning |
| - | - |
| **Not connected** | The source is not connected to this site. |
| **Needs a property** | The source is connected, but no property is selected. |
| **Connected** | Perquery imports data from the selected property. |
| **Access expiring** | The Google access expires soon. Connect again to keep the imports. |
| **Sync failed** | The last import failed. |
| **Unavailable** | You cannot connect this source at this time. Contact support. |

## Imports

Perquery imports the data of each connected source once a day. Each import reads the most recent days, up to yesterday. Perquery does not import the older history of the account. The data in Perquery starts near the day that you connect the source.

Below the cards, each connection has a detail card. It shows the selected property and the **Sync history**. Each row of the history shows the result, the number of rows and the number of days.

To start an import now, click **Sync now**. If an import ran a short time ago, Perquery shows **A sync ran recently. Try again shortly.**

## Change the property

> [!WARNING]
>
> When you change the property, Perquery deletes the imported rows. Then it imports from the new property.

In the detail card of the connection, select a different **Property** and click **Save**.

## Fix a failed connection

If the Google access expires or is removed, the card shows **Sync failed**. Perquery sends an email to the owners of the organization.

1. On the card of the source, click **Reconnect**.
2. Sign in with the same Google account and allow the access.

A reconnection keeps the property and the imported data.

If the import failed for a different reason, click **Sync now** in the detail card.

## Disconnect a source

> [!WARNING]
>
> When you disconnect a source, Perquery deletes the imported data and the sync history of the source for this site.

On the card of the source, click **Disconnect**. Perquery also removes its access from your Google account, if no other connection uses that account.

## Permissions

Your role sets what you can do. To connect a source, select a property or start an import, your role must let you create integrations. To disconnect, your role must let you delete integrations. See [Roles and permissions](https://docs.perquery.ai/en/account/roles-and-permissions.md).


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