--- title: Google Adsi muudatuste rakendamine description: Rakendab kinnitatud muudatused Google Adsi kontol turvaliste muudatustüüpide piires. category: Marketing sublabel: Tasuline reklaam author: Matt Berman tags: license: MIT source: https://github.com/TheMattBerman/google-ads-copilot --- # Google Ads Apply ## Staatus: LIVE — kirjutusõigus kinnitatud > **API v20 kinnitatud töötavana** (15.03.2026). v18 on lõpetatud (404), v19 ebastabiilne (500). > Täielik kirjutustsükkel tõestatud: lisa kampaania negatiiv → GAQL kontroll → eemalda → eemaldamise kontroll. > Märksõna peatamised ja reklaamirühma peatamised täielikult karkassitud ja karastatud. > CLI-skriptid asukohas `scripts/apply-layer/`. > Suitsutest: `scripts/apply-layer/gads-smoke-test.sh ` > Vaata disainidetailide kohta `APPLY-LAYER.md` ja avaliku CLI teostusjuhendi kohta `scripts/apply-layer/README.md`. > Vaata täieliku operaatori töövookuristiku kohta `OPERATOR-PLAYBOOK.md`. Loe esmalt: - `OPERATOR-PLAYBOOK.md` — täielik operaatori töövoog (ühenda → vali → vaata üle → rakenda → kontrolli → võta tagasi) - `APPLY-LAYER.md` — disainidokument, API spetsifikatsioonid, vigade käitlemine - `drafts/DRAFTS.md` — mustandisüsteemi dokumentatsioon Loe tööruum: - `workspace/ads/drafts/_index.md` — praegune järjekord - `workspace/ads/drafts/_summary.md` — prioriseeritud kokkuvõte - `workspace/ads/audit-trail/_log.md` — eelmised rakendussessioonid (kui on) - `workspace/ads/audit-trail/reversal-registry.json` — aktiivsed tagasivõtmised --- ## Käsud ### Rakenda mustand ``` /google-ads apply [draft-file] ``` **Voog:** 1. Loe mustandifail 2. Parsi kõik pakutud tegevused (eelarvemustandite puhul manifest-esimesena; v1 negatiivide/peatamiste puhul vana parsimine) 3. Valideeri iga tegevus (õige konto, kehtivad sihtmärgid, live rakendusulatuse piires) 4. Lahenda inimloetavad nimed GAQL-i kaudu Google Adsi ressursi ID-deks 5. Kuva kuivkäik koos iga mutatsiooni loetlemisega, tegevustüübi kokkuvõte ja riskihinnang 6. Oota operaatori kinnitust („confirm" või „cancel") 7. Käivita iga tegevus Google Adsi REST API v20 kaudu 8. Kontrolli muudatusi GAQL-i uuestipäringuga 9. Kirjuta auditilugu (sessioonilogi, põhilogi, tagasivõtmisregister) 10. Uuenda mustandi staatus olekusse „applied" 11. Kuva rakendusjärgne kokkuvõte koos tagasivõtmisjuhistega ### Vaata mustand üle (ilma rakendamiseta) ``` /google-ads apply review [draft-file] /google-ads apply review --all ``` **Voog:** 1. Parsi mustand struktureeritud tegevusteks 2. Kuva tegevuste jaotus koos tüübi- ja riskitasemete loendusega 3. Kuva kindlus ja sõltuvused 4. Anna jätka/lükka edasi soovitus 5. Kuva järgmise sammu käsud (kuivkäik või täielik rakendus) Võrgupäringuid pole, API juurdepääsu pole vaja. Puhas kohalik analüüs. ### Kontrolli operaatori staatust ``` /google-ads apply status ``` Näitab ühe pilguga: - Ühenduse olek (konto, API versioon, mandaadid) - Ootel mustandid koos staatusega - Aktiivsed tagasivõtmised mustandi kaupa rühmitatud - Hiljutised rakendussessioonid - Soovitatav järgmine samm ### Võta üks tegevus tagasi ``` /google-ads undo [reversal-id] ``` **Voog:** 1. Otsi tagasivõtmiskirje failist `workspace/ads/audit-trail/reversal-registry.json` 2. Kuva, mis tagasi võetakse 3. Hoiata, kui muudatus on olnud live >7 päeva 4. Oota kinnitust 5. Käivita tagasivõtmine Google Adsi API kaudu 6. Kontrolli GAQL-iga 7. Uuenda tagasivõtmisregistrit (staatus: „undone") ### Võta kogu mustand tagasi ``` /google-ads undo-draft [draft-file] ``` Võtab tagasi KÕIK konkreetse mustandi aktiivsed tegevused. Sama kinnitusvoog. ### Vaata rakenduslogi ``` /google-ads apply log ``` Näitab hiljutisi rakendussessioone failist `workspace/ads/audit-trail/_log.md`. --- ## Ulatuse kaitsemeetmed (v1 + v2 eelarved) ### Lubatud tegevused | Tegevus | Sihtmärk | Ulatus | Risk | |--------|--------|-------|------| | Lisa negatiivne märksõna | Kampaania kriteerium | Kampaaniataseme negatiiv | Madal | | Lisa negatiivne märksõna | Reklaamirühma kriteerium | Reklaamirühma taseme negatiiv | Madal | | Peata märksõna | Reklaamirühma kriteerium | Sea staatus olekusse PAUSED | Madal | | Peata reklaamirühm | Reklaamirühm | Sea staatus olekusse PAUSED | Keskmine | | Sea kampaania päevaeelarve | Kampaania eelarve | Uuenda `amount_micros` | Keskmine | ### Miks need on ohutud - **Negatiivsed märksõnad** saavad liiklust ainult VÄHENDADA. Nad ei saa suurendada kulu, lõhkuda reklaame ega rikkuda jälgimist. - **Märksõnade peatamine** peatab liikluse ühele märksõnale. Kogu ajalugu, kvaliteediskoorid ja seadistus jäävad puutumata. - **Reklaamirühmade peatamine** peatab liikluse märksõnade komplektile. Samad säilitamisgarantiid. Laiem plahvatusraadius kui märksõna peatamine, seega keskmine risk. - **Kõik on koheselt tagasivõetavad:** eemalda negatiiv või sea staatus tagasi olekusse ENABLED. ### Blokeeritud tegevused (kõva tagasilükkamine) Kui mustand sisaldab tegevusi väljaspool toetatud ulatust, teeb apply-käsk järgmist: 1. Loetleb ulatusevälised tegevused 2. Selgitab, millised on ulatusevälised ja miks 3. Pakub rakendada AINULT ulatusesisesed tegevused 4. Ei käivita kunagi ulatuseväliseid tegevusi olenemata kinnitusest | Tegevus | Versioon | Miks blokeeritud | |--------|---------|-------------| | Pakkumisstrateegia muudatused | v2 | Võib häirida Smart Biddingi õppimist | | Kampaania loomine | v3 | Suur plahvatusraadius | | RSA muudatused | v4 | Õppeperioodi mõju | | Peatatud olemite lubamine | v1-s mitte kunagi | Suurem risk kui peatamine | | Millegi kustutamine | Mitte kunagi | Peata selle asemel | --- ## Mustandi parsimine Rakenduskiht parsib mustandi markdown-failidest need sektsioonid: | Sektsioon | Tegevustüüp | Mall | |---------|-------------|----------| | **Section A: Negatives to ADD** | `ADD_NEGATIVE` | `negative-draft.md` | | **Section D: CRITICAL KEYWORD-LEVEL RECOMMENDATION** | `PAUSE_KEYWORD` | `negative-draft.md` | | **Section A: Keywords to PAUSE** | `PAUSE_KEYWORD` | `pause-draft.md` | | **Section B: Ad Groups to PAUSE** | `PAUSE_ADGROUP` | `pause-draft.md` | Toetatud on nii `negative-draft.md` kui ka `pause-draft.md` mallid. Segatüüpi mustandid (negatiivid + peatamised ühes failis) on täielikult toetatud — parser eraldab kõigist kohalduvatest sektsioonidest ja eemaldab duplikaadid. Eelarvemustandid on erinevad: - Need PEAVAD sisaldama `## Apply Manifest` - Manifest on olemasolul määrav - Mustanditaseme `meta.budget_policy` kontrollib, kas mis tahes netotõus on lubatud ### Mustandimallid - `drafts/templates/negative-draft.md` — negatiivsete märksõnade lisamised + eemaldamised + kitsendused - `drafts/templates/pause-draft.md` — märksõnade peatamised + reklaamirühmade peatamised + mõjukokkuvõte --- ## Valideerimiskontrollid (enne kuivkäiku) Enne kuivkäigu kuvamist valideeri: 1. **Konto vaste:** Mustandi konto ID vastab ühendatud kontole 2. **Kampaania eksisteerib:** Mustandis viidatud kampaania on endiselt olemas (GAQL otsing) 3. **Reklaamirühm eksisteerib:** Reklaamirühma ulatusega tegevuste jaoks (GAQL otsing) 4. **Duplikaate pole:** Negatiivne märksõna ei eksisteeri juba samas ulatuses 5. **Vastetüüp kehtiv:** Ainult PHRASE, EXACT või BROAD 6. **Sihtmärk eksisteerib:** Peatatav märksõna on endiselt olemas ja hetkel ENABLED 7. **Reklaamirühma staatus:** Reklaamirühma peatamiseks on sihtmärk hetkel ENABLED 8. **Ulatuse piires:** Toetatud tegevused on negatiivi lisamine, märksõna peatamine, reklaamirühma peatamine ja manifest-põhised kampaania päevaeelarve muudatused Kui valideerimine ebaõnnestub, teata, millised tegevused ebaõnnestusid ja miks. Ära blokeeri kogu rakendust — lase kehtivatel tegevustel jätkata. --- ## Kuivkäigu kuva ```markdown ═══════════════════════════════════════════════════════ DRY RUN: [draft-file] ═══════════════════════════════════════════════════════ Account: [Name] (CID: [ID]) Actions: [N] valid / [M] total # Action Target Detail Risk --- --------------- --------------------------- -------------------------- ------ 1 ADD NEG Campaign: [name] "near me" [PHRASE] Low 2 ADD NEG Campaign: [name] "debris chute" [PHRASE] Low ... 13 PAUSE KW AG: [name] "waste mgmt" [EXACT] Low 14 PAUSE AG Campaign: [name] [ad group name] Medium Summary: • 12 negative keyword addition(s) • 1 keyword pause(s) • 1 ad group pause(s) • Reversibility: All actions reversible ⚠️ This will make REAL changes to account [CID]. Type 'confirm' to proceed, or 'cancel' to abort: ``` --- ## Rakendusjärgne kontroll Pärast käivitamist käivita kontrollpäringud: | Tegevus | Kontrollpäring | Mida kinnitatakse | |--------|-------------------|------------------| | Lisa kampaania negatiiv | `campaign_criterion` WHERE negative=TRUE | Märksõna eksisteerib kampaanias | | Lisa reklaamirühma negatiiv | `ad_group_criterion` WHERE negative=TRUE | Märksõna eksisteerib reklaamirühmas | | Peata märksõna | `keyword_view` + staatusekontroll | Staatus on PAUSED | | Peata reklaamirühm | `ad_group` + staatusekontroll | Staatus on PAUSED | --- ## Auditilugu Pärast iga rakendussessiooni uuendatakse neid faile: 1. **Põhilogi:** `workspace/ads/audit-trail/_log.md` — ainult juurdelisatav sessioonikokkuvõte 2. **Sessiooni detail:** `workspace/ads/audit-trail/YYYY-MM-DD-apply-session.md` — täielik tegevuse-kaupa logi 3. **Tagasivõtmisregister:** `workspace/ads/audit-trail/reversal-registry.json` — masinloetavad tagasivõtmiskirjed 4. **Mustandifail:** Uuendatud rakendamise kuupäeva ja tagasivõtmise ID-dega 5. **Mustandiindeks:** `workspace/ads/drafts/_index.md` — teisaldatud Applied sektsiooni 6. **Muudatuste logi:** `workspace/ads/change-log.md` — kirje sellest, mis muutus --- ## CLI-skriptid | Skript | Eesmärk | |--------|---------| | `gads-apply.sh` | Täielik rakendusvoog: parsi → valideeri → kuivkäik → kinnita → käivita → kontrolli → audit | | `gads-apply.sh --dry-run` | Parsi ja kuva ainult kuivkäik | | `gads-apply.sh --parse-only` | Parsi mustand JSON-iks (silumine) | | `gads-review.sh` | Parsi ja kuva operaatorile suunatud ülevaatus (API-päringuteta) | | `gads-review.sh --all` | Vaata üle kõik ootel mustandid | | `gads-undo.sh ` | Võta üks tegevus tagasi | | `gads-undo.sh --draft ` | Võta tagasi kõik mustandi tegevused | | `gads-undo.sh --list` | Loetle kõik aktiivsed tagasivõtmised | | `gads-status.sh` | Täielik operaatori staatuse ülevaade | | `gads-status.sh --applied` | Kuva ainult rakendatud tegevused | | `gads-status.sh --pending` | Kuva ainult ootel mustandid | | `gads-smoke-test.sh` | Otsast-otsani kirjutustsükli test | --- ## Ohutusreeglid 1. **Ära kunagi rakenda ilma kuivkäiguta.** Operaator peab nägema täpselt, mis muutub. 2. **Ära kunagi automaatselt kinnita.** Operaator peab sõnaselgelt kirjutama „confirm". 3. **Ära kunagi rakenda ulatuseväliseid tegevusi.** Kõva tagasilükkamine, selge selgitus. 4. **Ära kunagi kustuta midagi.** Peatamine on v1-s maksimaalne raskusaste. 5. **Logi kõike.** Iga tegevus, iga viga, iga tagasivõtmine. 6. **Ebaõnnestu graatsiliselt.** Kui üks tegevus ebaõnnestub, jätka ülejäänutega. Teata ebaõnnestumisest. 7. **Kontrolli pärast rakendamist.** Päri uuesti, et kinnitada muudatuste jõustumist. 8. **Tee tagasivõtmine lihtsaks.** Igal tegevusel on salvestatud tagasivõtmisjuhis. 9. **Piira kiirust.** Max 50 mutatsiooni rakendussessiooni kohta. 500 ms viivitus mutatsioonide vahel. 10. **Pole partiirakendust üle kontode.** Üks konto rakendussessiooni kohta.