Google Ads MCP Tools Reference | HireOtto

​

What HireOtto can do in Google Ads

• Read and report: discover accessible accounts, inspect campaign structure and settings, analyze performance, run audits, review change history, research keywords, and retrieve supported Search Console data.
• Create and update: manage supported campaigns, ad groups, ads, keywords, negative keyword lists, budgets, bidding settings, assets, conversion actions, Performance Max campaigns, and Demand Gen campaigns.
• Audit safely: daily operations, weekly optimization, and account health audits are read-only and available on the Agency plan.
• Verify every write: name the customer ID and affected entities, review the proposed values, approve the change, and read the live setting back after the tool finishes.

​

Account discovery

• Refresh live from Google (useful after being added to new accounts)
• Filter by a specific connected profile / email

Show me all my Google Ads accounts.

Refresh accounts for `[email protected]`.

​

Account hygiene

• Auto-tagging — whether auto-tagging is enabled. HireOtto can also turn it on if it’s off.
• Auto-apply recommendations — which Google recommendations are set to apply automatically. HireOtto can disable them.
• Disapproved ads — any ads currently disapproved, with disapproval reasons.
  • Disapproved-ad review excludes removed ads, ad groups, and campaigns by default, while including paused entities. Set include_removed=true to include removed entities or include_paused=false to exclude paused entities at every level. Results include ad, ad-group, and campaign statuses for easier cleanup decisions.
• Negative keywords — negative keywords at the campaign and ad group level. Optionally filtered to a specific campaign.
• Conversion tracking setup — review conversion tracking status, conversion ownership, linked GA4 property evidence, and GA4 key events that have been imported or may be available to import into Google Ads. This is a read-only check; it does not create conversion actions or install tracking tags.

• Account to audit (required; HireOtto will ask if you have multiple)
• For auto-tagging: whether to apply the fix, or just report
• For auto-apply: whether to disable the subscriptions, or just report
• For negative keywords: optionally filter to a specific campaign

Run a full hygiene audit on account [CUSTOMER_ID].

Check auto-tagging for my account and turn it on if it's off.

Show me all disapproved ads.

Review negative keywords for campaign [CAMPAIGN_ID].

Review the conversion tracking setup for Google Ads account [CUSTOMER_ID]. Check conversion ownership, existing conversion actions, GA4 links, and available GA4 key events. Highlight potential setup gaps without making changes.

​

Discovery & listing

• Campaigns (ID, name, status)
• Ad groups (filterable by campaign)
• Keywords / positive keywords (filterable by campaign or ad group)
• Ads (filterable by campaign, ad group, or ad ID)
• Negative keyword lists (optionally include the keywords inside each list)
• Campaign settings — bidding strategy, geo targeting, networks, ad schedule, devices
• Performance Max asset groups, assets, and signals (see Performance Max section)
• Audiences available in the account (used for PMax audience signals)
• Demand Gen campaign settings — goal, bidding, devices, geo targeting
• Demand Gen ad group settings — channel controls, locations, languages, audiences
• Demand Gen ads and creative asset references
• Dynamic Search Ads (DSA) webpage targets — positive and negative targets, targeting conditions, status, bids, and URL tracking settings.
• DSA domain categories — Google-generated categories for the domain configured on a DSA-enabled Search campaign.
• DSA page feeds — existing page-feed asset sets, linked campaigns, page URLs, custom labels, and asset IDs.
• Ad customizers — attributes, scoped values, responsive search ad references, inline fallbacks, and potential inconsistencies.

List all campaigns in account [CUSTOMER_ID].

Show me the ad groups in campaign [CAMPAIGN_ID].

List all keywords in ad group [ADGROUP_ID].

Show me my negative keyword lists (include the keywords in each list).

What are the current campaign settings for campaign [CAMPAIGN_ID]?

Show me all Demand Gen campaigns in account [CUSTOMER_ID].

Get the channel settings for all Demand Gen ad groups in campaign [CAMPAIGN_ID].

Show me all ads in Demand Gen ad group [ADGROUP_ID].

​

Performance reporting

• Campaign performance
• Ad group performance
• Ad performance
• Keyword performance
• Search terms report
• DSA search terms report — search queries that triggered Dynamic Search Ads, including Google’s generated headlines and selected landing pages.
• DSA page-feed performance — performance broken down by supplied page URLs and custom labels, optionally filtered to a specific page feed.
• Geographic performance
• Device performance
• Impression share (competitive visibility)
• Conversion actions
• Age range performance
• Gender performance
• Extension asset performance

• PMax campaign performance
• PMax campaign placements
• PMax campaign feed types
• PMax asset group performance
• PMax asset group strength (ad strength + action items)
• PMax asset-level performance
• Top asset combinations
• PMax search terms report

• Custom GAQL query — write any read-only SELECT query against the Google Ads API

• Date range: predefined (LAST_7_DAYS, LAST_30_DAYS, LAST_MONTH, THIS_MONTH, etc.) or a custom start/end date
• Filter by campaign or ad group
• Sort by: cost, clicks, impressions, conversions, CTR, average CPC, cost per conversion
• Segment by day
• Output mode: summary (default), summary_and_csv, csv_only
• Inline row limit (default 50)

Show campaign performance for the last 30 days.

Pull keyword performance for campaign [CAMPAIGN_ID] from April 1 to April 30, sorted by cost.

Get the search terms report for last month and export to CSV.

Show device performance for account [CUSTOMER_ID] — last 7 days.

Pull impression share data for last month.

Get PMax asset group strength for all asset groups.

Show extension asset performance for account [CUSTOMER_ID] over the last 30 days.

Show campaign-level sitelink performance for campaign [CAMPAIGN_ID] over the last 30 days.

Show customer-level call asset performance for account [CUSTOMER_ID] this month.

Show Dynamic Search Ads search terms for campaign [CAMPAIGN_ID] over the last 30 days. Include search queries, generated headlines, landing pages, spend, clicks, and conversions.

Compare page-feed performance for campaign [CAMPAIGN_ID] over the last 30 days. Break down results by page URL and custom label, and highlight the strongest and weakest performers.

​

Keyword research

• Keyword ideas — generate new keyword suggestions from seed keywords or a URL
• Historical metrics — get search volume, competition, and bid ranges for keywords you already have

• Seed keywords or a page URL (for ideas)
• Locations (country, region, or city — one or multiple)
• Location mode: aggregated across all locations, or separate results per location
• Language
• Network: Google Search only, or Google Search + partners
• Date range for historical data (default: last 12 complete months)
• Sort by: average monthly searches, competition, bid ranges
• Filter by minimum search volume or competition level (Low / Medium / High)

Generate keyword ideas for "project management software" targeting the US.

Keyword ideas based on this URL: [YOUR_URL] — target UK and Australia separately.

Get historical metrics for these keywords: [KEYWORD_1], [KEYWORD_2], [KEYWORD_3] — US, last 12 months.

Find low-competition keywords related to "accounting software" with at least 500 monthly searches.

​

Campaign creation

​

Search campaigns

• Campaign name and daily budget
• Location and language targeting
• Bidding strategy
• UTM tracking template (applied automatically)
• EU political advertising: doesn’t contain
• Status: paused
• Network targeting: Google search only (no display or partners)
• Location presence targeting: ‘Presence’ not ‘Presence or Interest’

• Maximise clicks (with optional max CPC cap)
• Maximise conversions (with optional target CPA)
• Maximise conversion value (with optional target ROAS)
• Target impression share (requires: location preference, share target, max CPC cap)
• Manual CPC

Create a Search campaign called "[CAMPAIGN_NAME]" with a $[BUDGET]/day budget, targeting [LOCATION], with Maximise Conversions bidding and a target CPA of $[TARGET_CPA].

​

Ad & keyword management

• Requires: ad group, headlines (3–15, max 30 chars each), descriptions (2–4, max 90 chars each), final URL, and optional display URL paths
• Supports headline and description pinning

• Change headlines, descriptions, or display URL paths on an existing ad
• Change ad status (enable, pause, remove)
• update_ad_status supports ENABLED, PAUSED, and REMOVED. Removal uses Google Ads’ remove operation and cannot be undone. Use PAUSED when you may want to reactivate the ad later. Failed API mutations are returned as errors rather than reported as successful changes.

Create a responsive search ad in ad group [ADGROUP_ID] with these headlines: [H1], [H2], [H3] and descriptions: [D1], [D2]. Final URL: [URL].

Pause ad [AD_ID].

Update the headlines on ad [AD_ID] — replace "[OLD_HEADLINE]" with "[NEW_HEADLINE]".

​

Ad customizers

• create_attributes — create customizer attributes of type TEXT, NUMBER, PRICE, or PERCENT.
• set_values — assign values at the account, campaign, ad group, or keyword level.
• remove_values — remove specific values without deleting the attribute.
• remove_attribute — remove an attribute after reviewing its current usage and confirming the removal.

1. Keyword
2. Ad group
3. Campaign
4. Account
5. Inline fallback

• Attribute names and types cannot be changed after creation.
• Updating an existing scoped value replaces its previous association.
• validate_only=true checks a proposed operation without intentionally changing the account. Some replacements cannot be fully validated while an existing value occupies the same resource; review the returned validation notes.
• Removing an attribute requires a preview and confirmation. If active ads still reference it, review their inline fallbacks before approving removal.
• To edit the RSA headline or description containing a customizer reference, use the existing Search Ads creation or update tools.

Review all ad customizers in account [CUSTOMER_ID]. Include their types, scoped values, responsive search ad references, and inline fallbacks. Do not make changes.

Create a PERCENT customizer attribute called “AutoAPR”. Set its account-level value to 6.49% and campaign [CAMPAIGN_ID] value to 5.99%. Validate the changes first.

Find all responsive search ads using the “AutoAPR” customizer. Show their existing inline fallbacks and current values before proposing any updates.

​

Keywords

Add these keywords to ad group [ADGROUP_ID] as exact match: [KW1], [KW2], [KW3].

Add "[KEYWORD]" as a phrase match negative keyword to campaign [CAMPAIGN_ID].

​

Negative keyword lists

Create a negative keyword list called "[LIST_NAME]" with these keywords: [KW1], [KW2].

Assign negative list [LIST_ID] to campaign [CAMPAIGN_ID].

Add "[KEYWORD]" to negative list [LIST_ID].

​

Ad groups

Create an ad group called "[ADGROUP_NAME]" in campaign [CAMPAIGN_ID].

Pause ad group [ADGROUP_ID].

​

Dynamic Search Ads

​

What you can do

• Configure DSA settings on an existing Search campaign, including domain, language, and whether to use only supplied URLs.
• Create dynamic ad groups and Dynamic Search Ads.
• Create positive or negative webpage targets using URL, category, page title, page content, or custom label conditions.
• Discover Google’s suggested domain categories.
• Create and manage page feeds containing URLs and custom labels.
• Attach or detach page feeds from DSA-enabled Search campaigns.
• Review DSA search terms and page-feed performance.

​

DSA page feeds

• create_feed — create a page feed with 1–100 URLs and optional labels. Optionally link it to a campaign.
• add_pages — add new URLs to an existing feed.
• replace_pages — replace URLs or labels on existing page assets.
• remove_pages — unlink selected pages from a feed.
• rename_feed — change the feed name.
• attach_feed — link an existing feed to a campaign.
• detach_feed — unlink a feed from a campaign.
• delete_feed — remove a feed after detaching it from all campaigns.

​

Dynamic ads and webpage targets

• create_dynamic_adgroup — requires a campaign ID and ad group name. Defaults to paused.
• create_dynamic_search_ad — requires an ad group ID and description. A second description is optional. Google generates the headline and landing page. Defaults to paused.
• create_dynamic_target — creates a positive or negative webpage target. Supports up to three conditions combined with AND logic. Positive targets default to paused; negative targets default to enabled.

​

Example prompts

Configure campaign [CAMPAIGN_ID] for Dynamic Search Ads using example.com and English. Show the current and proposed settings before making changes.

Create a DSA page feed called “Service Pages” containing these URLs: [URL_1], [URL_2], [URL_3]. Apply the custom label “Services” and attach it to campaign [CAMPAIGN_ID].

Create a paused dynamic ad group in campaign [CAMPAIGN_ID]. Add a positive webpage target for the “Services” custom label, then create a paused Dynamic Search Ad with these descriptions: [DESCRIPTION_1] and [DESCRIPTION_2].

​

Performance Max campaigns

​

App campaigns

• installs — drive app downloads
• in_app_actions — drive specific in-app events
• in_app_action_value — optimize for conversion value
• engagement_in_app_actions — re-engage existing users
• engagement_in_app_action_value — re-engage users while optimizing for conversion value.
• pre_registration — pre-launch registrations

Create an App Installs campaign called "[CAMPAIGN_NAME]" for app ID [APP_ID] on Google Play, $[BUDGET]/day budget, targeting [LOCATION].

​

App ad groups and ads

​

Create App ad groups

• Standard App campaigns do not support audience list targeting through this action.
• App campaigns for engagement typically require eligible user lists.
• Pre-registration campaigns do not support user-list targeting through this action.
• Engagement ad groups may support a target CPA.

​

Create App ads

• 1–5 headlines, up to 30 characters each.
• 1–5 descriptions, up to 90 characters each.
• Optional existing image, YouTube video, or HTML5 media bundle asset resource names.
• An app URL when required by the campaign subtype.

​

Example prompts

Create an ad group called “Returning Users” in App engagement campaign [CAMPAIGN_ID]. First identify eligible user lists and show the proposed targeting before creating it.

Create a paused App ad in ad group [ADGROUP_ID] using these headlines: [HEADLINES] and descriptions: [DESCRIPTIONS]. Include existing image asset [ASSET_RESOURCE_NAME] and return the new ad ID.

​

Demand Gen campaigns

​

Campaign shell

• Campaign name
• Budget: new daily budget (by amount) or an existing non-shared budget ID
• Campaign goal: Conversions, Clicks, Conversion Value, or YouTube Engagements
• Optional bid targets: target CPA, target ROAS, or target CPC
• Device targeting (all devices eligible by default)
• Geo target type (Presence or Presence or Interest)
• Ad schedule
• Status: Paused by default — review before enabling

Create a Demand Gen campaign called "[CAMPAIGN_NAME]" with a $100/day budget, Maximize Conversions goal, target CPA of $15.

Create a Demand Gen campaign with a $50/day budget targeting mobile and tablet only.

​

Ad groups

• Channel strategy: ALL_CHANNELS (all supported Demand Gen inventory) or ALL_OWNED_AND_OPERATED_CHANNELS (YouTube, Discover, Gmail — no Display)
• Explicit channel selection: YouTube in-stream, in-feed, Shorts, Discover, Gmail, Display, Maps
• Location targeting (human-readable names: “India”, “Mumbai”)
• Language targeting
• Audience targeting (audience resource names — use List Audiences to get these)
• Status: Paused by default

Add a Demand Gen ad group to campaign [CAMPAIGN_ID] — all channels, targeting India, English.

Create a Demand Gen ad group for YouTube Shorts and Discover only — US, English.

​

Assets

• MARKETING_IMAGE — standard landscape image
• SQUARE_MARKETING_IMAGE — square image
• LOGO_IMAGE — brand logo
• YOUTUBE_VIDEO — YouTube video by video ID
• TEXT — standalone text asset
• CALL_TO_ACTION / CTA — supported values include: Apply now, Book now, Contact us, Download, Get quote, Learn more, Shop now, Sign up, Subscribe, Visit site

Create a marketing image asset from [IMAGE_URL] — name it "[ASSET_NAME]".

Create a CTA asset: "Learn more".

​

Ads

• Single image / Multi-asset
• Carousel image
• Video / Video responsive

• Final URLs
• Business name
• Headlines, descriptions, long headlines
• Call to action text
• Image assets: marketing, square, portrait, tall portrait, logo, classic display (by resource name or inline URL)
• Video assets (by resource name or YouTube video ID)
• Carousel cards (inline or by existing card asset resource names)
• Breadcrumbs (carousel)

Create a single image ad in ad group [ADGROUP_ID] — marketing image: [IMAGE_URL], headline: "[HEADLINE]", description: "[DESCRIPTION]", CTA: "Learn more", final URL: [URL].

Create a video ad using YouTube video [VIDEO_ID] — business name: "[BUSINESS_NAME]", headline: "[HEADLINE]", CTA: "Sign up", final URL: [URL].

Create a carousel ad with these cards: [CARD_1_IMAGE_URL] / [CARD_2_IMAGE_URL] — headline: "[HEADLINE]", final URL: [URL].

​

Inspect and update

• get_demand_gen_campaign_settings — campaign goal, bidding, devices, geo settings
• get_demand_gen_ad_group_settings — channel controls, locations, languages, audiences
• get_demand_gen_ads — ads and their creative asset references (optionally include removed ads)

• Campaign name, status, goal, bidding targets
• Budget assignment
• Device targeting, geo target type, ad schedule
• Start and end dates

• Channel strategy or explicit channel selection
• Ad group name and status

• Direct update: change top-level final URLs or supported tracking fields while preserving the ad ID.
• Creative replacement: change images, videos, headlines, descriptions, logos, call-to-action text, or carousel creative. HireOtto creates a replacement ad and pauses the previous ad.

Show me the channel settings for all Demand Gen ad groups in account [CUSTOMER_ID].

Switch ad group [ADGROUP_ID] to YouTube Shorts and Gmail only.

Show me all ads in Demand Gen campaign [CAMPAIGN_ID], including removed ones.

Pause Demand Gen campaign [CAMPAIGN_ID].

​

Extension assets

​

What you can do

• List existing extension assets and see their asset_resource_name
• Create new sitelinks, callouts, structured snippets, call assets, and price assets
• Link an existing asset at the account, campaign, or ad group level
• Reuse the same asset across supported levels
• Unlink an asset association without deleting the underlying reusable asset
• Pull extension asset performance from the reporting tool

​

Supported asset types

• SITELINK
• CALLOUT
• STRUCTURED_SNIPPET
• CALL
• PRICE

​

Example prompts

List all extension assets in account [CUSTOMER_ID]. Include sitelinks, callouts, structured snippets, call assets, and price assets.

Create a sitelink asset in account [CUSTOMER_ID]:
Name: Pricing Sitelink
Link text: View Pricing
Description 1: Compare plans
Description 2: Choose your fit
Final URL: https://example.com/pricing

Link this sitelink asset to campaign [CAMPAIGN_ID]:
customers/[CUSTOMER_ID]/assets/[ASSET_ID]

Reuse this same sitelink asset and link it to ad group [ADGROUP_ID]:
customers/[CUSTOMER_ID]/assets/[ASSET_ID]

Create these callouts in account [CUSTOMER_ID]:
Free setup
No long-term contract
24/7 support
Then link them at the account level.

Unlink this campaign-level sitelink association:
customers/[CUSTOMER_ID]/campaignAssets/[CAMPAIGN_ID]~[ASSET_ID]~SITELINK

​

Campaign settings

• Campaign status (enable / pause)
• Daily budget
• Bidding strategy
• Location and language targeting
• Network settings (Search Partners, Display Network)
• Ad serving optimization
• Campaign start and end dates
• Device and location bid modifiers
• EU political advertising declaration

Pause campaign [CAMPAIGN_ID].

Change the budget for campaign [CAMPAIGN_ID] to $[AMOUNT]/day.

Switch campaign [CAMPAIGN_ID] to Maximise Conversions with a $[TARGET_CPA] target CPA.

Turn off Search Partners for campaign [CAMPAIGN_ID].

Increase mobile bid modifier by 20% for campaign [CAMPAIGN_ID].

​

URL tracking fields

• Tracking template.
• Final URL suffix.
• Account-level custom parameters are not supported.

• Tracking template.
• Final URL suffix.
• Custom parameters.

• Omit a field to leave it unchanged.
• Use an empty string to clear a tracking template or final URL suffix.
• Use an empty object or list to clear custom parameters.
• A custom-parameter update replaces the complete existing set, so include every parameter you want to keep.
• Campaign custom parameters support up to 8 alphanumeric keys.

• The tracking template is invalid or contains unsupported ValueTrack syntax.
• A custom-parameter key contains punctuation or exceeds platform limits.
• An update unintentionally removes parameters because the complete existing set was not included.
• The final URL belongs to a Demand Gen carousel card rather than the ad’s top-level URL.
• The connected user can read the campaign but does not have permission to edit it.

​

Campaign budgets, bidding strategies, and conversions

​

Campaign budgets

• List campaign budgets and see which campaigns use each budget
• Create standalone/non-shared budgets
• Create shared budgets
• Move a campaign to an existing budget
• Create a new dedicated budget and attach it to an existing campaign
• Update budget amount and shareability where Google Ads allows it
• Remove unused budgets safely

• Campaigns cannot have no budget.
• “Detaching” a budget means replacing it with another budget.
• Replacing a campaign’s budget can affect spend/overdelivery behavior. If the goal is only to change spend, update the current budget amount instead.
• Otto does not remove old or unused budgets automatically.

List all campaign budgets in account [CUSTOMER_ID] and show which campaigns use each one.

Create a new standalone daily budget of $25 called "[BUDGET_NAME]" in account [CUSTOMER_ID].

Move campaign [CAMPAIGN_ID] to budget [BUDGET_ID].

Create a new dedicated $50/day budget and attach it to campaign [CAMPAIGN_ID].

Remove unused budget [BUDGET_ID].

​

Bidding strategies

• List portfolio bidding strategies
• Create portfolio bidding strategies
• Attach a campaign to an existing portfolio bidding strategy
• Move a campaign back to standard campaign-level bidding
• Remove unused portfolio bidding strategies safely
• Link an existing portfolio bidding strategy to an existing shared budget
• Attach a campaign to an aligned shared budget + portfolio strategy in one update
• Move a campaign out of an aligned shared-budget + portfolio setup into a new dedicated budget and standard bidding

• Standard bidding: Manual CPC, Target Spend, Maximize Conversions, Maximize Conversion Value, Target Impression Share
• Portfolio bidding: Target Spend, Target CPA, Target ROAS, Maximize Conversions, Maximize Conversion Value, Target Impression Share

• Standard bidding belongs to one campaign and is set directly on the campaign.
• Portfolio bidding is an account-level bidding strategy that can be shared across campaigns.
• Shared budgets and portfolio strategies can be explicitly aligned in Google Ads.
• When alignment exists, budget and bidding changes often need to happen together.
• Otto includes atomic workflows for these aligned shared-budget + portfolio cases.
• Otto does not remove unused portfolio strategies automatically.

List all portfolio bidding strategies in account [CUSTOMER_ID] and show which campaigns use each one.

Create a portfolio Maximize Conversions strategy called "[STRATEGY_NAME]".

Attach campaign [CAMPAIGN_ID] to portfolio bidding strategy [BIDDING_STRATEGY_ID].

Move campaign [CAMPAIGN_ID] to standard Maximize Conversions bidding.

Create a new dedicated $40/day budget for campaign [CAMPAIGN_ID] and move it from portfolio bidding to standard Maximize Conversions in one update.

Link shared budget [BUDGET_ID] to portfolio bidding strategy [BIDDING_STRATEGY_ID].

Attach campaign [CAMPAIGN_ID] to shared budget [BUDGET_ID] and portfolio strategy [BIDDING_STRATEGY_ID] together.

Remove unused portfolio bidding strategy [BIDDING_STRATEGY_ID].

​

Conversion actions

​

Create a native Google Ads conversion action

• WEBPAGE — default.
• UPLOAD_CLICKS.
• UPLOAD_CALLS.

​

Import a GA4 key event

​

Update an existing action

​

Safe sequence

• List the existing actions and check for duplicates.
• Confirm whether the business outcome belongs in Google Ads natively or should be imported from GA4.
• Prepare the exact settings.
• Create, import, or update one action.
• Validate measurement data before making it primary.
• Read the action back and confirm the live settings.

​

Examples

​

Common failures

• A conversion action with the same purpose already exists.
• The GA4 property is not linked to the Google Ads account.
• The GA4 event is not marked as a key event.
• The event name is ambiguous across linked properties and no property ID was provided.
• The requested field is not editable for that action type or origin.
• The connected Google user lacks permission to make the change.
• The tag or offline upload pipeline has not been implemented; creating the action alone does not solve measurement.

​

Conversion goals

​

What you can do

• inspect — show account conversion goals, conversion actions, and optionally a campaign’s effective optimization goals.
• list_customer_goals — list account-default conversion goals and their biddable settings.
• list_campaign_goals — list standard conversion goals for a specific campaign.
• list_custom_goals — list custom goals and their associated conversion actions.

• create_custom_goal — create a custom goal from existing enabled conversion actions.
• update_custom_goal — rename a custom goal or replace its conversion action membership.
• assign_custom_goal — assign a custom goal to a campaign.
• remove_custom_goal — remove a custom goal after checking assignments and confirming removal.

• set_campaign_goal_biddable — enable or disable a standard conversion goal for a campaign.
• set_customer_goal_biddable — change an account-default conversion goal.
• reset_campaign_goals — return a campaign to its account-default conversion goals.

​

How assignment and validation work

• validate_only=true validates a proposed mutation without applying it. The default is false.
• When assigning a custom goal, exclusive=true is the default. It disables the campaign’s standard conversion goals so only the custom goal remains biddable.
• Use exclusive=false to preserve existing standard goal biddability alongside the custom goal.
• Updating a custom goal’s conversion_action_ids replaces the entire action list, not just the specified members.
• Changes to account-default goals may affect multiple campaigns.
• Removing a custom goal requires confirm_removal=true and a review of existing campaign assignments.

​

Recommended workflow

1. Inspect the current account or campaign conversion goals.
2. Identify the exact goals and conversion actions involved.
3. Validate the proposed changes using validate_only=true.
4. Review the current and proposed configuration.
5. Approve and apply the change.
6. Read the live configuration back to confirm the result.

​

Example prompts

Inspect the conversion goals for campaign [CAMPAIGN_ID]. Show the current account-default goals, campaign-specific goals, and custom goals. Do not make changes.

Create a custom conversion goal called “Qualified Leads” using conversion actions [ACTION_ID_1] and [ACTION_ID_2]. Validate it first, then show what will be created without applying the change.

Validate assigning custom goal [GOAL_ID] exclusively to campaign [CAMPAIGN_ID]. Compare the current and proposed optimization goals without changing the bidding strategy.

Enable the standard PURCHASE / WEBSITE conversion goal for campaign [CAMPAIGN_ID]. Preserve its existing custom goal and other enabled goals. Validate first and show the proposed change.

Reset campaign [CAMPAIGN_ID] to account-default conversion goals. Validate first, then apply only after approval and verify the result.

​

Important limitations

• Custom goals can include secondary conversion actions, which may then participate in bidding through that custom goal.
• Changing conversion goals does not automatically change a campaign’s bidding strategy.
• Creating a custom goal does not create conversion events, install tracking tags, or upload offline conversions.
• Customer-acquisition lifecycle goals are not managed by this tool.
• A custom goal should be checked for active campaign assignments before removal.

​

Performance Max

​

Create a PMax campaign

• Headlines (3–15, max 30 chars each)
• Long headline (1, max 90 chars)
• Descriptions (2–5, max 90 chars each)
• Business name
• At least 1 landscape marketing image
• At least 1 square marketing image
• At least 1 logo

• Audience signals and search themes
• Location and language targeting
• Target CPA / target ROAS
• Brand guidelines (locks business name and logos at campaign level, shared across all asset groups)
• EU political advertising declaration

Create a PMax campaign called "[CAMPAIGN_NAME]" with a [BUDGET]/day budget, targeting [LOCATION].
Asset group: [ASSET_GROUP_NAME]
Headlines: [H1], [H2], [H3]
Long headline: [LH1]
Descriptions: [D1], [D2]
Business name: [BUSINESS_NAME]
Landscape image: [IMAGE_URL]
Square image: [SQUARE_IMAGE_URL]
Logo: [LOGO_URL]

​

Add a new asset group

Add a new asset group called "[ASSET_GROUP_NAME]" to PMax campaign [CAMPAIGN_ID].

​

Update asset group status

Pause asset group [ASSET_GROUP_ID].

Enable asset group [ASSET_GROUP_ID].

​

Update assets

Add these headlines to asset group [ASSET_GROUP_ID]: [H1], [H2].

Add a new landscape image to asset group [ASSET_GROUP_ID]: [IMAGE_URL].

Attach existing assets to asset group [ASSET_GROUP_ID]:
Landscape image: customers/[CUSTOMER_ID]/assets/[ASSET_ID]
Square image: customers/[CUSTOMER_ID]/assets/[ASSET_ID]

List assets for asset group [ASSET_GROUP_ID].

Remove the landscape image customers/[CUSTOMER_ID]/assets/[ASSET_ID] from asset group [ASSET_GROUP_ID].

​

List brand assets (brand-guidelines campaigns)

List brand assets for PMax campaign [CAMPAIGN_ID].

​

Manage audience signals and search themes

Add audience [AUDIENCE_ID] as a signal to asset group [ASSET_GROUP_ID].

Add these search themes to asset group [ASSET_GROUP_ID]: [THEME_1], [THEME_2].

List current signals for asset group [ASSET_GROUP_ID].

​

Change history

• Quick scan — which campaigns and ad groups were touched in a given period
• Detailed timeline — field-level change log with timestamps and editor info (last 30 days)

• Date range (required)
• Filter by campaign or ad group
• Output mode: summary, summary_and_csv, csv_only

What changed in account [CUSTOMER_ID] in the last 7 days?

Show me the detailed change history for campaign [CAMPAIGN_ID] over the last 14 days, exported to CSV.

Did anyone make changes to this account last week?

​

Daily ops audit

​

What it checks

• Campaigns that stopped serving even though they are enabled.
• Spend spikes or drops against the recent baseline.
• Campaign and shared-budget pacing.
• Coverage gaps or partial results that may make a finding incomplete.

​

Defaults

• Audit date: yesterday in the Google Ads account time zone.
• Campaign scope: enabled campaigns. Paused campaigns can be included; removed campaigns are excluded.
• Baseline: the previous 14 days.
• Spend spike threshold: at least 1.5 times the baseline.
• Spend drop threshold: at most 0.5 times the baseline.
• Pacing thresholds: above 1.5 times or below 0.5 times expected pacing.
• Minimum baseline activity: 1 unit of account currency in average daily cost and 10 average daily impressions.
• Inline findings: 25 by default; set 1–100.
• CSV link lifetime: 30 minutes by default; set 1–1,440 minutes.

​

What it does not check

​

Example

Run the daily operations audit for customer 123-456-7890 for yesterday. Check enabled campaigns only. Show the most urgent delivery and pacing findings, include the comparison baseline, and do not make changes.

​

Limits and failure cases

• The audit never writes to Google Ads.
• A shared budget is evaluated as a group, so the result may not assign all pacing pressure to one campaign.
• Newly launched or very low-volume campaigns may not have enough baseline activity to classify a spike or drop.
• If Google Ads returns only part of the requested data, treat the audit as partial and review the coverage notes.
• Download links expire. Rerun the audit if a CSV link has expired.

​

Weekly optimization audit

​

Default windows and thresholds

• Performance window: the last 7 days.
• Comparison: the immediately preceding period of equal length.
• Search-term lookback: 30 days, excluding the most recent 3 days to allow for reporting and conversion lag.
• Negative-keyword candidate: fewer than 1 conversion, at least 3 clicks, and no minimum-spend requirement unless you set one.
• New-keyword candidate: at least 1 conversion.
• Keyword review: at least 10 clicks.
• Target CPA: optional. If omitted, HireOtto can use the account CPA when the account has at least 5 conversions in the selected period.
• High-CPA threshold: 1.5 times the target or account CPA.
• RSA review: at least 100 impressions; low CTR is 75% or less of the ad group CTR.
• Campaign performance drop: current conversions at 50% or less of the comparison period.
• Detailed rows: 500 per detailed query by default; set 25–5,000.
• Inline findings: 50 by default; set 1–200.
• CSV link lifetime: 30 minutes by default; set 1–1,440 minutes.

​

What it can surface

• Campaigns with material changes in spend, conversions, CPA, or search impression share.
• Search terms that may belong on a negative list.
• Converting search terms that may deserve their own keyword.
• Manual CPC keywords that may need a bid review.
• Disapproved or low-CTR responsive search ads.
• Findings that need more evidence before a marketer acts.

​

Example

Run the weekly optimization audit for customer 123-456-7890. Compare the last 7 days with the previous 7 days. Use the default search-term lag, rank the findings by severity, and separate Act, Investigate, and Monitor items. Do not change the account.

​

Limits and failure cases

• Candidate means review, not automatic action. Check intent, conversion lag, sample size, match type, lead quality, and business context before approving a change.
• A search-term row can be absent because of Google Ads privacy thresholds or reporting limits.
• If the account has fewer than 5 conversions and no target CPA is supplied, CPA-based classifications may be limited.
• Partial results and row limits appear in the coverage notes. Increase limits or narrow the scope when important entities are missing.
• The audit never writes to Google Ads.

​

Account health audit

​

Defaults

• Review window: the last 90 days.
• Comparison: the immediately preceding 90 days.
• RSA copy review: off by default.
• Detailed checklist: off by default.
• Keyword rows: 5,000 by default; set 100–20,000.
• Ad rows: 1,000 by default when RSA copy review is enabled; set 100–5,000.
• Inline findings: 100 by default; set 1–300.
• CSV link lifetime: 30 minutes by default; set 1–1,440 minutes.

​

What it reviews

• Auto-tagging and conversion-tracking readiness visible in Google Ads.
• Search and display network settings.
• Location targeting mode and language targeting.
• Keyword count by ad group, match-type mix, Quality Score, and Quality Score components.
• Negative-keyword coverage.
• Geographic and device performance.
• Search impression share lost to budget or rank.
• Optional RSA counts, copy review, and pinning patterns.

​

Example

Run an account health audit for customer 123-456-7890. Compare the last 90 days with the previous 90 days. Include the detailed checklist and RSA review. Return the highest-severity risks first and do not make changes.

​

Limits and failure cases

• The audit can only evaluate data available through the connected Google Ads account. It does not know CRM lead quality, competitor activity, landing-page experiments, or offline business context unless you provide that context separately.
• Enabling RSA copy review increases the amount of ad data requested and can make large-account audits slower or more likely to return partial coverage.
• A missing signal is not always a broken setup. Confirm account structure, measurement design, and campaign intent before changing anything.
• Review coverage notes whenever limits, permissions, or Google Ads reporting restrictions exclude part of the account.
• The audit never writes to Google Ads.

​

Google Search Console

Connect my Google Search Console account.

​

What you can do

• List Search Console properties available to your connected Google account
• Pull organic query reports
• Review page performance
• Break down results by country, device, date, hour, or search appearance
• Export Search Console data to CSV
• Check whether a URL is indexed in Google
• List submitted sitemaps

​

Example prompts

Show me the Search Console sites I have access to.

Show me the top organic search queries for the last 28 days. Include a CSV export.

Show me page performance for the last 28 days split by country and device. Give me the top pages inline and export the full data.

Show me organic queries in the US for the last 28 days. I want clicks, impressions, CTR and average position.

Check if https://www.example.com/pricing is indexed in Google.

​

Common access, output, and safety rules

• Account access: HireOtto only sees Google Ads accounts available to the Google identity you connect. The user’s Google Ads role determines whether a write can succeed.
• Customer IDs: use the ten-digit customer ID without guessing. Manager-account access does not remove the need to target the intended client account.
• Audit access: daily operations, weekly optimization, and account health audits are Agency-plan features and are always read-only.
• Search Console: Search Console tools require separate authorization and remain read-only.
• Inline and CSV output: large results may be summarized inline and returned as a downloadable CSV. CSV links expire; rerun the request to create a fresh link.
• Partial coverage: API limits, row limits, permissions, privacy thresholds, and unavailable metrics can produce partial results. Read the coverage notes before acting.
• Validation: Google Ads can reject writes because of account state, entity state, field compatibility, date rules, policy, or permissions. Correct the request and retry only after reviewing the error.
• Verification: for consequential changes, ask HireOtto to show the current value, proposed value, customer ID, and entity IDs; wait for approval; apply one class of change; then read the live value back.
• Pricing and credits: availability and credit use depend on the active HireOtto plan. Check the current pricing page before promising access.

​

Billing

What's my current HireOtto plan and credit balance?