Google Ads

Connecting

Open Accounts and choose Google Ads. Sign in with the Google account that can reach the Ads account, then pick which customer Adako works on. Manager accounts appear in the list but cannot be made active — pick the account that holds the campaigns.

Account IDs are strings without dashes. Money is a decimal in the account currency: 15 means fifteen units a day, never micros.

What it reads

• Campaigns with budget, bidding strategy and status.
• Campaign, ad group and keyword performance with a previous-period delta.
• Campaign structure: ad groups, keywords with match type and quality score, responsive search ads.
• Search terms for a period, classified as converting, wasted or new, with suggested negatives.
• Wasted spend: keywords and campaigns above a spend floor with no conversions, learning phase excluded.
• Targeting: locations, languages, ad schedule, devices, audiences.
• Conversion actions with status, category and counting, and what each one recorded.
• Keyword ideas with volume, competition and top-of-page bid range.
• Ad copy as it runs, with ad strength, approval status and per-asset labels.
• Assets and extensions in the account, and which campaigns or ad groups use them.
• Performance Max asset groups, their search themes and audience signals.
• Portfolio bid strategies, labels, ad schedules and device bid adjustments.
• Splits by device, country and hour of day, in the account timezone.
• A period-over-period change decomposed across campaigns, devices, networks, countries and search terms, so a drop has a named cause.
• A budget reallocation plan, from what each campaign returns and whether it is capped.

What it writes

Every write is a proposal first. After approval it executes once and reads the object back.

• Create a Search campaign: budget, campaign, geo and language criteria, ad groups, keywords, one responsive search ad per ad group, optional campaign negatives.
• Create a Performance Max campaign: budget, campaign, locations, asset group, every text and image asset, search themes and an audience signal.
• Create a responsive search ad inside an ad group that already exists.
• Update a campaign budget, name, status, end date, networks, locations or languages.
• Change the bid strategy, the ad schedule and device bid modifiers, with the current values read first.
• Pause and resume campaigns, ad groups and ads.
• Add keywords and campaign-level negative keywords; update a keyword status or CPC bid; pause or re-bid up to 300 keywords in one call.
• Add sitelinks, callouts, structured snippets, a call asset, a business name and image assets, and link them to the account, a campaign or an ad group.
• Create and update conversion actions. Create and apply labels.
• Remove negative keywords, asset links, search themes or a label. Those four tools exist only to remove, and each needs an explicit confirmation flag. Location, language and ad schedule updates can also drop entries, and the preview shows which.

How a campaign gets created

The order is fixed, and each step is a separate call so nothing is guessed:

1. Research keywords, if you asked for ideas.
2. Resolve locations — free text never reaches a write call; “Paris” becomes a geo target ID or a list of candidates.
3. Validate the ad copy against the platform limits: 15 headlines at 30 characters, 4 descriptions at 90.
4. Create everything in one atomic mutate. The campaign is paused, with its ad groups and ads active inside it, so turning it on launches it.
5. Read back the campaign, ad groups, keywords and ads that now exist.

A prompt that works

Review the last 30 days. List campaigns with spend over 500 and no conversions,
then propose pausing the worst one and adding negatives for the wasted search terms.

Limits worth knowing

• Keyword research needs Basic access on the developer token. Without it the tool says so instead of guessing.
• Shared budgets are detected and explained rather than silently changed.
• Performance Max runs best with conversion tracking set up. Adako does not check for it, so set it up in Google Ads first. It reports at asset group level: there is no search-term report like Search campaigns have.
• Shopping, App and Display campaigns are read-only context. Adako does not create them.
• Business name and call assets need Google advertiser verification on the account. Without it Google refuses the link, and Adako says so rather than printing the error code.
• Pause is pause; it never routes to a removal. The four removal tools each need a confirmation flag.