Space Ads OS

Zarządzaj kampaniami Google, Meta i TikTok
rozmawiając z systemem

Pisz pytania w naturalnym języku — system pobiera dane z Google Ads v24.1, Meta v25.0, TikTok v1.3 i GA4, przygotowuje rekomendacje, a 6 warstw ochrony pilnuje, żeby żadna zmiana nie weszła bez Twojego „TAK". Subskrypcja miesięczna z auto-płatnością, anulujesz w każdej chwili. Self-hosted u Ciebie, na Twoich kluczach API.

Aktywuj subskrypcjęZobacz, co potrafi
Pełna dokumentacja techniczna →

Już od 146,37 zł / miesiąc

Wewnętrznie używane w agencji Space Ads od 2024.

Tak wygląda komenda w praktyce — wpisujesz po polsku, system robi resztę.

claude code · space-ads-os

$ /spaceads-check Plein Outlet

→ pulling Google Ads v24 · 30d window

→ pulling Meta v25.0 · 30d window

→ joining GA4 attribution data

Health score: 76 / 100

Spend yesterday: 2,140 €

⚠ Search Limited by Budget × 2 campaigns

⚠ PMax frequency 5.2× (warning)

Suggested actions: 3 · waiting for your approval ↵

Co dostajesz w pakiecie

  • 22 slash commands
  • 5 wyspecjalizowanych agentów AI
  • 4 kanały: Google Ads, Meta, TikTok, GA4
  • 13 szablonów raportów HTML
  • 6 warstw ochrony przy każdej zmianie
  • Tryb agencyjny — wielu klientów w jednym CLI

Zbudowane i używane operacyjnie w agencji Space Ads

  • 22 komendy Claude Code
  • 5 agentów AI (mutation-reviewer, report-builder, brand-extractor, creative-director, onboarding-coach)
  • 4 kanały reklamowe + GA4
  • 6 warstw ochrony przy każdej mutacji

Problem

Panele reklamowe są coraz bardziej czarną skrzynką, a Twój czas się nie zwiększa

Performance Max i Advantage+ ukrywają decyzje

Google i Meta przesuwają coraz więcej w stronę "powiedz nam cel, my zoptymalizujemy". Tracisz widoczność, gdzie idą pieniądze i które segmenty produktowe ciągną wynik, a które go drenują.

Trzy panele, trzy języki, jeden klient

Codziennie żonglujesz Google Ads, Meta i GA4 — każdy z innymi metrykami atrybucji. Złożenie spójnego raportu zajmuje godziny i kończy się na przełączaniu zakładek.

Strach przed automatyzacją, która "sama coś zepsuje"

Reguły Google Ads i bidding strategies działają, dopóki nie zaczną. Boisz się, że narzędzie zmieni budżet o 200% lub doda BROAD match negative w niewłaściwym miejscu i wywróci kampanię.

Jak to działa

Trzy kroki, każdy pod Twoją kontrolą

System nie podejmuje decyzji za Ciebie. Robi za Ciebie pracę analityczną i wykonawczą — decyzję dalej podejmujesz Ty. Pierwsze uruchomienie to 5-minutowy onboarding rozmową — agent onboarding-coach pyta o branżę, cele i kanały, a wynikiem jest gotowy brief.yaml.

  1. 01
    01

    Pytasz w Claude Code

    Otwierasz terminal i piszesz np. „Sprawdź konto Plein Outlet za marzec" albo „Znajdź zmarnowany budżet w kampaniach Search". System rozumie kontekst, identyfikuje konto i odpowiednie skrypty.

  2. 02
    02

    System pobiera dane i analizuje

    Realne zapytania do Google Ads v24.1, Meta v25.0, TikTok v1.3, GA4 i Merchant Center. N-gram analysis dla search terms Google, hook rate i completion rate dla TikToka, attribution gap GA4 vs panele. Bez ML, bez czarnej skrzynki — czyste reguły, które możesz przejrzeć.

  3. 03
    03

    Zatwierdzasz zmianę, system ją wykonuje

    Każda mutacja przechodzi przez 6-warstwowy safety layer: limity, blokada destrukcji, preview, review agenta mutation-reviewer, weryfikacja po wykonaniu, audit log. Nic nie wchodzi w życie bez Twojego "TAK".

22 slash commands

Każda komenda robi jedną rzecz dobrze

Wpisujesz w Claude Code, system wykonuje, audit log zapisuje. Bez UI, bez paneli — działa od pierwszej komendy.

Diagnostyka

  • /spaceads-checkAudyt 360° wybranego konta — 19 sekcji, health score 0–100
  • /spaceads-overviewStan wszystkich kanałów klienta na jednym ekranie
  • /spaceads-monitorDaily alert check: learning limited, budget pacing, drift ROAS
  • /spaceads-changesCo i kiedy zmieniło się w ostatnich N dniach (per kanał)

Strategia

  • /spaceads-strategyPlan optymalizacji na 30 dni z priorytetami i KPI
  • /spaceads-keyword-researchN-gram + intent analysis, propozycje negatywów
  • /spaceads-geoPerformance per region (HHI), wykluczenia geo

Strategiczne

  • /spaceads-grow90-dniowy review strategiczny — 4-fazowy Socratic, hipotezy ranked, roadmap 3/6/12 mc
  • /spaceads-bucketingPMax: podział feedu na 4 tier (Platinum/Gold/Silver/Bronze)
  • /spaceads-seasonalLuki sezonowe — kategoria w peak, a Ty jej nie promujesz
  • /spaceads-cadenceCo zaległe / planowane na dziś — wszystkie zadania review per klient
  • /spaceads-intelTygodniowy digest branżowy: Reddit + top blogi PPC + Google releases

Mutacje

  • /spaceads-modifyZmiana z preview, reviewer i confirm — bez „a, zapomniałem"
  • /spaceads-createNowa kampania / ad set / negative list z playbooka branżowego

Raporty

  • /spaceads-reportHTML w branding klienta — 13 szablonów do wyboru
  • /spaceads-ga4Attribution gap GA4 vs panele, landing page health

Brand + creative

  • /spaceads-brandWyciąga logo, paletę, fonty i głos ze strony klienta
  • /spaceads-briefPodgląd / edycja / reload brief.yaml + voice.md aktywnego klienta
  • /spaceads-creativeWireframe z safety zones + walidator gotowych assetów

Admin

  • /spaceads-onboard5-minutowy setup rozmową — operator + pierwszy klient
  • /spaceads-clientlist / switch / add — wielu klientów w jednym CLI
  • /spaceads-agencyCross-client rollup spendu, ROAS i alertów

Google Ads

Pełny zestaw narzędzi pod aktualne API v24.1

17+ skryptów mutacji + diagnostyka, atrybucja, monitoring multi-account dla Google Ads API v24.1. Każdy z konkretnym celem, każdy do uruchomienia jedną komendą. Wsparcie v24.1: iOS vs Android (segments.mobile_device_platform), frequency-of-reach (unique_users_*_plus), eksperymenty z bezpośrednimi statystykami (point estimate, MoE, p-value) i bramkowane mutacje PMAX_REPLACEMENT_SHOPPING.

  • Audyt 360° konta

    19 sekcji diagnostyki w jednym przebiegu: struktura kampanii, słowa kluczowe, tracking, quality score, ustawienia konta, alerty learning phase. Wynik z health score 0–100.

    google_ads.scripts.full_audit

  • Search terms i bezpieczne negatywy

    N-gram analysis (1/2/3 słów) wykrywa wzorce zmarnowanego budżetu na poziomie statystyki, nie pojedynczych zapytań. Sugeruje negatywy w PHRASE i EXACT — BROAD match jest hardkodowo zablokowany.

    google_ads.scripts.search_terms_analyzer

  • Shopping + Merchant Center

    Product-level ROAS z podziałem Stars / Workers / Zombies / Draggers. Diagnostyka feedu (błędy, brakujące pola, policy violations) przez Merchant Center Content API v2.1.

    google_ads.scripts.feed_optimizer + google_ads.merchant_center

  • Performance Max — pełen wgląd

    Breakdown SEARCH / CONTENT / YOUTUBE / DISCOVERY per asset group. Wykluczenia gender (v24), retail filter shared sets (v24), VTC toggle. iOS vs Android per kampania (v24.1, segments.mobile_device_platform). To, czego sam panel nie pokazuje.

    google_ads.scripts.pmax_channel_performance + device_performance

  • Cart data — co kupują, co dokładają

    Nowy widok z Google Ads v24: lead_revenue (produkt, który przyciągnął klik) vs cross_sell_revenue (co dosypał do koszyka). Kluczowe dla e-commerce z szerokim asortymentem.

    google_ads.scripts.cart_data_analysis

  • Bidding (tROAS / tCPA) z guardrails

    Zmiana target ROAS w zakresie 0,5×–20×, max ±30% per zmiana. Preview pokazuje historię ROAS kampanii, system blokuje skoki, które wybiją learning phase.

    google_ads.scripts.update_troas

  • Geo, device, daypart

    Wydajność per kraj (z indeksem koncentracji HHI), per urządzenie, per godzina dnia. Identyfikuje wasted spend po regionach i porach, sugeruje wykluczenia geo.

    google_ads.scripts.geo_analysis + google_ads.scripts.device_performance

  • Attribution gap GA4

    Konfrontuje kliknięcia z Google Ads z sesjami w GA4. Pokazuje, gdzie ścieżka konwersji się rozjeżdża (utracone parametry UTM, problemy z tagiem, multi-domain). Plus landing page health: bounce, engagement, czas sesji per kampania.

    google_ads.ga4_helper + google_ads.scripts.landing_page_check

  • Monitoring i alerty

    Daily alert check pod całym MCC: learning limited, budget pacing off, drastyczna zmiana ROAS, brak spendu, suspension risk. Email digest, JSONL audit trail, opcjonalnie integracja przez webhook.

    google_ads.scripts.alert_check + google_ads.scripts.campaign_watchdog

  • Frequency-of-reach (v24.1)

    Nowy widok z Google Ads v24.1: unique_users_two_plus … ten_plus na poziomie konta. Pokazuje, ilu unikalnych użytkowników widziało reklamę 2×, 3×, 5×, 10×. Diagnostyka flaguje thin frequency (<30% widzi 2×), sweet-spot (avg 3–5, 5+ udział 40–65%) i saturation (≥20% widzi 10×). Domyka warstwę reach × frequency w raporcie brand awareness.

    google_ads.scripts.frequency_reach

  • Eksperymenty: bezpośrednie statystyki + bramkowane shippowanie (v24.1)

    PMAX_REPLACEMENT_SHOPPING + 6 pozostałych nowych typów eksperymentów z v24.1. Skrypt experiment_stats czyta point estimate, margin of error i p-value dla 7 metryk (ROAS change, conversions, cost, CPA, …) prosto z API. Bramkowane mutacje end_experiment (rollback) i graduate_experiment (ship) blokują się przed wywołaniem API, jeśli któryś z trzech progów nie przechodzi: ≥14 dni runtime, ROAS p ≤ 0.05, uplift ≥ +5%.

    google_ads.experiments + scripts.experiment_stats + mutations.graduate_experiment

Meta Ads

Diagnostyka, optymalizacja i bezpieczne zmiany dla Facebook + Instagram

5 skryptów mutacji + diagnostyka, recommendation engine i blended GA4 dla Marketing API v25.0. Czytasz, optymalizujesz i wykonujesz zmiany w jednym miejscu — z mandatory confirm wrapper, który nie pozwoli wykonać niczego bez Twojej akceptacji.

  • Insights z trzech poziomów

    Campaign / AdSet / Ad — wszystko dostępne w jednym przebiegu. Akcje ekstrahowane z tablicy actions[], policzone CPA/ROAS/CTR z dokładnością do typu konwersji (Purchase, Lead, custom).

    insights.py + analysis.py

  • Diagnostyka i alerty

    Reguły progowe na frequency cap, CPA, CTR, ROAS — z poziomami CRITICAL / WARNING / INFO. Wykrywa kampanie w stagnacji learning, frequency ≥2.5× (warning) i ≥4× (critical), drift ROAS poniżej targetu.

    diagnostics.py

  • Recommendation engine

    Realokacja budżetu między adsets na podstawie mediany ROAS, sugestie tuningu frequency, identyfikacja audiences do testu. Każda rekomendacja z liczbami i uzasadnieniem.

    optimization.py

  • Blended Meta + GA4

    Łączenie insights Meta z GA4 po nazwie kampanii. Pokazuje, ile konwersji Meta liczy "u siebie", a ile GA4 widzi naprawdę po stronie sklepu — czyli prawdziwy attribution gap, nie spór o pixela.

    blended.py

  • Bezpieczne zmiany kampanii

    Pause / update budget / update ROAS target — z mandatory .confirm() wrapper. Nigdy delete (operacja zablokowana). Limity: budżet max ±30% per zmiana, odstęp 3–5 dni między tuningami.

    campaigns.py + adsets.py + safety.py

  • Trendy WoW / MoM i anomalie

    Tygodniowe i miesięczne porównania ze statystycznym wykrywaniem anomalii. Wskazuje, czy spadek to sezon, weekend, czy faktyczny problem z kampanią.

    trends.py

TikTok Ads

Pełna integracja z TikTok Business API v1.3

4 skrypty mutacji + diagnostyka kreacji, Smart+ migration i CAPI z EMQ dla TikTok Business API v1.3. Mutacje przez ten sam wzorzec dry-run + .confirm() co w Meta.

  • Insights na 4 poziomach

    Advertiser / Campaign / AdGroup / Ad — plus breakdown godzinowy. Domyślnie 26 metryk: spend, conversions, total_purchase_value, video_watched_2s, video_views_p100, ROAS, CPA, CTR. Wszystko z jednego endpointu /report/integrated/get/.

    insights.py + analysis.py

  • Diagnostyka kreacji TikToka

    Metryki, które TikTok faktycznie nagradza: hook rate (próg 30%), completion rate (próg 10%), frequency fatigue (warning 2.5×, critical 3.5×), creative decay po 10 dniach. Alerty z severity CRITICAL / WARNING / INFO.

    diagnostics.py + rules.py

  • Smart+ migration według reguł

    Sprawdza, czy kampania spełnia warunki Smart+: min. 50 konwersji/tydzień, EMQ ≥ 6 dla Pixela, 6+ wariantów kreacji, ROAS w przedziale ±15%. Jeśli tak — przygotowuje migration plan; jeśli nie — wskazuje, czego brakuje.

    optimization.py

  • Pixel + Events API (CAPI)

    Pełna obsługa server-side: POST /event/track/ z hashowaniem SHA-256 dla email/phone/external_id, dedup window 5 min, walidacja Event Match Quality (cel ≥ 6, ostrzeżenie poniżej 5). Smart+ i VBO wymagają Pixel + CAPI razem.

    pixel.py

  • Bezpieczne mutacje + bulk

    pause / resume / update_budget / update_bid — każda przez PendingAction z dry_run domyślnie. Limity: budżet ±30%, bid ±25%, min. 3 dni między zmianami w learning, blokada delete. Dla wielu kampanii naraz: bulk_pause_campaigns().

    campaigns.py + adgroups.py + safety.py

  • Async reports + GA4 blended

    Raporty powyżej 180 dni / 10k wierszy idą przez async flow (create → poll → download). Plus blended.py: merge insights TikToka z GA4 po nazwie kampanii — prawdziwy attribution gap między „TikTok mówi" a „GA4 widzi".

    reports_async.py + blended.py

GA4 + multichannel attribution

Jedna prawda po stronie sklepu, nie trzy spory o pixela

GA4 czyta read-only — system łączy go z Google Ads, Meta i TikTokiem po nazwie kampanii i pokazuje, kto naprawdę przyniósł konwersje.

  • Attribution gap GA4 vs panele

    Pokazuje różnicę między tym, co Meta liczy „u siebie", a co GA4 widzi w Twoim sklepie. Pixel argument zamknięty liczbami.

    multichannel.attribution_compare

  • Landing page health

    Bounce, engagement rate, czas sesji per kampania. Wyłapuje LP, które ciągną CPA w górę bez Twojej wiedzy.

    ga4.scripts.landing_page_quality

  • Cross-channel blended view

    Google + Meta + TikTok + GA4 w jednym CSV/HTML — wreszcie ujednolicona atrybucja w raporcie tygodniowym.

    multichannel.attribution_compare + multichannel.overview

Bezpieczeństwo

Sześć warstw, które pilnują, żeby nikt niczego nie zepsuł

To nie jest „AI nadzór". To deterministyczne reguły zaszyte w kodzie plus jeden wyspecjalizowany agent review — działają tak samo w piątek o 17:00 i w niedzielę o 03:00.

  1. 01Layer 01

    Guardrails

    Twarde limity wpisane w kod: budżet max ±30% per zmiana, target ROAS w zakresie 0,5×–20×, BROAD match negatives zablokowane bezwarunkowo, blokada zmian na kampaniach w learning phase.

  2. 02Layer 02

    Destruction blocker

    Operacje REMOVE są zablokowane na poziomie API client. Nie ma komendy, która usunie kampanię, ad group czy keyword — nawet przez przypadek, nawet z pełnym dostępem.

  3. 03Layer 03

    Preview każdej zmiany

    Zanim cokolwiek pójdzie do API, widzisz dokładnie: jaki obiekt, jakie pole, z jakiej wartości na jaką, jaki szacowany wpływ na spend.

  4. 04Layer 04

    Agent mutation-reviewer (AI review)

    Wyspecjalizowany agent Claude Sonnet czyta plan zmiany w kontekście historii kampanii i playbooka, zwraca werdykt: APPROVE / WARN / BLOCK. WARN podświetla ryzyko, BLOCK fizycznie blokuje wykonanie. To jedyny moment, w którym AI ocenia coś samodzielnie — i robi to przed Twoim potwierdzeniem, nie zamiast niego.

  5. 05Layer 05

    Post-mutation verification

    Po wykonaniu zmiany system robi read-back z API. Jeżeli wartość po nie zgadza się z oczekiwaną, zmiana jest oznaczona jako niepełna, a Ty dostajesz alert.

  6. 06Layer 06

    Audit log

    Każda mutacja ląduje w logs/changes.jsonl: kto, kiedy, na czym, z jakiego stanu na jaki, z jakim uzasadnieniem, z werdyktem reviewera. Pełen audit trail — przydatny przy każdej rozmowie z klientem.

Plus mandatory .confirm() na zmianach Meta i 15-minutowy GAQL cache na zapytaniach Google Ads (oszczędza limit API i przyspiesza powtarzalne raporty).

Agenci AI

Pięciu wyspecjalizowanych agentów Claude, nie jedna ogólna rozmowa

Każdy agent ma jeden kawałek pracy, na którym jest dobry. Główny Claude Code orkiestruje — agenci wykonują, każdy w swoim własnym kontekście.

  • mutation-reviewer

    Czyta każdą planowaną zmianę w kontekście historii kampanii i playbooka, zwraca APPROVE / WARN / BLOCK. Niezależny review przed Twoim „TAK".

    agents/mutation-reviewer.md

  • report-builder

    Generuje raporty HTML w branding klienta — executive summary, e-commerce, lead-gen, brand awareness, social engagement, content analysis, local. Gotowe do wysłania mailem.

    agents/report-builder.md

  • brand-extractor

    Wchodzi na stronę klienta, wyciąga logo, paletę, fonty i tone-of-voice, zapisuje do brief.yaml.brand_system. Onboarding bez ręcznego briefu.

    agents/brand-extractor.md

  • creative-director

    Bierze brief i wireframe, weryfikuje safety zones per platforma (Meta Stories/Reels/Feed, Google Display 5 aspect ratios, TikTok in-feed), zwraca specyfikację gotową do produkcji.

    agents/creative-director.md

  • onboarding-coach

    Prowadzi 5-minutowy onboarding rozmową — pyta o branżę, cele, kanały, klientów, generuje brief.yaml. Uruchamiany SessionStart hookiem.

    agents/onboarding-coach.md

Raporty

13 szablonów HTML w branding klienta — gotowe do wysłania

Brand-styled (logo, paleta, fonty z brief.yaml.brand_system), responsywne, z wbudowanym komentarzem i CTA. Generujesz komendą /spaceads-report.

  • Executive summary

    HTML, brand-styled

    Top-level KPIs, trendy WoW/MoM, 3 najważniejsze rekomendacje. Dla decision makera, nie performance specialisty.

  • E-commerce performance

    HTML, brand-styled

    ROAS per kanał, top SKU, Stars/Workers/Zombies/Draggers, attribution gap GA4. Twardy raport dla sklepu.

  • Lead generation

    HTML, brand-styled

    CPL, MQL→SQL pipeline, source quality scoring, cost per stage. Optyka B2B.

  • Brand awareness

    HTML, brand-styled

    Reach, frequency, view-through, brand search lift, share of voice. Dla kampanii TOFU.

  • Social engagement

    HTML, brand-styled

    Hook rate, completion rate, saves, shares, comments sentiment. TikTok i Instagram-first.

  • Content analysis

    HTML, brand-styled

    Performance per format kreacji (UGC vs studyjne, statyk vs wideo, hook style). Co produkować dalej.

  • Local business

    HTML, brand-styled

    Per-lokalizacja: ROAS, CPC, geo coverage, store visit conversions. Dla multi-location i franczyzy.

  • Growth roadmap

    HTML, brand-styled

    Flagship deliverable strategicznego review — snapshot KPI, 7-osiowa siatka decyzji, ranked backlog hipotez (impact × evidence ÷ effort), 12-tygodniowy Gantt, milestones 6/12 mc. Wynik komendy /spaceads-grow.

  • PMax bucketing proposal

    HTML, brand-styled

    Pitch dla klienta przed launchem 4-tier struktury PMax — karty per tier z proponowanym budżetem i tROAS, treemap dystrybucji produktów, donut alokacji budżetu, 6-krokowy migration plan, ryzyka + rollback.

  • Experiment verdict (v24.1)

    HTML, brand-styled

    Werdykt po pilocie PMAX_REPLACEMENT_SHOPPING — badge SHIP / HOLD / ROLL BACK, paski 95% confidence interval per metryka, tabela p-value, gate-checklist (≥14 dni, p ≤ 0.05, uplift ≥ +5%), trend ROAS challenger vs incumbent i gotowy fragment kodu wywołania mutacji graduate_experiment().

  • Competitive landscape

    HTML, brand-styled

    Deliverable z auction insights — trend share of voice (12 tyg., 4 rywali), matryca konkurentów (impression share, overlap, position-above-rate, top-of-page, outranking share), bid posture per cluster, rekomendowane ruchy bidowe.

  • Feed health

    HTML, brand-styled

    Zdrowie Merchant Center: macierz halo-effect STAR / MAGNET / DRIVER / NICHE z v24 cart_data_sales_view, tablica wyników Stars / Workers / Zombies / Draggers, rozkład disapprovals z health-bars, audyt completion pól i top Magnet SKU do dodania do Platinum.

  • Seasonal calendar

    HTML, brand-styled

    Mapa cieplna kategoria × tydzień na 90 dni z 5 statusami (peak / shoulder / running / gap-peak / gap-shoulder), karty priority gaps z revenue-at-risk i asset SLA, shoulder gaps, donut coverage i timeline asset prep.

Brand + creative pipeline

Od strony klienta do gotowej specyfikacji kreacji

Cztery kroki, każdy z własnym agentem lub komendą. Bez „wyślij mi PDF z księgą znaku" i bez 24h bana po review.

  1. 01

    Brand extract

    Agent brand-extractor pobiera logo, paletę, fonty i głos z URL klienta i zapisuje do brief.yaml.brand_system. Bez ręcznego briefingu.

  2. 02

    Brief

    /spaceads-brief generuje brief kreatywny pod cel kampanii — hook angles, value props, proof points, CTA — w głosie marki, nie w korpomowie.

  3. 03

    Wireframe

    Agent creative-director składa wireframe per format (Meta Story 1080×1920, Reel, Feed 1:1, Google Display 5 ratios, TikTok in-feed 9:16) z bezpiecznymi strefami i miejscami na text overlay.

  4. 04

    Validator

    Sprawdza, czy wymiary, safe-zone, contrast i text-on-image % są zgodne z polityką platformy. Co nie przejdzie review — wraca do iteracji od razu, nie po 24h banie.

Tryb agencyjny

Wielu klientów, jedno CLI, izolowane audit logi

Każdy klient ma własny brief.yaml, własny voice.md, własny logs/changes.jsonl. /spaceads-agency dorzuca rollup cross-client — bez mieszania danych.

  • clients/registry.yaml — jedno źródło prawdy o aktywnych klientach
  • Per-klient brief.yaml: cele, ICP, voice, brand_system, vertical playbook
  • Per-klient credentials/ — Twój Google Ads token, Meta business, TikTok account są od siebie odseparowane
  • Per-klient logs/changes.jsonl — pełen audit trail dla każdego klienta osobno (RODO-friendly)
  • /spaceads-agency — cross-client rollup spendu, ROAS, alertów, do tygodniówki agencyjnej
clients/registry.yaml
clients:
  - id: plein-outlet
    name: Plein Outlet
    vertical: dtc-ecommerce
    channels: [google, meta, ga4]
  - id: acme-saas
    name: Acme SaaS
    vertical: b2b-saas
    channels: [google, meta]

Playbooki branżowe

Pięć branż, pięć różnych zestawów reguł

System wybiera wzorce optymalizacji pod Twoją branżę — tROAS targets, conversion lag, bidding strategy presety, struktura kampanii.

  • DTC e-commerce

    PMax + Shopping + Search brand. Stars/Workers/Zombies/Draggers segmentation. Cross-sell tracking. Conversion lag 3–7 dni.

  • Lead generation B2C

    Conversion ladder MQL→SQL, source quality scoring, lead value per stage. Conversion lag 7–14 dni.

  • B2B / SaaS

    Long sales cycle (14–30+ dni), MQL→SQL→Opportunity tracking, brand search incrementality, LinkedIn jako placeholder.

  • Mobile app

    Install→engage→retain funnel, AppsFlyer/Adjust integration, in-app event optimization, ARPU targets.

  • Local / multi-location

    Per-lokalizacja geo, store visit conversions, lokalne Search, Google Business Profile signals.

Wgrana wiedza

Wzorce optymalizacji, które działają — zaszyte w produkt

Plik knowledge/patterns.md to skrót doświadczeń zespołu z prowadzenia kampanii. System odwołuje się do tych wzorców automatycznie, ale możesz je też przeczytać i dostosować pod swój biznes.

  • tROAS ramp-up

    Jak bezpiecznie podnosić target ROAS bez zabijania learning phase: max ±30% co 5–7 dni, monitoring window minimum 14 dni, oczekuj spadku liczby konwersji w pierwszych 3 dniach po zmianie.

  • Meta Andromeda — full-funnel na poziomie ad seta

    Andromeda optymalizuje na poziomie ad seta, nie pojedynczych kreacji. Spend rozkłada się intencjonalnie nierówno — jeden ad bierze często 60–80% budżetu. Oceniasz portfel ad seta jako całość, nie pauzujesz po metrykach pojedynczej kreacji. Testuj 10+ konceptualnie odmiennych kreacji, nie wariacje tej samej.

  • Conversion lag awareness

    E-commerce: 3–7 dni od kliknięcia do realnej konwersji. B2B / lead gen: 14–30 dni. System nie panikuje, gdy „dzisiejszy" ROAS jest niski — wie, kiedy ocenić wynik.

  • PMax vs Search ROAS comparison

    Jak porównać Performance Max i Search uczciwie, gdy PMax kanibalizuje search brand: wymuszenie breakdown SEARCH-only, korekty na brand traffic, real incremental ROAS.

  • Learning-phase respect

    Kampania w learning to święta krowa: ±30% to absolutny limit zmiany, brak edytowania creative, brak zmian audiences, ad scheduling tylko w trybie ekstremalnym.

Porównanie

Ręcznie vs ze Space Ads OS

Konkrety, nie obietnice. Czas mierzony przy obsłudze średniego konta e-commerce z PMax + Search + Shopping i równoległą kampanią Meta.

  • Codzienny health check konta
    45–60 min (4 zakładki, ręczne porównania)
    2–5 min (jedna komenda, alerty z severity)
  • Tygodniowy raport dla klienta
    2–3 h (eksport, scalanie, formatowanie)
    15–25 min (auto-generated digest + komentarz)
  • Znalezienie zmarnowanego budżetu w search
    2–4 h analizy w Google Sheets
    30 sek (N-gram analysis na 90 dni)
  • Konsolidacja Google + Meta + GA4
    3 panele, 3 atrybucje, ręczne dopasowanie
    Jeden raport blended z attribution gap
  • Bezpieczna zmiana tROAS na 5 kampaniach
    15–20 min + ryzyko ludzkiej pomyłki
    60 sek z preview, reviewerem i audit log
  • Sprawdzenie zdrowia feedu produktów
    Otwarcie Merchant Center + ręczne kategoryzowanie
    Lista błędów + wpływ na spend per kategoria

Co dostajesz

Co dostajesz w subskrypcji

  • Pełny dostęp do CLI i wszystkich modułów

    Kompletne CLI Space Ads OS — wszystkie skrypty Google Ads, moduły Meta, integracja TikTok, GA4 i Merchant Center. Aktualizujesz jedną komendą, działa na własnej infrastrukturze.

  • 22 slash commands + 5 agentów AI

    Pełen katalog komend i agentów Claude — od /spaceads-check po /spaceads-agency, w tym mutation-reviewer i creative-director. Bez UI, bez paneli — działa od pierwszej komendy.

  • 13 szablonów raportów HTML

    Executive summary, e-commerce, lead-gen, brand awareness, social, content analysis, local, growth roadmap, bucketing proposal, experiment verdict (v24.1), competitive landscape, feed health, seasonal calendar. Brand-styled z brief.yaml.brand_system. Generujesz komendą, otwierasz w przeglądarce, wysyłasz mailem.

  • Aktualizacje wliczone w cały okres subskrypcji

    Każda nowa wersja API (Google v24→v24.1→v25, Meta, TikTok), każdy nowy playbook, agent i template raportu trafia do Ciebie automatycznie tak długo, jak utrzymujesz aktywną subskrypcję. Ostatni bump v24.1 dorzucił mobile_device_platform, frequency-of-reach, eksperyment stats i bramkowane mutacje — bez ekstra opłat.

  • Email support, dopóki masz subskrypcję

    Pierwsze 30 dni — onboarding priority. Później standardowy SLA: dni robocze, do 24h. Setup OAuth, debug API, pomoc przy migracjach API (v24 → v24.1 → v25).

  • Faktura VAT co miesiąc

    Pełna faktura natychmiast po pobraniu opłaty — w PL z VAT 23%, dla UE B2B z VAT-EU reverse charge, dla spoza UE bez VAT (eksport).

Cena

Subskrypcja miesięczna, self-hosted

Płacisz raz w miesiącu, automatycznie. Anulujesz w każdej chwili z panelu — kolejne odnowienie nie obciąży karty. Bez per-seat, bez per-konto, bez ukrytych kosztów.

Space Ads OS

Subskrypcja miesięczna z auto-płatnością

146,37 zł/ miesiąc

cena brutto

  • Pełen dostęp do CLI i wszystkich modułów
  • 22 slash commands + 5 agentów AI
  • 13 szablonów raportów HTML
  • Wszystkie aktualizacje API w okresie subskrypcji
  • Tryb agencyjny — wielu klientów, izolowane audit logi
  • Email support, dopóki subskrypcja jest aktywna
  • Faktura VAT co miesiąc
  • Anulujesz w każdej chwili — bez kar, bez prorate
Aktywuj subskrypcję

Pierwsza opłata pobierana od razu po wypełnieniu formularza. Kolejne — co miesiąc tego samego dnia, automatycznie z zapisanej karty. Anulacja w panelu academy.spaceads.agency/account/subscription zatrzyma kolejne odnowienie; bieżący cykl działa do końca. Self-hosted u Ciebie. Wymaga własnych: Google Ads developer token, aplikacji Meta, service account GA4. Po anulowaniu CLI przestaje wykonywać komendy w kolejnym cyklu — Twoje dane, klucze i konta zostają nienaruszone na dysku.

Cena brutto, miesięcznie. Faktura VAT 23% wystawiana co miesiąc po pobraniu opłaty.

Wariant agencyjny

Space Ads OS Agency — 5 specjalistów w cenie

Wszystko, co dostajesz w Solo, plus możliwość zaproszenia 5 specjalistów do jednej licencji. Każdy ma własny seat token, własny audit log, ale dostęp do wszystkich Twoich workspace'ów. Kolejne miejsca dokupisz w panelu, anulujesz w każdej chwili.

Space Ads OS Agency

5 miejsc w cenie

Subskrypcja miesięczna z auto-płatnością

599,00 zł/ miesiąc

cena brutto

Dodatkowe miejsce: 99,00 zł / miesiąc

  • Wszystko z Solo — 22 komendy, 5 agentów AI, 13 raportów
  • 5 specjalistów w cenie (zaproszenia po e-mailu)
  • Dodatkowe miejsce: doliczane do faktury
  • Nieograniczona liczba workspace'ów / klientów
  • Per-seat audit log + identyfikacja w mutacjach
  • Multi-client roll-up (/spaceads-portfolio)
  • White-label raporty — wspólne lub per-klient
  • Anulujesz / zwalniasz seats w każdej chwili
Aktywuj wersję Agency

Pierwsza opłata pobierana od razu po wypełnieniu formularza. Dodatkowe miejsca dokupisz w panelu — każde zwiększa kolejną fakturę. Wszystkie pozostałe warunki identyczne jak w Solo: self-hosted, własne klucze API, anulujesz w każdej chwili z academy.spaceads.agency/account/subscription, audit log + dane na dysku zostają nienaruszone po anulowaniu.

FAQ

Pytania, które najczęściej dostajemy

  • Czy muszę umieć kodować?
    Nie musisz pisać kodu, ale musisz umieć obsługiwać terminal. Codzienna praca to wpisywanie komend w Claude Code (np. /spaceads-check). Setup wymaga jednorazowego wklejenia kluczy do plików konfiguracyjnych — krok po kroku w dokumentacji. Jeżeli kiedykolwiek instalowałeś gita albo Pythona, dasz radę.
  • Czy potrzebuję Claude Code?
    Tak — Space Ads OS działa jako toolkit, który orkiestruje Claude Code. Claude Code jest darmowy do pobrania od Anthropic, działa na macOS, Linux i Windows. Pierwsza instalacja zajmuje ok. 5 minut, instrukcja w pakiecie.
  • Czy potrzebuję Google Ads developer token?
    Tak. Każdy, kto wywołuje Google Ads API, musi mieć własny developer token na poziomie Basic (max 15k operacji/dzień, wystarczy dla pojedynczego operatora) albo Standard. Token wystawia się **z poziomu Manager Accountu (MCC)** — nie ze zwykłego konta Google Ads. Aplikacja przez TOOLS → API Center w MCC, akceptacja 1–2 dni roboczych. W pakiecie jest checklist co wpisać w formularzu.
  • Co jeśli nie mam Manager Account (MCC), tylko zwykłe konto Google Ads?
    Trzeba założyć MCC — Google nie wystawia developer tokenów ze zwykłych kont, niezależnie czy zarządzasz 1 czy 50 klientami. Setup darmowy, ~10 minut: ads.google.com/aw/accounts/managers/ → Create manager account → Use case "Manage my own accounts" jeśli solo, "Manage other accounts" jeśli agencja. Potem podlinkuj swoje istniejące konto Google Ads do MCC (Sub-account settings → Link existing account, wpisujesz 10-cyfrowy Customer ID). Z poziomu MCC wnioskujesz o developer token. Setup-wizard CLI prowadzi krok po kroku.
  • Czy mogę uruchomić tylko jedną platformę — np. sam Google?
    Tak. Każdy moduł działa niezależnie. Jeżeli prowadzisz tylko Google Ads, używasz tylko skryptów Google Ads. Meta i TikTok włączasz dopiero po wpięciu odpowiednich kluczy (Marketing API dla Meta, TikTok Business app + OAuth dla TikToka).
  • Czy obsługujecie TikTok Ads?
    Tak — pełna integracja z TikTok Business API v1.3: insights na 4 poziomach, diagnostyka kreacji z hook rate i completion rate, Smart+ migration, Pixel + Events API z EMQ, bezpieczne mutacje, async reports. Część endpointów v2 (/dmp/, /pixel/, /event/track/, /spark/) wymaga weryfikacji ścieżki przy pierwszym realnym wywołaniu — to jest jasno zaznaczone w dokumentacji w pakiecie.
  • Co jeśli system zepsuje moją kampanię?
    Sześć warstw ochrony jest po to, żeby tego nie zrobił: limity ±30%, blokada destrukcji, preview, agent mutation-reviewer (APPROVE/WARN/BLOCK), weryfikacja po wykonaniu, audit log. Plus każda zmiana czeka na Twoje zatwierdzenie. Jeżeli mimo to coś pójdzie nie tak — w logach masz dokładny stan przed i po, więc rollback to 1 komenda.
  • Co z aktualizacjami API? Google wydaje v25.
    Aktualizacje API są wliczone tak długo, jak utrzymujesz aktywną subskrypcję. Pinujemy stabilne wersje (obecnie Google v24.1, Meta v25.0, TikTok v1.3) i wypuszczamy update, gdy nowa wersja przynosi znaczące funkcje albo gdy stara wchodzi w deprecation. Bumpa do v24.1 (eksperymenty z bezpośrednimi statystykami, frequency-of-reach, mobile_device_platform) wjechał bez ekstra opłat — tak samo będzie z v25.
  • Co z bezpieczeństwem moich danych?
    System jest self-hosted u Ciebie. Klucze API zostają na Twoim dysku (credentials/, gitignored). Nikt z zewnątrz nie ma dostępu do Twoich kont — Space Ads nie widzi Twoich danych, bo nic nigdzie nie wysyłamy. To istotna różnica wobec narzędzi SaaS, gdzie agencja musi udostępnić MCC stronie trzeciej.
  • Czy działa na Mac, Windows i Linux?
    Tak. Python 3.10+, działa natywnie na macOS, Linux i Windows.
  • Co się dzieje po anulowaniu subskrypcji?
    Anulujesz w panelu academy.spaceads.agency/account/subscription. Bieżący cykl dochodzi do końca — w tym czasie CLI działa normalnie. Po końcu cyklu CLI przestaje przyjmować komendy. Wszystkie Twoje dane, audit logi, brief.yaml i credentials/ pozostają nienaruszone na Twoim dysku — to tylko CLI się blokuje. Wracasz w dowolnym momencie reaktywując subskrypcję, bez ponownego onboardingu.
  • Gdzie mogę zobaczyć pełną dokumentację przed zakupem?
    Pełna dokumentacja techniczna dostępna jest pod /space-ads-os/docs — kompletna lista 22 komend, 5 agentów, 13 raportów, specyfikacja kreacji per platforma i 6 warstw bezpieczeństwa. Możesz przejrzeć wszystko zanim zdecydujesz się na zakup.
  • Czy mogę dostać zwrot, jeśli zmienię zdanie?
    Pierwsza opłata jest bezzwrotna z chwilą rozpoczęcia świadczenia (zgodnie z art. 38 pkt 13 ustawy o prawach konsumenta i klauzulą wygaszenia prawa odstąpienia, którą akceptujesz przy checkout). Kolejne miesiące — anulacja w panelu zatrzymuje obciążenia od kolejnego cyklu, bez prorate. Nie ma standardowego refund-window; w wyjątkowych przypadkach (techniczne problemy z naszej strony) napisz na support@spaceads.agency, rozpatrzymy indywidualnie.
  • Jaki support oferujecie?
    Email: support@spaceads.agency. Pierwsze 30 dni — priority onboarding, odpowiedź <8h dni roboczych. Później standard SLA: 24h dni roboczych. Pomoc obejmuje: setup OAuth (Google/Meta/TikTok), debug API, migracje wersji, pytania o komendy i agentów. Nie obejmuje: customizacji kodu CLI, integracji custom z Twoimi wewnętrznymi systemami.

Mniej zakładek, więcej decyzji

Subskrypcja miesięczna, anulujesz w każdej chwili. Self-hosted u Ciebie, działa na wszystkich Twoich kontach reklamowych — bez per-seat. Faktura co miesiąc, dostęp natychmiast po pierwszym opłaceniu.

Aktywuj subskrypcję Space Ads OS