Ads Agent — AI asistent pre Google Ads dáta
Interný webový chat, v ktorom sa PPC tím môže pýtať na Google Ads dáta bežnou rečou. Namiesto ručného hľadania v rozhraní alebo čakania na špecialistu dostane odpoveď za pár sekúnd.
- Klient
- Interný nástroj pre veľký e-commerce brand
- Rola
- Samostatne od návrhu po nasadenie
- Tím
- Tím 5-6 používateľov
Použité technológie
- Python 3.13
- Google Agent Development Kit (ADK)
- Gemini 3 Flash Preview
- Model Context Protocol (MCP)
- FastAPI / Starlette
- OAuth 2.0
- Google Cloud Run
- Secret Manager
Dopad
- Čo umožňuje
- PPC tím sa môže pýtať na výkon kampaní bežnou rečou a dostáva odpovede zo živých dát. Menej ručných reportov, menej čakania, rýchlejšie rozhodnutia.
- Cena prevádzky
- Pod 1 € denne pri tímovej záťaži; Cloud Run škáluje na nulu pri nečinnosti
- Doba vývoja
- Dva sústredené dni, samostatne
- Používatelia
- PPC tím, prístup obmedzený OAuth 2.0 na firemnú doménu
Čo to umožňuje
Ktokoľvek v PPC tíme sa môže opýtať Google Ads účtu otázku bežnou rečou a dostane odpoveď zo živých dát. Bez znalosti Google Ads API, bez nového dashboardu a bez čakania na kolegu, ktorý vie pripraviť zložitejší report.
Pre tím to znamená, že bežné analytické otázky sa dajú riešiť hneď. Napríklad: ktoré kampane minuli najviac peňazí za posledných 14 dní, kde padol ROAS alebo ktoré produkty v PMax kampani treba skontrolovať.
Nástroj vznikol za dva sústredené dni, beží lacno a prístup je obmedzený na firemné účty.
Prečo to dáva zmysel
Technológie sú tu dôležité hlavne preto, že umožnili postaviť praktický interný nástroj bez veľkého vývojového tímu:
- Gemini spracuje otázku a pripraví odpoveď.
- Google Ads MCP server je bezpečné prepojenie na Google Ads účet.
- Cloud Run a firemné prihlásenie zabezpečia, že nástroj beží ako interná webová aplikácia a nepúšťa dnu cudzích používateľov.
Výsledkom nie je ukážka AI, ale pracovný nástroj pre tím.
Ako to funguje
Používateľ sa prihlási firemným Google účtom, otvorí webový chat a položí otázku. AI pripraví dotaz na Google Ads, nástroj si prečíta dáta z účtu a vráti odpoveď v zrozumiteľnej forme. Prístup je obmedzený na firemnú doménu a nástroj má iba čítacie oprávnenia.
Browser (firemný používateľ)
│ HTTPS + session cookie
▼
Cloud Run (ads-agent-v2)
├── Starlette OAuth middleware (hd=firemna-domena)
└── ADK LlmAgent
│
├──► Vertex AI: gemini-3-flash-preview (global)
│
└──► google-ads-mcp subprocess (stdio)
│ OAuth refresh token (Secret Manager)
▼
Google Ads API (read-only)
Kľúčové výzvy
1. Oddelenie prístupov pre AI a Google Ads
Prvé verzie miešali prístupy pre Google Ads a Vertex AI. Výsledok bol, že jedna časť systému sa pokúšala použiť nesprávne oprávnenia a požiadavky padali.
Riešenie: oddeliť prístupy tak, aby AI používala vlastnú identitu a Google Ads nástroj vlastné prístupové údaje. Tým sa odstránil konflikt.
2. Aktuálny dátum pre AI
Pri otázke typu „posledných 7 dní“ AI najprv nevedela spoľahlivo určiť dnešný dátum. To je pri reklamných dátach zásadný problém.
Riešenie: pri štarte aplikácie sa do inštrukcií pre AI doplní aktuálny dátum a model má preferovať relatívne obdobia, napríklad „posledných 7 dní“.
3. Prihlásenie a verejná dostupnosť služby
Cloud Run služba musí byť technicky dostupná z internetu, aby sa používateľ vedel dostať na prihlasovaciu stránku. Skutočné obmedzenie prístupu sa rieši až v aplikácii cez firemné Google prihlásenie.
Kľúčové poučenia
- Overiť dostupnosť modelu pred nasadením. Rýchly test ušetrí zbytočný build a hľadanie chyby až po nasadení.
- AI potrebuje aktuálny dátum. Každý nástroj, ktorý pracuje s časovými obdobiami, musí mať jasne zadané, čo je „dnes“.
- Jedna časť systému, jedna identita. Ak Google Ads a AI používajú rôzne prístupy, musia byť striktne oddelené.
- Prihlásenie a infraštruktúrne práva sú dve vrstvy. Nestačí nastaviť iba Cloud Run alebo iba OAuth. Musia spolu dávať zmysel.
- Bezpečnostné pravidlá pre AI treba testovať. Nestačí napísať do promptu „toto nikdy neukazuj“. Treba overiť, ako sa model správa pri hraničných otázkach.
Stav a ďalšie kroky
Služba beží na Cloud Run a prístup je chránený firemným Google prihlásením. Ďalší krok je lepšie auditovanie otázok a odpovedí, obmedzenie rýchlosti používania a trvalejšie ukladanie relácií, ak to objem používania začne vyžadovať.