Google Adsi süsteem otsinguterminite, kavatsuste, raiskamise ja konto struktuuri haldamiseks.
Kogu oskus — vaikeversiooni hoitakse GitHubis; sinu muudatused jäävad sinu enda klooni.
Google Ads on armatuurlauaks maskeeritud keelemäng.
Enamik kontosid ei kuku läbi sellepärast, et nupud on valed. Nad kukuvad läbi, sest konto segab omavahel eri liiki kavatsusi, ostab rämpsuudishimu ja peidab signaali halva struktuuri sisse.
See süsteem on olemas selle parandamiseks.
READ LAYER → DRAFT LAYER → APPLY LAYER (future)
Live data via MCP Proposed actions Controlled write-back
or manual exports in staging docs after human approval
↕ ↕ ↕
WORKSPACE MEMORY (workspace/ads/)
google-ads-mcp MCP-serveri kaudu (ühendatud režiim) või võta vastu käsitsi CSV/kleebitud tekst/ekraanipildid (ekspordirežiim).workspace/ads/drafts/ inimese ülevaatuseks.| Käsk | Eesmärk |
|---|---|
/google-ads connect |
Esmane seadistamine, seisukorra kontroll, konto valimine (ühendatud režiim) |
/google-ads daily |
Kiire haldaja kokkuvõte sellest, mis täna oluline on |
/google-ads search-terms |
Leia raiskamine, signaal, sõnumivihjed ja suunamisprobleemid |
/google-ads intent-map |
Koosta/uuenda konto kavatsuste mudelit |
/google-ads negatives |
Soovita negatiivseid märksõnu koos ulatuse ja riskimärkustega |
/google-ads tracking |
Diagnoosi, kas konto on optimeerimiseks piisavalt usaldusväärne |
/google-ads structure |
Soovita kampaania/reklaamirühma struktuuri muudatusi |
/google-ads rsas |
Loo/täpsusta RSA suundi päriselt kasutatud päringukeele põhjal |
/google-ads budget |
Eelarve/skaleerimise otsused signaali kvaliteedi põhjal |
/google-ads plan |
Planeeri või ehita ümber konto arhitektuur |
/google-ads audit |
Täielik haldaja ülevaatus kõigil peamistel tasanditel |
/google-ads landing-review |
Diagnoosi maandumisleht → konversioon teed (jälgimine vs UX) |
/google-ads draft-summary |
Kõigi ootel mustandite prioriseeritud kokkuvõte |
/google-ads apply |
Täida heakskiidetud mustandid (v1: ainult negatiivsed märksõnad + peatamised) |
Iga oskus vajab andmeid. Süsteem toetab kahte režiimi. Määra režiim alati enne analüüsi.
Ühendatud režiim — eelistatud. MCP-server google-ads-mcp on seadistatud ja ligipääsetav.
- Test: kutsu MCP kaudu välja list_accessible_customers. Kui see tagastab kliendi ID-d, oled ühendatud.
- Andmed: tõmba reaalajas kontoandmeid GAQL-päringutega MCP tööriista search kaudu.
- Iga oskuse päringumallid leiad failist data/gaql-recipes.md.
Ekspordirežiim — varuvariant. MCP-serverit pole või kasutaja esitab selgesõnaliselt eksporditud andmed.
- Kasutaja kleebib CSV, ekraanipildid või teksti Google Adsi kasutajaliidesest.
- Iga oskuse soovitatud ekspordivormingud leiad failist data/export-formats.md.
- Kogu analüüs töötab endiselt — lihtsalt staatiliste andmetega reaalajas päringute asemel.
Ühendatud režiimis:
MCP call: list_accessible_customers
→ Returns customer IDs and names
→ If multiple accounts, ask user which one (or use workspace/ads/account.md if set)
Ekspordirežiimis:
- Konto kontekst tuleb kasutaja esitatud andmetest
- Salvesta konto identiteet järjepidevuse huvides faili workspace/ads/account.md
Igal oskusel on oma GAQL-päringud (dokumenteeritud tema enda SKILL.md-s ja failis data/gaql-recipes.md).
MCP-kutse muster:
Tool: search (on google-ads-mcp MCP server)
Arguments: { "customer_id": "1234567890", "query": "<GAQL query>" }
GAQL-i märkused:
- Kõik cost_micros väärtused: 1 000 000 = $1.00 — teisenda kuvamiseks
- Ajavahemikud: DURING LAST_7_DAYS, LAST_30_DAYS või BETWEEN 'YYYY-MM-DD' AND 'YYYY-MM-DD'
- Suurte kontode puhul kasuta LIMIT-i (alusta 500-st)
- Kõik ressursi ja mõõdiku kombinatsioonid ei ole kehtivad — kui päring ebaõnnestub, vaata GAQL-i dokumentatsiooni
Mõned kontod on uinunud, hõredad või hooajalised. Naiivne hiljutise perioodi päring võib eksitada — näidata nullandmeid, kuigi kasulik ajalugu on olemas.
Varuahel (proovi järjest, kuni andmed tulevad):
| Prioriteet | Ajavahemik | GAQL-klausel | Kasuta, kui |
|---|---|---|---|
| 1. | Viimased 30 päeva | DURING LAST_30_DAYS |
Vaikimisi — aktiivsete kontode puhul kõige asjakohasem |
| 2. | Viimased 90 päeva | DURING LAST_90_DAYS |
30 päeva andis null või peaaegu null andmeid |
| 3. | Viimased 12 kuud | DURING LAST_12_MONTHS |
90 päeva on endiselt hõre |
| 4. | Kogu aeg | (kuupäevafiltrita) | Konto on tõeliselt uinunud — tõmba kogu saadaolev ajalugu |
Reeglid: 1. Alusta alati LAST_30_DAYS-iga, kui haldaja ei määra muud vahemikku. 2. Kui esimene päring tagastab 0 rida või kogukulu on <$5, laienda automaatselt — ära teata „andmeid pole“ ilma proovimata. 3. Märgi väljundis alati ära, millist ajavahemikku kasutati: „Ajavahemik: viimased 30 päeva“ või „Ajavahemik: kogu aeg (konto uinunud alates ~Q4 2023)“. 4. Kui pidid varuvariandi kasutama, selgita miks: „Viimase 30 päeva jooksul tegevust ei olnud. Ajaloolise konteksti andmiseks kasutati kogu aja andmeid.“ 5. Ära kunagi kasuta vaikimisi erinevat ajavahemikku vaikselt. Haldaja peab teadma, kui värsked on andmed, mida ta vaatab. 6. Perioodide võrdlemisel peavad mõlemal perioodil olema andmed. Kui praegune periood on tühi, märgi see kui „praegu tegevust pole“, selle asemel et näidata eksitavaid -100% muutusi.
Rakendamine oskustes:
Iga oskuse põhipäring peaks kasutama DURING LAST_30_DAYS. Kui tulemuste hulk on tühi või tühiselt väike, käivita uuesti DURING LAST_90_DAYS-iga ja seejärel kuupäevafiltrita. Dokumenteeri väljundi päises, milline vahemik andmed andis.
Iga analüüsi alguses teata, milline režiim on aktiivne:
Režiim: ühendatud — tõmban reaalajas andmeid kontolt [Name] (ID: XXXXXXXXXX)
või
Režiim: eksport — analüüsin esitatud andmeid. Reaalajas ligipääsuks seadista MCP-server
google-ads-mcp(vtdata/mcp-config.md).
Kui analüüs annab tegutsemiskõlblikke leide, kirjutavad oskused mustanddokumendid inimese ülevaatuseks.
drafts/templates/ (negative-draft.md, structure-draft.md, budget-draft.md, rsa-draft.md, tracking-draft.md)workspace/ads/account.md — väiketähtedes, ASCII, sidekriipsudega, maksimaalselt 2–3 sõna; vajadusel kasuta varuvariandina CID-dworkspace/ads/drafts/YYYY-MM-DD-[account-slug]-[type].mdworkspace/ads/drafts/_index.mdworkspace/ads/drafts/_batch-YYYY-MM-DD-[account-slug].md selle käivituse püsiva auditipaketinaworkspace/ads/drafts/2026-03-14-east-coast-negatives.md — 8 negatiivset märksõna kampaaniale X“## Review peab sisaldama punkte: tõendid kontrollitud, kõrvalrisk kontrollitud, sõltuvused kontrollitud, otsus, otsuse põhjus, üle vaatas, ülevaatuse kuupäev, rakendamise kuupäev ja märkusedEnne sügavat analüüsi kogu või tuleta välja: 1. Ärimudel / valdkond 2. Peamine KPI / konversioonieesmärk 3. Eelarvevahemik või tegelik eelarveolukord 4. Aktiivsed kampaaniatüübid 5. Saadaolevad andmed: ühendatud režiim või eksport (otsinguterminite aruanne, kampaania eksport, ekraanipildid, jälgimise märkmed)
Kui kasutaja on konteksti juba andnud, ära küsi seda uuesti.
Kui failid workspace/ads/account.md ja workspace/ads/goals.md on olemas, laadi need — kontekst võib olla juba talletatud.
Küsi alati: - Mida kasutaja selle otsinguga teha püüab? - Kas see otsing tõenäoliselt ostab, võrdleb, õpib, navigeerib või põrkab? - Kas see päring peaks kuuluma samasse optimeerimiskorvi kui teised? - Milline keel kordub näiliste võitjate seas? - Milline keel kordub raisatud kulu seas? - Milline struktuurne järeldus sellest tuleneb?
Kasuta jagatud mäluna kausta workspace/ads/.
Põhifailid:
| Fail | Eesmärk |
|------|---------|
| account.md | Konto identiteet, kliendi ID, ärikontekst |
| goals.md | KPI-d, sihtväärtused, milline näeb välja edu |
| intent-map.md | Otsingukavatsuse klasside püsiv mudel |
| queries.md | Tähelepanuväärsed päringumustrid ja klastrid |
| negatives.md | Aktiivsed ja kavandatud negatiivsed märksõnad |
| winners.md | Hästi toimivad päringud, reklaamid, kampaaniad |
| tests.md | Käimasolevad ja lõpetatud katsed |
| findings.md | Strateegiliste leidude logi |
| change-log.md | Mis muutus ja millal |
| learnings.md | Saadud õppetunnid (toidavad tulevasi otsuseid) |
| assets.md | RSA pealkirjad, kirjeldused, loomingulised märkmed |
| drafts/_index.md | Mustandite järjekord koos olekutega |
| drafts/_summary.md | Praegune prioriseeritud tööjärjekorra vaade |
| drafts/_batch-*.md | Ajahetke auditipaketid mitme mustandiga auditikäivituste jaoks |
| drafts/*.md | Üksikud toimingute ettepanekute mustandid |
Laadi vajaduse korral (ainult praeguse oskuse jaoks asjakohased):
- google-ads/references/operator-thesis.md
- google-ads/references/intent-map.md
- google-ads/references/query-patterns.md
- google-ads/references/negatives-playbook.md
- google-ads/references/tracking-playbook.md
- google-ads/references/structure-playbook.md
- google-ads/references/rsa-playbook.md
- google-ads/references/budget-playbook.md
- google-ads/references/deliverable-templates.md
- google-ads/references/benchmarks.md
- google-ads/references/landing-page-playbook.md
Kasuta reaalajas kontoga esmakordsel ühendamisel, kontode vahetamisel või MCP-ühenduse tõrkeotsingul. Käivitab seadistuse, klientide tuvastamise, konto valimise ja seisukorra kontrolli. Käivita see ühendatud režiimis enne mis tahes muud oskust, kui workspace/ads/account.md on tühi või puudub. Vt skills/google-ads-connect/SKILL.md.
Kasuta, kui kasutaja soovib lühikest haldaja ülevaadet. Tõmba viimase 7 päeva tulemused + hiljutised muudatused. Too esile, mis täna oluline on, ja viita vajadusel olemasolevatele mustanditele.
Kasuta, kui kasutaja tahab teada, kus raiskamine lekib ja kus kavatsus esile kerkib. Tõmba otsinguterminite aruanne (viimased 30 päeva). Loob leidude põhjal negatiivsete märksõnade mustandeid ja RSA mustandeid.
Kasuta, kui kasutaja soovib püsivat strateegilist ülevaadet konto otsingukäitumisest. Tõmba klasterdamiseks kõik otsinguterminid. Loob struktuurimustandeid, kui kavatsusklassid vajavad eraldamist.
Kasuta, kui välistamise ja suunamise otsused on prioriteet. Tõmba olemasolevad negatiivsed märksõnad + otsinguterminid. Loob alati konkreetsete märksõnadega negatiivsete märksõnade mustandi.
Kasuta, kui konto võib optimeerida halva signaali järgi. Tõmba konversioonitoimingud ja nende tulemused. Loob jälgimise mustandeid, kui parandusi on vaja.
Kasuta, kui erinevad kavatsused on segamini ja konto arhitektuur peidab tähendust. Tõmba kampaania/reklaamirühma/märksõnade struktuur. Loob struktuurimustandeid jagamiste, ühendamiste ja suunamismuudatuste jaoks.
Kasuta, kui reklaamitekst peaks põhinema ostjate päris keelel. Tõmba RSA varade tulemused + otsinguterminid. Loob konkreetsete pealkirjade ja kirjeldustega RSA mustandeid.
Kasuta, kui otsustad, kus kulu kaitsta, vähendada või skaleerida. Tõmba eelarve ja näitamisosa andmed. Loob ümberjaotamise ettepanekute jaoks eelarvemustandeid.
Kasuta uue konto käivitamisel või ümberehitamisel. Loob tervikliku plaanidokumendi (mitte mustandi — plaanid on iseseisvad tulemused, mis salvestatakse tööruumi).
Kasuta laiaks sünteesiks. Käivitab mitme oskuse miniversiooni. Loob prioriseeritud mustandite paketi, mis katab suurima mõjuga muudatused, ning kui luuakse 2 või rohkem mustandit, selle käivituse püsiva auditipaketi _batch-YYYY-MM-DD-[account-slug].md.
Kasuta, kui kasutaja ütleb „maandumisleht ei konverteeri“ või tahab mõista, miks klõpsud ei muutu müügivihjeteks/müükideks. Käivitab alati haru A (jälgimise diagnoos) enne haru B-d (UX-i/tee diagnoos). Eristab jälgimistõrkeid lehe tõrgetest — need on kaks kõige sagedamini segi aetud algpõhjust. Loob maandumislehe ülevaatuse mustandeid ja/või jälgimise paranduse mustandeid. Kasutab tegelike maandumislehtede kontrollimiseks brauserit/laadimist.
Kasuta, kui kasutaja soovib ootel mustandeid üle vaadata, prioriseerida, mida rakendada, või mõista soovitatud rakendamise järjekorda. Loeb kõik ootel mustandid, liigitab need prioriteedi/mõju/riski järgi, kaardistab sõltuvused ja loob ühe prioriseeritud tööjärjekorra hetkeseisu faili workspace/ads/drafts/_summary.md. Ära kasuta _summary.md-d auditikäivituse paketina; see roll kuulub failile _batch-*.md.
Kasuta, kui kasutaja soovib heakskiidetud mustandit täita. v1 ulatus: AINULT negatiivsete märksõnade lisamine ning märksõnade/reklaamirühmade peatamine. Näitab proovikäivitust, nõuab selgesõnalist kinnitust, täidab Google Ads API kaudu, kontrollib muudatusi ja kirjutab auditijälje. Täielikku kavandit vt APPLY-LAYER.md. Täitmisprotokolli vt skills/google-ads-apply/SKILL.md.
Iga tulemus peaks lõppema otsustega, mitte ainult tähelepanekutega.
Iga analüüsi väljund peab algama konto oleku plokiga, enne kui leidudesse süvenetakse:
## Account Status
- **Account:** [Name] (CID: [ID])
- **Status:** Active | Suspended | Dormant | Paused
- **Date range used:** Last 30 days | Last 90 days (30-day was empty) | All time
- **Tracking confidence:** High | Medium | Low | Broken
- **Mode:** Connected | Export
See plokk tagab, et haldaja teab kohe, (a) kas konto saab reklaame näidata, (b) kui värsked on andmed ja (c) kas ta saab numbreid usaldada. Kui konto on peatatud või uinunud, on see peamine uudis — kõik muu on teisejärguline.