Przejdź do treści
Biblioteka skilli
Marketing i treści · Automatyzacja

google-ads-scripts

/google-ads-scripts

Wspiera pisanie skryptów Google Ads w JavaScript z AdsApp i GAQL: pauzowanie słów kluczowych, korekta stawek i budżetów, raporty do Arkuszy, alerty mailowe i uruchamianie z konta MCC.

Licencja
MIT
Ostatnia zmiana repozytorium
04.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
8
Skrypty
3
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 04.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 3 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: assets/bid-manager-template.js, assets/campaign-optimizer-template.js, scripts/validators.py

Co robi i kiedy

Wspiera pisanie skryptów Google Ads w JavaScript z AdsApp i GAQL: pauzowanie słów kluczowych, korekta stawek i budżetów, raporty do Arkuszy, alerty mailowe i uruchamianie z konta MCC.

Oryginalny opis (EN)

Google Ads Scripts development - JavaScript run inside the Google Ads UI against the AdsApp API and GAQL. Use when writing a script to pause or enable keywords, adjusting bids or budgets from performance rules, pulling a GAQL report into Google Sheets, monitoring quality scores, alerting on spend or anomalies by email, or running a script across accounts from a manager (MCC) account. Do NOT use for the Google Ads API from Python, REST or gRPC - this covers Ads Scripts only. Do NOT use for Google Apps Script outside Google Ads - use google-apps-script. Do NOT use for Microsoft Ads, Meta Ads or

Jak działa

  1. Steps
  2. Quick start
  3. Gotchas
  4. Validation
  5. References
Sekcje z nagłówków SKILL.md, w oryginale · 63 linii, 626 słów
Podgląd SKILL.md
---
name: google-ads-scripts
description: Google Ads Scripts development - JavaScript run inside the Google Ads UI against the AdsApp API and GAQL. Use when writing a script to pause or enable keywords, adjusting bids or budgets from performance rules, pulling a GAQL report into Google Sheets, monitoring quality scores, alerting on spend or anomalies by email, or running a script across accounts from a manager (MCC) account. Do NOT use for the Google Ads API from Python, REST or gRPC - this covers Ads Scripts only. Do NOT use for Google Apps Script outside Google Ads - use google-apps-script. Do NOT use for Microsoft Ads, Meta Ads or other ad platforms.
---

# Google Ads Scripts

JavaScript that runs in Google Ads (Tools > Bulk actions > Scripts) on the Google Ads API. Selector conditions and reports use GAQL field names (`campaign.status`, `ad_group_criterion.quality_info.quality_score`, `metrics.cost_micros`); Google picks the API version, so scripts do not pin one.

## Steps

1. **Read with the cheapest tool.** Use selectors (`AdsApp.keywords().withCondition(...)`) when you will modify the entities you read. Use `AdsApp.search` or `AdsApp.report` with a GAQL query when you need metrics the `Stats` object lacks (conversion value, ROAS, impression share, quality-score components) or rows across many entities. Done when every metric the script uses comes from a source that actually returns it.

2. **Filter on the server.** Put every filter in `.withCondition()` or the GAQL `WHERE`, add `.forDateRange('LAST_30_DAYS')` (or another relative range) whenever a condition touches `metrics.*`, and cap with `.withLimit()`. Done when no JavaScript `if` re-filters what a condition could have filtered, and no date is hard-coded.

3. **Get the units right.** Entity methods are in account currency (`Stats.getCost()`, `Budget.setAmount(50)`, `keyword.bidding().setCpc(1.25)`); GAQL is in micros (`metrics.cost_micros > 100000000` means 100). Done when every `/ 1000000` divides a GAQL `*_micros` value and nothing else.

4. **Gate every mutation.** Ship with `DRY_RUN = true`, clamp each change (minimum and maximum bid, maximum percentage change per run), skip shared budgets unless intended (`budget.isExplicitlyShared()`), and record what changed to a Sheet or email. Done when a dry run logs exactly the changes a live run would make.

5. **Fit the 30-minute limit.** Collect the IDs to change first, then mutate; fetch entities in bulk with `.withIds([...])` (10,000 per selector). For manager accounts use `AdsManagerApp.accounts().executeInParallel(...)` (50 accounts per call). Done when the run time is bounded by `.withLimit()` or batch size, not account size.

## Quick start

Pause keywords with a low quality score and real spend:

```javascript
const DRY_RUN = true;

function main() {
  const keywords = AdsApp.keywords()
    .withCondition('ad_group_criterion.status = ENABLED')
    .withCondition('ad_group_criterion.quality_info.quality_score < 4')
    .withCondition('metrics.cost_micros > 100000000')   // 100 in account currency
    .forDateRange('LAST_30_DAYS')
    .get();

  let count = 0;
  while (keywords.hasNext()) {
    const keyword = keywords.next();
    Logger.log(`${DRY_RUN ? '[dry run] ' : ''}Pause ${keyword.getText()} (QS ${keyword.getQualityScore()})`);
    if (!DRY_RUN) keyword.pause();
    count++;
  }
  Logger.log(`${count} keywords matched`);
}
```

## Gotchas

- **Removed since 14 July 2025:** `AdsApp.AdCustomizerSource`, `newAdCustomizerSourceBuilder()` and `withOnlyLegacy()` on extension selectors throw sunset errors. Use asset-based customizers (`{CUSTOMIZER.name:default}`) in Responsive Search Ads, set up in the Google Ads UI or API.
- **No campaign creation** from scripts - use Bulk Uploads or the Google Ads API. Expanded Text Ads cannot be created; build Responsive Search Ads.
- **No `getMaxCpc` / `setMaxCpc` / `getReturnOnAdSpend`.** Bids go through `entity.bidding().getCpc()` / `setCpc()`, and ROAS is `metrics.conversions_value / (metrics.cost_micros / 1e6)` from GAQL. Keyword CPC bids only bite under manual CPC.
- **`AdsApp.search` rows are lowerCamelCase** (`row.metrics.costMicros`) even though the query is snake_case; int64 values may be strings, so wrap in `Number()`.
- **Spreadsheets:** there is no active spreadsheet - open by URL or ID. Logs view under the script's run history; output past 100 KB is truncated.

## Validation

`scripts/validators.py` checks campaign names, keyword text (80 characters, 10 words), match types, campaign types, bids, budgets and currency/micros conversion before you hard-code them. Run `python3 "${CLAUDE_SKILL_DIR}/scripts/validators.py"` for a self-test, or import its functions.

## References

- [references/ads-api-reference.md](references/ads-api-reference.md) - read when you need a method signature, a GAQL field prefix for a selector, targeting/bid-modifier calls, manager-account patterns, or the limits table.
- [references/examples.md](references/examples.md) - read when building a keyword pauser, ROAS bid adjuster or Sheets performance export from scratch.
- [references/patterns.md](references/patterns.md) - read when adding day-of-week budget changes or quality-score alerting.
- [references/best-practices.md](references/best-practices.md) - read when reviewing an existing script for filtering, error handling, unit or audit-log problems.
- `assets/bid-manager-template.js` and `assets/campaign-optimizer-template.js` - copy as the starting point for a keyword bid manager or campaign budget optimiser; both default to dry run.
Pliki w paczce (8)
  • SKILL.md 5 KB
  • assets/bid-manager-template.js 14 KB
  • assets/campaign-optimizer-template.js 10 KB
  • references/ads-api-reference.md 13 KB
  • references/best-practices.md 3 KB
  • references/examples.md 4 KB
  • references/patterns.md 2 KB
  • scripts/validators.py 12 KB

Wersje

W bazie nie ma innych skilli o nazwie google-ads-scripts.

Migawka bazy z 13.11.2026 · wersja paczki 16bdee44d59d (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100google-ads
    Odpytuje kampanie, grupy reklam, słowa kluczowe i wydatki Google Ads przez Google Ads API (GAQL searchStream).
  • 100google-ads-analyst
    Analizuje konto Google Ads przez serwer MCP: wydajność, budżety, słowa kluczowe, zmiany i raporty, z gotowymi zapytaniami GAQL.
  • 100google-ads-scripts-rules-writer
    Pisze, wyjaśnia i naprawia skrypty i reguły Google Ads, takie jak limity budżetu czy alerty skoków wydatków.
  • 100gaql-report-builder
    Pisze i poprawia zapytania GAQL do Google Ads z pytania biznesowego, uruchamia je tylko do odczytu i tworzy wersje do BigQuery.
  • 100google-ads-write
    Wprowadza zmiany na koncie Google Ads: pauzowanie kampanii, zmiany budżetów, dodawanie wykluczających słów kluczowych, aktualizację stawek i targetowania, zawsze po załadowaniu tego skilla.
  • 100google-ads-custom-gaql
    Pisze własne zapytania GAQL do Google Ads API, gdy żaden gotowy raport nie zawiera potrzebnych danych, np. danych godzinowych, konwersji według akcji czy danych produktowych Shopping.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.