Growcita + Google Ads

1. Paid Media performance dashboard (Reporting)

Surface: Dashboard → Paid Media in the Growcita app.

On a configurable schedule (default: every 6 hours), our worker calls GoogleAdsService.SearchStream with GAQL queries that return campaign-, ad-group-, ad-, and keyword-level metrics for the last 90 days. Metrics include impressions, clicks, conversions, conversion value, cost, CTR, CPC, average position, ROAS, CPA, and quality scores. Results are persisted as campaignSnapshots rows scoped to the customer's Growcita session and rendered in interactive cards, tables, and time-series charts with date-range, campaign, and ad-group filters.

2. AI-assisted campaign analysis & reports (Reporting)

Surface: Past Reports, Notification bell, and Paid Media chat.

The Paid Media agent reads the campaign snapshots and uses an LLM to generate weekly performance summaries, identify under-performers and over-performers, flag pacing risk, and produce optimisation suggestions with a written rationale. Reports land as notifications in the bell and are archived under Past Reports. Users can also ask the agent ad-hoc questions in chat (“Why is ROAS down on the brand campaign?”), which triggers a fresh GoogleAdsService.Search call and an LLM-generated answer cited with the metrics it pulled.

3. Health audits (Reporting)

Surface: Ads Health Auditor tab on the Paid Media dashboard.

A background task scans the connected Google Ads account for a fixed list of issues: missing or broken conversion tracking, orphaned ad groups (no enabled ads), broken destination URLs (HTTP HEAD checks against final URLs), single-ad ad groups (Google's Optimization Score recommends 3+), missing negative keyword lists at the account level, ad-strength ‘poor’ ratings, and budget pacing variance > 25% from the configured monthly cap. Each issue is reported with the specific resource ID and a one-click remediation suggestion.

4. Campaign management (Ad creation/management)

Surface: Paid Media chat, Action Center, and Approval Queue.

When the user instructs the agent (or, at higher autonomy levels, when a scheduled task fires), Growcita can perform the following write operations through the Google Ads API:

• · Create campaign budget via CampaignBudgetService.MutateCampaignBudgets.
• · Create campaign (Search, Performance Max, Display, or Shopping) via CampaignService.MutateCampaigns — always created in PAUSED state. The user must explicitly enable.
• · Update campaign (status, name, date ranges) via the same service.
• · Adjust campaign budget within the user-configured maximum daily spend change % guardrail. Larger changes are blocked verbatim and routed to approval.
• · Create / update ad groups via AdGroupService.MutateAdGroups.
• · Create responsive search ads (3+ headlines, 2+ descriptions, validated against Google's ad-strength heuristics) via AdGroupAdService.MutateAdGroupAds.
• · Upload ad image assets via AssetService.MutateAssets with base64 image bytes.
• · Add negative keywords at the ad group, campaign, or shared-list level via AdGroupCriterionService and CampaignCriterionService.
• · Pause underperformers— campaigns or ad groups whose CPA exceeds the user's max CPA ceiling, or whose ROAS falls below the min ROAS floor for a configurable lookback window.

Every write passes through Growcita's four-layer safety stack — autonomy gate, budget gate, platform guardrails, human approval — and is recorded in the audit log with the tool name, input size, duration, and outcome.

5. Customer Match audience uploads (Ad creation/management)

Surface: Audiences tab on the Paid Media dashboard.

Users can build first-party audience lists from their connected CRM, sequence platform, or uploaded CSV. Growcita SHA-256 hashes email addresses and phone numbers before upload (per Google policy), creates a Customer Match UserList via UserListService, and adds members via OfflineUserDataJobService. The user must explicitly attest that they have collected the list with appropriate consent before the upload runs — Growcita refuses the upload if the consent flag is missing.

6. Keyword research (Keyword research)

Surface: SEO & Paid Media chat, Keyword Planner tab.

When the user asks the SEO or Paid Media agent for keyword ideas, Growcita calls KeywordPlanIdeaService.GenerateKeywordIdeas with the user's seed terms, target language, and geographic targeting. Suggestions are presented in the UI for review — nothing is auto-added to a campaign. The user picks which keywords to add and the agent then makes the explicit ad-group criterion writes.