Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.hireotto.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authentication

Connect a Google Ads account to HireOtto. Options
  • Connect your default Google login
  • Connect additional Google logins with a nickname (e.g., agency_mcc)
Example prompts 
Connect my Google Ads account.

Connect another Google account. Call it "agency_mcc".
→ See the Authentication guide for the full setup walkthrough.

​
Account discovery

List all Google Ads accounts accessible to your connected Google login(s). Options
  • Refresh live from Google (useful after being added to new accounts)
  • Filter by a specific connected profile / email
Example prompts 
Show me all my Google Ads accounts.

Refresh accounts for `[email protected]`.

​
Account hygiene

Four point-in-time checks you can run on any account. Good first step whenever you take on a new account or do a quarterly review. What you can check
  • 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.
  • Negative keywords — negative keywords at the campaign and ad group level. Optionally filtered to a specific campaign.
Options
  • 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
Example prompts 
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].

​
Discovery & listing

Browse the structure of any account — campaigns, ad groups, keywords, ads, and negative keyword lists. These are navigation actions, not performance reports; they return IDs and status, not metrics. What you can list
  • 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)
Example prompts 
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]?

​
Performance reporting

Pull metrics for any level of your account across any date range. All reports support filtering, sorting, and CSV export. Available reports Search campaigns
  • Campaign performance
  • Ad group performance
  • Ad performance
  • Keyword performance
  • Search terms report
  • Geographic performance
  • Device performance
  • Impression share (competitive visibility)
  • Conversion actions
  • Age range performance
  • Gender performance
Performance Max
  • 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 (Agency plan only)
  • Custom GAQL query — write any read-only SELECT query against the Google Ads API
Options
  • 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)
Example prompts 
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.

​
Keyword research

Generate keyword ideas or get historical metrics for a list of known keywords. Uses the same underlying Google Keyword Planner API. What you can do
  • 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
Options
  • 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)
Example prompts 
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

Create a new Search campaign, paused by default so you can review before launching. What gets set at creation
  • 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’
Bidding strategies
  • 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
Example prompt 
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].

​
Performance Max campaigns

Create a full PMax campaign with budget, asset group, and initial assets in one step. See the Performance Max section for the full breakdown.

​
App campaigns

Create campaigns to drive app installs, in-app actions, or pre-registrations. Goals
  • 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
  • pre_registration — pre-launch registrations
Example prompt 
Create an App Installs campaign called "[CAMPAIGN_NAME]" for app ID [APP_ID] on Google Play, $[BUDGET]/day budget, targeting [LOCATION].

​
Ad & keyword management

​
Responsive Search Ads

Create new RSAs or update existing ones. Create
  • 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
Update
  • Change headlines, descriptions, or display URL paths on an existing ad
  • Change ad status (enable, pause, remove)
Example prompts 
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]".

​
Keywords

Add positive (targeted) keywords to an ad group, or manage negative keywords at the campaign level. Match types: Broad, Phrase, Exact Example prompts 
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 shared negative keyword lists and assign them to campaigns. Example prompts 
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 ad groups or update their name and status. Example prompts 
Create an ad group called "[ADGROUP_NAME]" in campaign [CAMPAIGN_ID].

Pause ad group [ADGROUP_ID].

​
Campaign settings

Update settings on existing Search campaigns. What you can change
  • 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
Example prompts 
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].

​
Performance Max

Full management for PMax campaigns — create, update assets, manage signals. → See the Performance Max guide for the full end-to-end walkthrough.

​
Create a PMax campaign

One step: creates the budget, campaign, asset group, and uploads your initial assets. Required assets
  • 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
Optional
  • 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
Example prompt 
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 second asset group to an existing PMax campaign. 
Add a new asset group called "[ASSET_GROUP_NAME]" to PMax campaign [CAMPAIGN_ID].
For brand-guidelines-enabled campaigns, omit business name and logo — they’re inherited from the campaign level.

​
Update asset group status

Pause, enable, or remove an asset group without touching the campaign. 
Pause asset group [ASSET_GROUP_ID].

Enable asset group [ASSET_GROUP_ID].

​
Update assets

Add new assets (upload new creative by URL): 
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 (reuse already-uploaded assets from your library without creating duplicates): 
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]
Remove assets (requires exact asset resource names — list assets first): 
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)

Returns business name, logo, and landscape logo assets attached at the campaign level. 
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

See what changed in an account, when it changed, and who changed it. Two levels of detail
  • 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)
Options
  • Date range (required)
  • Filter by campaign or ad group
  • Output mode: summary, summary_and_csv, csv_only
Example prompts 
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

A combined pacing + waste check designed to run every morning, especially useful across multiple accounts. What it checks
  1. Budget pacing — flags campaigns that overspent or underspent yesterday relative to their daily budget
  2. Wasteful search terms — search terms with zero conversions, sorted by cost (highest waste first)
Options
  • Date range (defaults to yesterday)
  • Overspend threshold (default: 150% of daily budget)
  • Underspend threshold (default: 50% of daily budget)
  • Number of wasteful search terms to show inline
  • Suggested match type for adding flagged terms as negatives (default: Exact)
Example prompts 
Run the daily ops audit for account [CUSTOMER_ID].

Run yesterday's ops audit for [CUSTOMER_ID] — flag anything over 130% spend or under 60%.

Daily audit for [CUSTOMER_ID], export wasteful search terms to CSV.

​
Billing

Check your current HireOtto plan, credit balance, and billing period. 
What's my current HireOtto plan and credit balance?
→ See Credits & billing for the full reference.