Skip to content

Google Ads

  1. In AdsGPT, open Plugins and choose Google Ads.
  2. Sign in with the Google account that has access to your Google Ads accounts, and allow AdsGPT to manage them.
  3. Your accounts appear in AdsGPT. Your agent lists them with list_accounts.

google_ads_report reports on any period, in the account’s currency. Among its reports:

Report What it shows
account The account’s totals
campaigns Each campaign, with its Search impression share
ad_groups, ads, keywords Each ad group, ad or keyword
search_terms What people searched before clicking
wasted_spend Search terms that cost money without converting
conversions, conversion_actions The conversions of each campaign, and the actions the account measures
devices, hours, locations, demographics, audiences Performance by device, time, place, age and gender, and audience
landing_pages, placements, asset_performance Landing pages, where Display, Video and Performance Max showed, and how each asset performs
pmax_search_terms, pmax_search_categories, ai_max_search_terms The searches of Performance Max and AI Max
budgets, bidding_strategies, reach Budgets and their pace, shared bid strategies, and unique users and frequency
policy Ads that weren’t approved, and why
recommendations Google’s recommendations, which your agent can apply or dismiss
changes What changed in the last 30 days, with the values before and after

Reports can be filtered by a campaign and broken down by day. To explain a change, your agent compares two periods with google_ads_compare_periods. To look at one campaign’s setup, it reads it with google_ads_get_campaign, and its ads with google_ads_get_ads.

Change Tools
Pause, enable or remove campaigns, ad groups or ads google_ads_update_status, google_ads_remove_campaigns_groups_or_ads
Budgets and bid strategies google_ads_update_budget, google_ads_update_bid_strategy
Campaign and ad group settings google_ads_update_campaign_settings, google_ads_update_ad_group
Ads and Performance Max asset groups google_ads_create_ad, google_ads_update_ad, google_ads_create_asset_group, google_ads_update_asset_group
Keywords and negative keywords google_ads_add_keywords, google_ads_update_keywords, google_ads_remove_keywords, google_ads_add_negative_keywords, negative keyword lists
Keyword ideas and forecasts google_ads_research_keywords, google_ads_forecast_keywords
Targeting: locations, languages, audiences, schedule, devices, demographics, topics and placements google_ads_search_targeting, google_ads_add_targeting, google_ads_set_targeting, google_ads_remove_targeting
Extensions: sitelinks, callouts, structured snippets, calls, business name and logo google_ads_add_extensions, google_ads_remove_extensions
Conversion actions google_ads_create_conversion_action, google_ads_update_conversion_action
Google’s recommendations google_ads_apply_recommendations, google_ads_dismiss_recommendations
Labels google_ads_add_labels, google_ads_remove_labels
Images in the account’s library google_ads_upload_images

Your agent reads the current state first and tells you what will change, from what to what, before asking for your approval. The tools reference lists every tool.

Your agent creates a campaign in one step with google_ads_create_campaign, with its budget, dates, targeting and ads. See Create a campaign.

Objective Campaign types
Awareness Display
Traffic Search, Demand Gen, Display
Engagement Demand Gen
Leads Search, Performance Max, Demand Gen, Display
Sales Search, Performance Max, Demand Gen, Display
App promotion App
  • Search: text ads on Google Search, with keywords, sitelinks, callouts and structured snippets.
  • Performance Max: one campaign across Search, YouTube, Display, Discover, Gmail and Maps. It bids for conversions, so the account must measure them.
  • Demand Gen: image and video ads in the feeds of YouTube, Discover and Gmail, on YouTube and on the Display Network.
  • Display: responsive image ads on the sites and apps of the Google Display Network.
  • App: ads that get installs of your app across Search, Google Play, YouTube, Discover and the Display Network.

Budgets are in the account’s currency, as a total for the campaign’s dates or per day.