google_ads_add_extensions
ChatGPTUse this when the user wants to add extensions to a Google Ads campaign, an ad group or the whole account: sitelinks, callouts, structured snippets, a phone number, the business name and a square logo by its asset id. Skips what is already there (a retry adds nothing twice), a sitelink off the ads' domain and a logo that is not square. Returns what was added, skipped and rejected, with the reason.
google_ads_add_keywords
ChatGPTUse this to add keywords to a Google Ads search ad group, each with its match type and optional max CPC (cost per click) and final URL. Skips existing ones, so a retry adds nothing twice. Returns those added, skipped and rejected, with the reason.
google_ads_add_labels
ChatGPTUse this to add a label to Google Ads campaigns, ad groups or ads, creating the label when the account has none with that name. Labels organize and filter; they change nothing of how the resource serves. Skips what already has it, so a retry adds nothing twice. Returns what was labeled and what was skipped.
google_ads_add_negative_keywords
ChatGPTUse this to stop a Google Ads campaign, or every campaign using a shared negative keyword list, from showing ads for some searches, by adding negative keywords to it. Skips those already there, so a retry adds nothing twice. Returns what was added, skipped and rejected.
google_ads_add_targeting
ChatGPTUse this when the user wants to add targeting to a Google Ads campaign or ad group: locations by name or id, included or excluded, a radius and languages on a campaign (on a Demand Gen ad group: locations and languages only); interests, remarketing lists and custom audiences on either, by the ids google_ads_search_targeting finds (a Demand Gen ad group takes them in google_ads_update_ad_group's audience); topics on a Display ad group (a campaign only excludes them); sites, apps and YouTube videos or channels to show on (Display ad group) or to exclude. It changes where live ads show. Skips what is already there and what does not apply. Returns what was added, skipped and rejected.
google_ads_apply_recommendations
ChatGPTUse this to apply Google's recommendations on Google Ads, by the ids of the recommendations report: budgets (Google's amount or the one given), keywords, search partners, Display expansion and bid strategies with Google's target; live campaigns and their spend change. Skips the types that need content, naming the tool that writes it. Returns what was applied, with the budget or target set.
google_ads_attach_negative_keyword_list
ChatGPTUse this to apply a shared Google Ads negative keyword list to campaigns, so they stop showing ads for its keywords. Skips campaigns that already use it (a retry repeats nothing). Returns the campaigns that got it.
google_ads_compare_periods
ChatGPTUse this when the user asks why a Google Ads account or campaign changed. Compares a period with the one before, by default the last 7 days with the 7 before: both periods with the change of each metric in percent, the campaigns, devices and networks whose cost moved the most, each day, the changes made meanwhile (with the values before and after) and the status reasons. Read only.
google_ads_create_ad
ChatGPTUse this to create an ad in an existing Google Ads ad group, of the type its campaign takes: responsive_search, responsive_display, demand_gen_image or demand_gen_video. Images and logos are asset ids from google_ads_list_assets or public URLs, which it adds to the account's library first, linked by shape; YouTube videos are linked or registered. Drops repeated texts and checks Google's limits first. A retry creates another ad. Returns the new ad's id and what was dropped.
google_ads_create_ad_group
ChatGPTUse this when the user wants a new ad group in an existing Google Ads campaign, created with its first ad, all or none: search (keywords and a responsive search ad), display (a responsive display ad) or demand_gen (channels, an image or video ad and optionally its audience; it copies the locations and languages its campaign's other ad groups share). Images and logos are asset ids from google_ads_list_assets or public URLs, which it adds to the account's library first. Checks the campaign's type and refuses a name the campaign uses. Returns the new ad group id.
google_ads_create_asset_group
ChatGPTUse this when the user wants a new asset group in a Google Ads Performance Max campaign, with its texts, images, logos, videos, search themes and audience signal, all or none. Images and logos are asset ids from google_ads_list_assets or public URLs, which it adds to the account's library first. Checks the minimums and image shapes, and refuses a name the campaign uses. Returns the new asset group's id.
google_ads_create_campaign
ChatGPTUse this when the user wants a new Google Ads campaign: search, performance_max, display, demand_gen or app, created with its budget, dates, targeting and ads in one call, all or none. Images and logos are asset ids from google_ads_list_assets or public URLs, which it adds to the account's library first; videos are YouTube links. Refuses a name another campaign of the account uses. Returns the campaign as Google confirmed it, or the issues found, creating nothing. A call that fails leaves only the images it added to the library; calling again with the same name after a success is refused.
google_ads_create_conversion_action
ChatGPTUse this when the user wants to track a web page conversion on Google Ads: creates the conversion action with its category, counting, default value and windows (app, call and import actions are created in Google Ads). Refuses a name the account uses. Returns the site tag and event snippet to install: it measures nothing until then.
google_ads_create_negative_keyword_list
ChatGPTUse this when the user wants a new shared Google Ads negative keyword list with its keywords, optionally applied to campaigns, all at once. Refuses a name the account already uses, naming that list (google_ads_add_negative_keywords adds keywords to it). Returns the new list's id.
google_ads_dismiss_recommendations
ChatGPTUse this to dismiss Google's recommendations on Google Ads, by the ids of the recommendations report, so they stop showing. Changes no campaign. Returns what was dismissed.
google_ads_forecast_keywords
ChatGPTUse this when the user wants an estimate of what some keywords would bring. Forecasts with Google Ads Keyword Planner, for a max CPC (cost per click) and, optionally, a daily budget, over the coming days: clicks, cost, average CPC and, when the account has a conversion rate, conversions and their cost. An estimate by Google for a campaign it does not create, not a result. Read only.
google_ads_get_ads
ChatGPTUse this to read the content or approval of Google Ads ads, such as before changing them. Reads the ads of a campaign, an ad group, or up to 50 by id, whatever their type: status, approval with the policy topics of a rejection, ad strength, headlines and descriptions with their pinning, display paths, final URLs, images and logos (asset id, URL and size), videos (YouTube id) and call to action. Read only. Its ad ids are the ones google_ads_update_ad and google_ads_update_status take.
google_ads_get_campaign
ChatGPTUse this to look up one Google Ads campaign, by id or name, to answer about its setup or get the ids a change needs. Reads its type, status and why it serves or not, and the sections asked for: structure (ad groups with ids, status, bid and counts), bidding (strategy, target, budget, conversion goals), keywords (ids, match type, status, max cost per click), negative keywords, ads (texts, final URLs, approval), extensions, targeting and Performance Max asset groups. Read only. Its ids are the ones the other google_ads_* tools take; google_ads_get_ads has the full content of ads, with images and policy topics.
google_ads_list_assets
ChatGPTUse this to see the images and YouTube videos of a Google Ads account's library, which campaigns can show without uploading them again. Lists them newest first: each image with its id, URL and size, and its aspect ratio (1.91:1 or 1:1) when it has the shape and the size the ads take; an image without one can still be a logo. Each video with its id and YouTube id. Images too small for an ad or a logo are left out. logos has every logo the account and its campaigns use, unpaginated. Read only. Returns up to limit images and videos; when truncated, call again with the smallest id returned as before for the next ones.
google_ads_list_negative_keyword_lists
ChatGPTUse this to see the shared negative keyword lists of a Google Ads account. Lists each with its keywords, by the criterion ids google_ads_remove_negative_keywords takes, and the campaigns that use it. Read only.
google_ads_remove_campaigns_groups_or_ads
ChatGPTUse this when the user wants to delete Google Ads campaigns, ad groups, asset groups or ads of one level for good, by their ids: all of them or none. It cannot be undone, though their history stays in the reports. Skips ids already removed. Returns what was removed and what was skipped.
google_ads_remove_extensions
ChatGPTUse this when the user wants to unlink extensions on Google Ads, by the ids google_ads_get_campaign lists in its extensions section: live ads stop showing them, and the assets stay in the account's library. Skips an id that is not linked. Returns what was removed.
google_ads_remove_keywords
ChatGPTUse this when the user wants to delete keywords of one Google Ads ad group for good, by their ids. It cannot be undone. Ids of another ad group are skipped. Returns the keywords removed and those skipped.
google_ads_remove_labels
ChatGPTUse this to take a label off Google Ads campaigns, ad groups or ads. The label stays in the account. Labels organize and filter; they change nothing of how the resource serves. Skips what does not have it, so a retry repeats nothing. Returns what was unlabeled and what was skipped.
google_ads_remove_negative_keywords
ChatGPTUse this when the user wants searches a Google Ads campaign or shared negative keyword list blocks to show ads again: removes those negative keywords by the criterion ids google_ads_get_campaign lists in its negative_keywords section. Skips an id the campaign or list does not have. Returns what was removed.
google_ads_remove_targeting
ChatGPTUse this when the user wants to remove targeting criteria of Google Ads campaigns or ad groups, by the ids the targeting section of google_ads_get_campaign lists: locations, radius, languages, schedule, audiences, demographics, topics, placements. Live ads may reach more people. It does not remove keywords, and keeps the last location of a campaign (or of a Demand Gen ad group) unless the user wants it worldwide. Returns what was removed.
google_ads_report
ChatGPTUse this when the user asks how a Google Ads account or campaign performed in a period, or for its budgets, bid strategies, reach, ads not approved, Google's recommendations or changes made. Reports performance by account, campaign, ad group, ad, keyword (with ids, quality score and the bids Google estimates for the first page), search term, device, hour, location, demographic, audience, landing page, placement, asset or conversion action, each row with impressions, clicks, CTR (click-through rate), cost, average CPC (cost per click), conversions and cost per conversion in the account currency, sorted by cost. Removed campaigns, ad groups, ads and conversion actions are left out unless includeRemoved. Read only. Uses GAQL (Google Ads Query Language): https://developers.google.com/google-ads/api/docs/query/overview
google_ads_research_keywords
ChatGPTUse this when the user wants keyword ideas or search volumes. Finds them with Google Ads Keyword Planner, from seed keywords, a page of the business, or both, for some locations and a language: each with its average monthly searches, competition, top-of-page CPC (cost per click) range in the account currency and recent months. Read only; creates nothing. Says what it filtered when few ideas come back.
google_ads_search_targeting
ChatGPTUse this to find, by text, the Google Ads targeting the user names, with the ids google_ads_add_targeting takes: locations (by name in any language, with their reach), languages, interests (in-market and affinity), the account's remarketing lists with their size, its custom audiences, and Display topics. Read only.
google_ads_set_targeting
ChatGPTUse this when the user wants to replace whole targeting sets of a Google Ads campaign or ad group: the ad schedule of a campaign, bid adjustments per device, and the demographic segments of an ad group (the ones left out are excluded). The previous set is overwritten; calling it again changes nothing. Returns what changed and the time zone of the schedule.
google_ads_update_ad
ChatGPTUse this when the user wants to edit a Google Ads responsive search ad in place, keeping its id and statistics: its headlines or descriptions (a list given replaces that list), display paths or final URL on the same domain. Google reviews the ad again. Returns each field before and after.
google_ads_update_ad_group
ChatGPTUse this when the user wants to change the settings of a Google Ads ad group: name, default max CPC (cost per click; manual CPC bidding only), ad rotation, final URL suffix, audience mode (observation or targeting), optimized targeting and, for Demand Gen, the channels it shows on and its audience (interests, lists and custom audiences by the ids google_ads_search_targeting finds, ages, genders). What is left out stays. Returns each setting before and after.
google_ads_update_asset_group
ChatGPTUse this when the user wants to change a Google Ads Performance Max asset group: adds and removes texts, images, logos, videos (images and logos by their asset ids from google_ads_list_assets or by public URLs, added to the account's library first) and search themes in one call, replaces its audience signal, renames it or changes its landing page. Removed assets stay in the library. Refuses going under a minimum or over a maximum, and skips what it already has. Returns what changed and what was skipped.
google_ads_update_bid_strategy
ChatGPTUse this to change a Google Ads campaign's bid strategy and its target: maximize clicks (with a CPC, cost per click, ceiling), maximize conversions (with a target CPA, cost per acquisition), maximize conversion value (with a target ROAS, return on ad spend), target impression share, manual CPC, or manual CPM on Display. Refuses what the campaign cannot take. Returns the strategy before and after, and a warning when a target has little conversion data.
google_ads_update_budget
ChatGPTUse this when the user wants to change the amount of a Google Ads campaign's budget: per day for a daily budget, for the whole dates for a total one, which stays a total. A budget other campaigns share is not changed. Returns the amount before and after, in the account's currency.
google_ads_update_campaign_settings
ChatGPTUse this when the user wants to change a Google Ads campaign's settings other than budget and bidding: name, start and end dates, networks, location presence, tracking template, final URL suffix and custom parameters, AI Max, frequency cap and conversion goals (what it bids for). Skips what Google would refuse or ignore. Returns each setting before and after.
google_ads_update_conversion_action
ChatGPTUse this when the user wants to change a Google Ads conversion action, by id (from the conversion_actions report of google_ads_report) or by name: name, category, counting, value, windows, primary and status. Setting it removed is permanent. Skips what the API cannot change for that action, saying where to change it. Returns each setting before and after.
google_ads_update_keywords
ChatGPTUse this to change the max CPC (cost per click) or the final URL of Google Ads keywords, by their ids: all of them or none. A max CPC only applies with manual CPC bidding. It does not pause or enable keywords. Returns each keyword before and after.
google_ads_update_status
ChatGPTUse this to pause or enable Google Ads campaigns, ad groups, asset groups, ads, keywords or extensions of one level, by their ids: all of them or none. Pausing stops their ads and spend until enabled again. Returns the ids that changed and their new status.
google_ads_upload_images
ChatGPTUse this when the user wants images or a logo in a Google Ads account's library, such as the image of an extension, which takes asset ids. Adds them as image assets and returns each asset id: images for the ads, 1.91:1, 1:1 or 4:5, and the brand's logo. It reads each image from its public URL and converts a format Google Ads does not take, such as WebP or SVG; a logo that is not square is fit whole in a square. When any image cannot be used, it uploads nothing and lists each issue. It changes no campaign; a retry uploads the images again.
list_accounts
ChatGPTUse this when another tool needs an account id, and when the user asks which accounts or ad platforms AdsGPT works with. Lists the ad accounts the organization connected and the member may operate, by platform: the account id the other tools take, the id on the platform, the currency and the time zone, with today's date in it. An account with manager groups other accounts and has no campaigns or metrics of its own. Also names the ad platforms the organization can still connect, from the Plugins screen of AdsGPT, and the ones coming soon, which cannot be connected yet. Read only.