AdsGPT

Use 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_compare_periods

Use 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_campaign

Use 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_conversion_action

Use 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_create_negative_keyword_list

Use 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_ad_group

Use 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

Use 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_asset_group

Use 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_dismiss_recommendations

Use 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_forecast_keywords

Use 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_assets

Use 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.

list_accounts

Use 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_list_negative_keyword_lists

Use 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_update_status

Use 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_get_campaign

Use 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_ads

Use 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_campaigns_groups_or_ads

Use 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_extensions

Use 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_keywords

Use 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_labels

Use 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_negative_keywords

Use 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_remove_targeting

Use 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_report

Use 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_research_keywords

Use 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_search_targeting

Use 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_set_targeting

Use 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_conversion_action

Use 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_ad_group

Use 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

Use 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_campaign_settings

Use 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_keywords

Use 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.

google_ads_upload_images