Google Ads skripty: ako ich vložiť a otestovať bez rizika
Skript vložíte cez Nástroje, Hromadné akcie a Skripty, autorizujete ho a pred ostrým behom spustíte v režime ukážky, lebo zmeny skriptu sa podľa Pomocníka Google Ads nedajú vrátiť späť. Ukážka však nechráni e-maily ani zápisy do tabuliek a nevytvára prvky, preto prvý ostrý beh obmedzte štítkom na jednu kampaň. Skript beží v mene toho, kto ho autorizoval, a po jeho odpojení od účtu prestane bežať.
Kedy sa Google Ads skript oplatí a kedy stačí pravidlo
Google Ads skripty vedia v účte robiť zmeny bez vás, a to aj v noci, keď nie ste prihlásení. Práve preto je pri nich dôležitejší postup vloženia a testu než samotný kód, lebo Pomocník Google Ads výslovne upozorňuje, že zmeny vykonané skriptom sa nedajú vrátiť späť. Tento článok vás prevedie celou cestou od výberu hotového skriptu cez autorizáciu a režim ukážky až po plánovanie a kontrolu denníkov, aby prvé ostré spustenie neprinieslo prekvapenie.
Čo skript je a na čo sa používa, vysvetľuje heslo Google Ads skripty. Tu ide o praktickú stránku veci. Pomocník Google Ads uvádza, že skripty sa hodia, ak spravujete veľké kampane a vy alebo niekto z kolegov vie so skriptami pracovať, a kto so skriptami pracovať nevie alebo chce zmeny plánovať systematickejšie, tomu odporúča zvážiť automatické pravidlá. Dokumentácia pre vývojárov k tomu dodáva, že na začiatok stačí základná znalosť JavaScriptu, lebo editor pomáha zvýrazňovaním syntaxe, dopĺňaním aj ukážkou.
Google v prehľade produktu radí, ktorý nástroj zvoliť podľa situácie. Nasledujúca tabuľka preberá jeho odporúčania pre bežného inzerenta a vynecháva scenáre, ktoré sa týkajú vývoja vlastného softvéru.
| Vaša situácia | Čo Google odporúča |
|---|---|
| Nie ste programátor, ale ste ochotní venovať čas učeniu, aby ste automatizovali Google Ads | Google Ads skripty |
| Chcete, aby sa úloha spúšťala podľa plánu bez toho, aby ste boli prihlásení | Google Ads skripty |
| Potrebujete jedným skriptom pracovať so všetkými klientskymi účtami pod manažérskym účtom | skripty manažérskeho účtu |
| Chcete hromadne meniť Google Ads a kód písať nechcete | automatické pravidlá, hromadné nahrávanie alebo Google Ads Editor |
| Analytik chce sťahovať prehľady na ďalšiu analýzu | služba BigQuery Data Transfer |
Hranicu medzi pravidlom a skriptom podrobne rozoberá článok o automatických pravidlách v Google Ads. Jednoducho povedané, ak sa úloha dá poskladať z podmienky a akcie v rozhraní, pravidlo je bezpečnejšia voľba, lebo nikto nemusí čítať ani udržiavať kód. Na jednorazovú hromadnú úpravu stoviek riadkov zase často stačí Google Ads Editor, v ktorom zmeny vidíte pred odoslaním.
Ako skript vložiť do účtu krok za krokom
Najjednoduchší začiatok podľa Pomocníka Google Ads nie je vlastný kód, ale úprava predpripraveného skriptu z knižnice Googlu. Knižnica obsahuje napríklad súhrnný prehľad výkonu účtu, kontrolu funkčnosti odkazov v reklamách alebo testovanie ponúk a tieto skripty môžete použiť tak, ako sú, alebo ich upraviť. Výhodou je, že kód napísal Google a k riešeniam má aj návod na nastavenie, takže neriskujete kód neznámeho pôvodu z diskusného fóra.
Samotné vloženie skriptu do bežného účtu vyzerá podľa Pomocníka Google Ads a dokumentácie pre vývojárov takto:
- V účte Google Ads otvorte ponuku Nástroje, rozbaľte Hromadné akcie a kliknite na Skripty. Stránku nájdete aj tak, že do vyhľadávacieho poľa v Google Ads napíšete „Skripty“.
- Kliknite na tlačidlo plus. V rozbaľovacej ponuke si môžete prezrieť šablóny skriptov alebo zvoľte nový prázdny skript.
- Do poľa Názov skriptu napíšte, čo skript robí. Názov je nepovinný, no pri piatom skripte v účte oceníte, že viete, ktorý posiela e-maily a ktorý mení ponuky.
- Do editora vložte kód JavaScript. Editor ponúka automatické dopĺňanie, pomôcky pre syntax a odsadenie.
- Ak skript ešte nechcete spustiť, kliknite na Uložiť.
- Pri prvej ukážke alebo spustení sa objaví žiadosť o autorizáciu. Kliknite na Autorizovať a potom na Povoliť prístup.
- Kliknite na Ukážka. Výsledky sa zobrazia v paneli Zmeny a Denníky.
- Až keď ste s výsledkom ukážky spokojní, kliknite na Spustiť skript. Otvorí sa stránka História skriptov so stavom a výsledkom behu.
Pri manažérskom účte je postup rovnaký, len kód pracuje s triedou AdsManagerApp a k spusteniu skriptov manažérskeho účtu potrebujete podľa dokumentácie manažérsky účet Google Ads. Ako manažérsky účet zriadiť a prepojiť s klientmi, popisuje článok o správe viacerých účtov cez MCC. Dokumentácia uvádza aj dôležitý detail z praxe správcov: skript manažérskeho účtu pri viacúrovňovej hierarchii nevyberie podradené manažérske účty, ale len klientske účty, a predvolene vynechá zrušené, zatvorené a pozastavené účty.
Ešte pred vložením si skript prečítajte aspoň po riadkoch, ktoré niečo menia. V kóde z knižnice Googlu sú nastavenia zvyčajne na začiatku alebo v pripojenej tabuľke Google, napríklad pri kontrole odkazov sa v tabuľke volí, či skript kontroluje reklamy, kľúčové slová a odkazy na podstránky a či preverí aj pozastavené prvky. Úprava nastavení v tabuľke je bezpečnejšia než zásah priamo do kódu.
Autorizácia: v mene koho skript beží a čo sa stane, keď odíde
Bežný prístup do Google Ads predpokladá, že je používateľ prihlásený a zmeny robí sám. Skripty sú podľa dokumentácie výnimkou, lebo naplánovaný skript beží aj vtedy, keď nikto prihlásený nie je, a keďže beh môže trvať až 30 minút, používateľ sa medzitým mohol odhlásiť. Skript preto koná v mene konkrétneho používateľa a ten mu musí výslovne udeliť povolenie. Autorizácia sa robí raz pre každý skript a Google o ňu požiada znova vždy, keď z akéhokoľvek dôvodu vyprší.
Z toho vyplýva riziko, na ktoré sa pri odovzdávaní účtu často zabúda. Ak pôvodného autora skriptu odpojíte od účtu Google Ads, v ktorom skript vznikol, skript podľa dokumentácie prestane bežať, hoci v zozname ostane. Aby bežal ďalej, musí ho znova autorizovať niekto, kto má k účtu stále prístup. Typická situácia je odchod externej agentúry alebo zamestnanca: kontrola cien či upozornenie na výpadok webu potichu prestane fungovať a nikto si to nevšimne, kým nepríde problém.
- Skripty, ktoré majú bežať dlhodobo, autorizujte pod používateľom, ktorý vo firme ostáva, nie pod dočasným prístupom externistu.
- Pri ukončení spolupráce prejdite stránku Skripty a pri každom aktívnom skripte overte, či ho niekto z firmy autorizoval znova.
- Povolenia udelené skriptom a iným aplikáciám si podľa dokumentácie skontrolujete na stránke Zabezpečenie vášho účtu Google v časti správy prístupu tretích strán.
Pri väčšom počte skriptov narazíte aj na limit. Každý účet má podľa stránky limitov najviac 250 autorizovaných skriptov a po jeho prekročení sa jeden zo skôr autorizovaných skriptov deautorizuje. Ide o dočasný stav, skript sa dá autorizovať znova pri najbližšom otvorení, no ak sa vám to stáva často, Google odporúča autorizovať rôzne skupiny skriptov rôznymi používateľmi.
Režim ukážky: čo naozaj otestuje a čo nie
Režim ukážky je hlavná poistka pred chybou. Podľa dokumentácie pre vývojárov skript v ukážke nemení skutočné dáta kampaní, ale zobrazí zmeny, ktoré by urobil pri ostrom behu, takže kód môžete vyvíjať a ladiť bez obavy z chybných zásahov do účtu. Má však dve obmedzenia, ktoré sa oplatí poznať skôr, než ukážke uveríte naslepo.
| Čo skript robí | V režime ukážky | Pri ostrom spustení |
|---|---|---|
Mení ponuky, pozastavuje kľúčové slová, vytvára reklamy (volania cez AdsApp) | nič sa nezmení, v paneli Zmeny vidíte, čo by sa stalo | zmeny sa vykonajú a nedajú sa vrátiť späť |
Posiela e-mail (služba MailApp) | e-mail sa odošle | e-mail sa odošle |
| Zapisuje do tabuľky Google | tabuľka sa aktualizuje | tabuľka sa aktualizuje |
| Vytvorí prvok a hneď s ním ďalej pracuje | prvok nevznikne, ďalší krok sa správa inak | prvok vznikne a skript pokračuje podľa očakávania |
Prvé obmedzenie teda je, že ukážka chráni len volania, ktoré začínajú cez AdsApp. E-mail klientovi alebo zápis do zdieľanej tabuľky prebehne aj v ukážke, preto pri teste dajte do nastavení skriptu svoju adresu a testovaciu kópiu tabuľky. Dokumentácia ukazuje aj čistejšie riešenie: skript si cez AdsApp.getExecutionInfo().isPreview() zistí, či beží v ukážke, a e-mail v takom prípade neodošle.
Druhé obmedzenie súvisí s tým, že v ukážke nevzniká, nemaže sa ani nemení žiadny objekt. Ak skript najprv vytvorí kľúčové slovo a potom ho v tej istej reklamnej skupine hľadá, v ukážke ho nenájde a ďalšia časť kódu sa zachová inak než pri ostrom behu. Dokumentácia to ukazuje práve na príklade prázdnej reklamnej skupiny, do ktorej skript pridá kľúčové slovo. Pri skriptoch, ktoré prvky vytvárajú, preto ukážku berte ako kontrolu logiky a prvé ostré spustenie obmedzte na malý výsek účtu.
Malý výsek účtu sa v skriptoch najľahšie vymedzí štítkom. Dokumentácia osvedčených postupov odporúča pri mnohých podmienkach označiť spracúvané prvky štítkom a filtrovať podľa neho, lebo je jednoduchšie pridať štítok novému prvku než upravovať skript. Na prvý ostrý beh tak stačí označiť jednu kampaň, napríklad štítkom „skript-test“, a až keď výsledok sedí, rozšíriť štítok na ďalšie kampane. Ako štítky v účte organizovať, popisuje článok o štítkoch v Google Ads a heslo štítky (labels).
Plánovanie, limity a kontrola po spustení
Keď ukážka aj prvý ostrý beh dopadli dobre, môžete skript naplánovať. Pomocník Google Ads uvádza, že skript sa dá spustiť jednorazovo alebo pravidelne každý deň, týždeň či mesiac o určitej hodine. Na stránke Skripty v stĺpci Frekvencia kliknite na ikonu ceruzky, zvoľte dátum, deň týždňa alebo deň mesiaca, nastavte čas a uložte. Hotové riešenia od Googlu pritom často počítajú aj s hodinovým spúšťaním, napríklad skript na kontrolu odkazov má podľa návodu bežať každú hodinu a sám si stráži, kedy začať novú kontrolu všetkých adries.
Pri plánovaní myslite na to, že štatistiky v Google Ads nie sú okamžité. Návod k skriptu na odhaľovanie odchýlok v účte uvádza, že štatistiky môžu meškať až tri hodiny, preto skript spustený o 19.00 pracuje len s údajmi do 16.00. Skript, ktorý ráno o 6.00 porovnáva včerajšie výdavky, je preto spoľahlivejší než skript, ktorý o polnoci hodnotí deň, ktorý sa práve skončil.
Ďalšie obmedzenia určujú, čo skript zvládne v jednom behu. Stránka limitov ich uvádza takto:
| Limit | Hodnota podľa dokumentácie | Čo z toho vyplýva |
|---|---|---|
| Čas behu skriptu v bežnom účte | najviac 30 minút | po zrušení ostanú v účte zmeny urobené do tej chvíle, skript teda môže skončiť v polovici |
Skript manažérskeho účtu s executeInParallel a funkciou spätného volania | až 60 minút, najviac 50 účtov | pri viacerých klientoch spracúvajte účty paralelne, nie jeden po druhom |
| Výsledky jedného iterátora | predvolene najviac 50 000 | počet sa dá zmeniť metódou withLimit() |
| Výstup denníka | skráti sa pri 100 kB | do denníka zapisujte súhrn, nie každý riadok |
| Autorizované skripty na účet | 250 | pri prekročení sa niektorý skôr autorizovaný skript deautorizuje |
Časový limit je najčastejší zdroj nedokončenej práce. Pomocník Google Ads upozorňuje, že pri vypršaní času sa nemusia dokončiť všetky zmeny, a odporúča v denníkoch overiť, či skript dobehol, a ak nie, upraviť ho a spustiť znova. Preto po každom novom skripte prvý týždeň otvárajte Históriu skriptov, kde pri každom behu vidíte čas a stav, a cez odkaz v stĺpci Zmeny sa dostanete k podrobnému zoznamu zmien a k denníku. Skript, ktorý nechcete spúšťať, vypnete v stĺpci Stav cez Možnosti a Deaktivovať, takže ho nemusíte mazať.
Ilustratívny príklad pre slovenský e-shop s 1 200 produktmi: kontrola odkazov z knižnice Googlu sa nastaví na hodinové spúšťanie a v tabuľke na minimálne jeden deň medzi kompletnými kontrolami. Ak skript za jeden beh nestihne preveriť všetky adresy, pokračuje pri ďalšom behu tam, kde skončil, a keď je hotový skôr, ďalšie behy v ten deň hneď skončia. Ak nájde stránku, ktorá nevracia platný kód odpovede, pri zapnutom upozornení pošle e-mail, takže vypredaný produkt so zmazanou podstránkou nezostane platenou reklamou s odkazom do prázdna. Počet produktov v príklade je vymyslený na ukážku nastavenia, nie nameraný.
Poradie, ktoré šetrí nervy: najprv hotový skript z knižnice Googlu, potom ukážka s vlastnou e-mailovou adresou a testovacou tabuľkou, potom ostrý beh len na kampani so štítkom, až potom plán a prvý týždeň denná kontrola Histórie skriptov. Pri odchode človeka, ktorý skripty autorizoval, ich hneď autorizujte znova.
Skript z knižnice Googlu preverí len adresy, na ktoré vedú reklamy, kľúčové slová a odkazy na podstránky. Nefunkčné odkazy a presmerovania na zvyšku webu nájdete prehľadávačom, ktorý prejde stránky odkaz po odkaze, ako to opisuje návod na Screaming Frog SEO Spider.
Chcete automatizovať kontrolu účtu, ale bojíte sa kódu?
Vyberiem s vami skripty, ktoré majú pre váš účet zmysel, otestujem ich v režime ukážky a na jednej kampani a nastavím plán aj upozornenia tak, aby bežali pod vaším používateľom a neprestali fungovať po zmene správcu. Pri modeli „skin in the game“ investujem do vášho marketingu aj vlastný kapitál, takže na návratnosti mi záleží rovnako ako vám.
Zistiť, ako to funguje →Často kladené otázky
Potrebujem vedieť programovať, aby som mohol použiť Google Ads skript?
Na hotový skript z knižnice Googlu programovať nemusíte, stačí ho vložiť, nastaviť a otestovať v ukážke. Dokumentácia pre vývojárov uvádza, že na začiatok stačí základná znalosť JavaScriptu. Ak chcete hromadne meniť účet bez kódu, Google odporúča automatické pravidlá, hromadné nahrávanie alebo Google Ads Editor.
Dá sa zmena, ktorú urobil skript, vrátiť späť?
Nie. Pomocník Google Ads výslovne uvádza, že zmeny skriptov nie je možné vrátiť späť. Preto skript najprv spustite v režime ukážky a prvý ostrý beh obmedzte na malú časť účtu, napríklad na kampaň označenú štítkom.
Pošle skript v režime ukážky e-mail?
Áno. Režim ukážky podľa dokumentácie chráni len volania cez AdsApp, takže e-mail cez MailApp sa odošle a tabuľka Google sa aktualizuje aj v ukážke. Skript si môže metódou isPreview() overiť, či beží v ukážke, a e-mail vtedy neodoslať.
Prečo skript prestal bežať, hoci som ho nemenil?
Častou príčinou je autorizácia. Ak sa autor skriptu odpojí od účtu Google Ads, skript podľa dokumentácie prestane bežať, hoci ostane v zozname, a musí ho znova autorizovať niekto s prístupom. Autorizácia sa môže stratiť aj po prekročení limitu 250 autorizovaných skriptov na účet.
Ako často môžem skript spúšťať?
Pomocník Google Ads uvádza jednorazové spustenie alebo pravidelné spúšťanie každý deň, týždeň či mesiac o určitej hodine a hotové riešenia od Googlu počítajú aj s hodinovým spúšťaním. Rátajte s tým, že štatistiky môžu meškať až tri hodiny.
Čo sa stane, keď skript beží dlhšie než 30 minút?
Google ho zruší. Podľa stránky limitov ostanú v účte všetky zmeny urobené pred zrušením, takže skript môže skončiť v polovici práce. Pomocník Google Ads odporúča v denníkoch overiť, či skript dobehol, a ak nie, upraviť ho a spustiť znova. Skripty manažérskeho účtu s paralelným spracovaním môžu bežať až 60 minút.
Kde zistím, čo skript v účte zmenil?
Na stránke Skripty otvorte Históriu skriptov. Pri každom behu vidíte čas a stav a cez odkaz v stĺpci Zmeny sa dostanete k podrobnému zoznamu zmien a k denníku, do ktorého skript zapisuje. Výstup denníka sa podľa dokumentácie skráti pri 100 kB.
Zdroje a ďalšie čítanie
- Súvisiace články: Automatické pravidlá v Google Ads · Správa viacerých účtov cez MCC · Štítky v Google Ads · Google Ads Editor.
- Pre koho sa skripty hodia, nevratnosť zmien, alternatíva automatických pravidiel, knižnica predpripravených skriptov, postup vloženia a autorizácie, časový limit 30 a 60 minút, plánovanie, História skriptov a deaktivácia: Google Ads Pomocník, O skriptoch Google Ads.
- Odporúčaný nástroj podľa situácie a základná znalosť JavaScriptu ako predpoklad: Google Ads Scripts, Product overview.
- Postup prvého skriptu v bežnom aj manažérskom účte, autorizácia raz pre každý skript, ukážka a stránka História skriptov: Google Ads Scripts, Get started.
- Prečo skript potrebuje autorizáciu, opätovná autorizácia po vypršaní a zastavenie skriptu po odpojení autora od účtu: Google Ads Scripts, Authorization.
- Režim ukážky bez zmien v dátach kampaní, odoslanie e-mailov a zápis do tabuliek aj v ukážke, nevytváranie objektov: Google Ads Scripts, Preview mode.
- Zistenie režimu ukážky metódou isPreview(): Google Ads Scripts, Execution info.
- Časové limity, ponechanie zmien po zrušení, 50 účtov pri executeInParallel, limit iterátora, skrátenie denníka a 250 autorizovaných skriptov: Google Ads Scripts, Limits.
- Výber klientskych účtov v skriptoch manažérskeho účtu a predvolené vynechanie zrušených, zatvorených a pozastavených účtov: Google Ads Scripts, Manager account scripts.
- Filtrovanie spracúvaných prvkov podľa štítka: Google Ads Scripts, Best practices.
- Nastavenia kontroly odkazov v tabuľke, hodinové spúšťanie a pokračovanie kontroly vo viacerých behoch: Google Ads Scripts, Link Checker.
- Oneskorenie štatistík až o tri hodiny: Google Ads Scripts, Account Anomaly Detector.