> ## 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 Google Keyword Planner data source to Adriel: authorize a Google account, define a keyword query, and import search-volume research data.

Google Keyword Planner is Google Ads' keyword research tool. Connecting it brings search-volume estimates, competition levels, and top-of-page bid ranges for a defined set of keywords into Adriel dashboards, sourced from the Google Ads Keyword Planner API.

## Before you connect

The following are required:

* A Google account with access to at least one Google Ads account (customer). If the authenticated account has no accessible Google Ads customer, the connection cannot be created.
* Keyword Planner tool access on that Google Ads account. New or inactive accounts may return restricted data.
* The list of keywords to research, plus the target network and countries for the query.

## Connect Google Keyword Planner

<Steps>
  <Step title="Authorize a Google account">
    On the **Data Sources** page, search for **Google Keyword Planner** and select it. Sign in to Google in the pop-up using an account with access to the target Google Ads account, then grant the requested read permission. Google shows the exact scope on the consent screen.
  </Step>

  <Step title="Enter the keywords">
    In the **Keyword** field, enter the keywords to research. Separate multiple values with a colon (`:`). Spaces around each value are disregarded.
  </Step>

  <Step title="Select the network">
    Choose the **Network** from the dropdown. Options are **Google Search** (search traffic only) and **Google Search and Partners** (Google Search plus partner network sites).
  </Step>

  <Step title="Choose the countries">
    Select the target countries under **Country**. Up to 10 countries can be selected per connection. Choose **None** to retrieve data for all locations.
  </Step>

  <Step title="Name the data source and submit">
    Enter a **Name** for the data source, then click **Submit** to complete the connection. The initial query runs in the background and results appear once the first sync finishes.
  </Step>
</Steps>

## What gets imported

The connector imports keyword research indicators for the defined query: average monthly searches, competition level and index, and top-of-page bid ranges (low and high). It does not import delivery metrics — there are no impressions, clicks, cost, or conversions.

For the complete list of metrics, breakdowns, and limits, see the [Google Keyword Planner data reference](/data-sources/g-n/google-keyword-planner/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="The Google account has no accessible customer">
    The connection cannot be created if the authenticated Google account has no accessible Google Ads account. Sign in with an account that has access to at least one Google Ads customer, or request access to one.
  </Accordion>

  <Accordion title="Too many countries selected">
    A maximum of 10 countries can be selected per connection. Reduce the selection to 10 or fewer, or choose **None** to retrieve data for all locations.
  </Accordion>

  <Accordion title="A keyword returns no data">
    Google returns no metrics for keywords it has no data for (for example, some proper nouns). Such keywords are omitted from the results rather than shown as empty rows. Try broader or related keywords.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Google Keyword Planner data reference" href="/data-sources/g-n/google-keyword-planner/data-reference">
    Metrics, breakdowns, and limits for Google Keyword Planner.
  </Card>

  <Card title="Google Keyword Planner FAQs" href="/data-sources/g-n/google-keyword-planner/faqs">
    Common questions and expected behaviors for the Google Keyword Planner data source.
  </Card>

  <Card title="How to connect Google Ads" href="/data-sources/g-n/google-ads/how-to-connect">
    Connect Google Ads campaign performance data.
  </Card>

  <Card title="How to connect Google Trends" href="/data-sources/g-n/google-trends/how-to-connect">
    Connect Google Trends search-interest data.
  </Card>
</CardGroup>