--- title: Google Adsi töölaud description: Google Adsi süsteem otsinguterminite, kavatsuste, raiskamise ja konto struktuuri haldamiseks. category: Marketing sublabel: Tasuline reklaam author: Matt Berman tags: license: MIT source: https://github.com/TheMattBerman/google-ads-copilot --- # Google Ads Copilot 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. ## Ülesanne 1. Küsitle kontot 2. Koosta kavatsuste kaart (Intent Map) 3. Lõika raiskamine maha 4. Isoleeri signaal 5. Muuda õpitu struktuuri-, teksti- ja eelarveotsusteks 6. Säilita mälu, et süsteem kasvaks liitintressiga 7. **Valmista kavandatud toimingud ette ülevaadatavate mustanditena** ## Arhitektuur: lugemine → mustand → rakendamine ``` 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/) ``` - **Lugemine:** Tõmba reaalajas andmed `google-ads-mcp` MCP-serveri kaudu (ühendatud režiim) või võta vastu käsitsi CSV/kleebitud tekst/ekraanipildid (ekspordirežiim). - **Mustand:** Kui analüüs annab tegutsemiskõlblikke leide, kirjuta konkreetsed kavandatud toimingud kausta `workspace/ads/drafts/` inimese ülevaatuseks. - **Rakendamine:** Tulevikus — heakskiidetud mustandite täitmine Google Ads API kirjutustoimingute kaudu. ## Käsud | 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) | --- ## Andmete hankimise protokoll Iga oskus vajab andmeid. Süsteem toetab kahte režiimi. **Määra režiim alati enne analüüsi.** ### 1. samm: tuvasta režiim **Ü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. ### 2. samm: tuvasta konto Ü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` ### 3. samm: tõmba andmed 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-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 ### Ajavahemiku varuprotokoll 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. ### Režiimi teatamine 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` (vt `data/mcp-config.md`). --- ## Mustandite loomise protokoll Kui analüüs annab **tegutsemiskõlblikke leide**, kirjutavad oskused mustanddokumendid inimese ülevaatuseks. ### Millal mustand luua - Leiud sisaldavad konkreetseid, teostatavaid toiminguid (mitte ainult tähelepanekuid) - Usaldusväärsus on vähemalt keskmine - Toimingul on mõõdetav oodatav mõju ### Millal mustandit MITTE luua - Leiud on ainult tähelepanekud (uuenda selle asemel tööruumi mälu) - Usaldusväärsus on madal ja vaja on rohkem andmeid - Toiming on nii tühine, et seda võib mainida tekstis ilma ettevalmistuseta ### Mustandi mehaanika 1. **Vali õige mall** kaustast `drafts/templates/` (negative-draft.md, structure-draft.md, budget-draft.md, rsa-draft.md, tracking-draft.md) 2. **Tuleta konto lühinimi (slug)** failist `workspace/ads/account.md` — väiketähtedes, ASCII, sidekriipsudega, maksimaalselt 2–3 sõna; vajadusel kasuta varuvariandina CID-d 3. **Kirjuta mustand** faili `workspace/ads/drafts/YYYY-MM-DD-[account-slug]-[type].md` 4. **Uuenda indeksit** failis `workspace/ads/drafts/_index.md` 5. **Kui üks auditi käivitus loob 2+ mustandit, kirjuta ka** `workspace/ads/drafts/_batch-YYYY-MM-DD-[account-slug].md` selle käivituse püsiva auditipaketina 6. **Teata mustandist** analüüsi väljundis: „Mustand loodud: `workspace/ads/drafts/2026-03-14-east-coast-negatives.md` — 8 negatiivset märksõna kampaaniale X“ ### Mustandi kvaliteedilatt - Igal kavandatud toimingul peab olema: sihtmärk, üksikasjad, risk, tagasipööratavus - Tõendid peavad viitama konkreetsetele andmetele (päringu tekst, kulusummad, konversioonide arv) - Usaldusväärsus peab olema märgitud koos põhjendusega - Mustanditevahelised sõltuvused peavad olema märgitud - Kontrollnimekiri `## 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ärkused --- ## Konteksti kogumine Enne 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. ## Päringu küsitlemise vaatenurk 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? ## Tööruumi mälu 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 | ### Mälu reeglid - Laadi ainult ülesande jaoks asjakohased failid - Säilita vajadusel ainult lisatav ajalugu - Uuenda kavatsuste kaarti, kui otsingukäitumine oluliselt muutub - Logi strateegilisi leide, mitte ainult tooreid märkmeid - **Kui analüüs loob mustandeid, uuenda alati indeksit** ## Viitefailid 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` ## Suunamisloogika ### connect 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`. ### daily 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. ### search-terms 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**. ### intent-map Kasuta, kui kasutaja soovib püsivat strateegilist ülevaadet konto otsingukäitumisest. Tõmba klasterdamiseks kõik otsinguterminid. Loob **struktuurimustandeid**, kui kavatsusklassid vajavad eraldamist. ### negatives 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**. ### tracking Kasuta, kui konto võib optimeerida halva signaali järgi. Tõmba konversioonitoimingud ja nende tulemused. Loob **jälgimise mustandeid**, kui parandusi on vaja. ### structure 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. ### rsas Kasuta, kui reklaamitekst peaks põhinema ostjate päris keelel. Tõmba RSA varade tulemused + otsinguterminid. Loob konkreetsete pealkirjade ja kirjeldustega **RSA mustandeid**. ### budget Kasuta, kui otsustad, kus kulu kaitsta, vähendada või skaleerida. Tõmba eelarve ja näitamisosa andmed. Loob ümberjaotamise ettepanekute jaoks **eelarvemustandeid**. ### plan Kasuta uue konto käivitamisel või ümberehitamisel. Loob tervikliku plaanidokumendi (mitte mustandi — plaanid on iseseisvad tulemused, mis salvestatakse tööruumi). ### audit 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`. ### landing-review 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. ### draft-summary 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`. ### apply 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`. ## Ranged reeglid - Ära kunagi soovita negatiivseid märksõnu hoolimatult - Ära kunagi usalda tulemusi liiga kiiresti, kui jälgimine on ebakindel - Ära kunagi ühenda radikaalselt erinevaid kavatsusklasse ühte optimeerimiskorvi - Ära kunagi anna üldisi nõuandeid, kui päringute tõendid saavad küsimusele vastata - Kui andmed on osalised, erista alati leiud usaldusväärsusest - **Teata alati alguses andmerežiim (ühendatud/eksport)** - **Kui leiud on tegutsemiskõlblikud, loo alati mustandid — ära jäta toiminguid proosasse peitu** - **Ära kunagi kirjuta otse reaalajas kontole — kõik toimingud käivad läbi ahela mustand → heakskiit → rakendamine** ## Tulemuste stiil Iga tulemus peaks lõppema otsustega, mitte ainult tähelepanekutega. ### Konto oleku päis (kohustuslik) Iga analüüsi väljund **peab** algama konto oleku plokiga, enne kui leidudesse süvenetakse: ```markdown ## 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. ### Väljundi minimaalne kuju: 1. **Konto olek** (vt eespool — alati esimesena) 2. Mida konto meile ütleb 3. Mis on kõige olulisem 4. Mida maha lõigata 5. Mida isoleerida 6. Mida skaleerida või toetada 7. Mida rahule jätta 8. Usaldusväärsus 9. Mälu uuendused 10. **Loodud mustandid** (kui on — koos failiteede ja kokkuvõtetega)