Skip to main content

​
Introduction

Google Keyword Planner is Google Ads’ keyword research tool. It returns search-volume estimates, competition levels, and bid-range suggestions for a set of seed keywords, sourced from Google’s search query data. This connector queries the Google Ads Keyword Planner API on behalf of a connected Google Ads account and stores the results in a per-asset cache for reporting in Adriel widgets. Unlike ad-platform reporting connectors, Keyword Planner returns market-research indicators rather than delivery metrics — there is no spend, click, or conversion data. Metrics are best suited to research widgets and content-planning dashboards. To connect this data source, see How to connect Google Keyword Planner to Adriel.

​
Data refresh strategy

​
Architecture data

This connector does not import a campaign hierarchy. Each Adriel asset represents one Keyword Planner query configuration (seed keywords, target location, network, and timeframe).

​
Reports data

Adriel re-queries the Google Ads Keyword Planner API on a scheduled cadence and stores the returned rows in the per-asset Postgres cache table GKP_{assetId}. Refresh schedule. Daily at a fixed UTC hour (pending tech reviewer confirmation). Refresh strategy. The cache is rewritten in full on each successful run.

​
Metrics

How to read the columnsData type uses this vocabulary: Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean.API Key in code style is the literal Google Ads API field name from the Keyword Planner service.

​
Keywords

​
Search volume

​
Competition

​
Bid estimates

​
Breakdowns

​
Keyword & targeting

​
Time & grouping

Adriel-provided breakdowns are produced by Adriel from the returned data rather than by the Keyword Planner API.

​
Limitations

  • Search-volume estimates. Keyword Planner returns estimated monthly searches; for lower-volume keywords these are presented as ranges rather than exact counts.
  • No delivery metrics. Keyword Planner returns market indicators only — there are no impressions, clicks, cost, or conversion metrics from this connector.
  • Bid ranges, not average CPCs. Bid values are top-of-page bid ranges (low / high), not observed CPCs from live campaigns.
  • Account eligibility. The connected Google Ads account must have access to the Keyword Planner tool; new or inactive accounts may return restricted data.
  • Timeframe granularity. Search-volume data is aggregated at the monthly level; sub-monthly trends are not available.

​
API references

​
See also