Umiejętność Claude /spilno-ga4-roas-corridor-analysis: prognoza przychodu Google Ads w 5 minut

TL;DR: napisaliśmy umiejętność Claude, która w 5 minut buduje gotowy raport-prognozę: ile przychodu przyniesie Google Ads, jeśli zwiększymy miesięczny budżet o +10k / +25k / +50k UAH. Metoda — „korytarz wahań ROAS” na podstawie 6 miesięcy faktycznych danych GA4. Raport jest sformatowany według naszego wewnętrznego style guide’a tekstu (Montserrat, numerowane sekcje, liczby z separatorami tysięcy) — bez logo, kolorów ani nagłówka/stopki, tylko czyste strukturalne formatowanie. Poniżej — co umiejętność potrafi, jak wygląda szablon, jakie uprawnienia są potrzebne, jak działa krok po kroku, ograniczenia metody i link do GitHuba.

Co robi ta umiejętność

/spilno-ga4-roas-corridor-analysis automatyzuje rutynę analityka wokół typowego pytania klienta „ile dostanę z 1 UAH wydatków na reklamę, jeśli dodam jeszcze 25 tysięcy do Google Ads?”. Zamiast godziny ręcznej pracy — 5 minut i gotowy Google Doc sformatowany według naszego style guide’a:

1. ile UAH przychodu generuje 1 UAH wydatków na Google Ads w tej chwili;
2. jak wahał się ROAS przez ostatnie 6 miesięcy (korytarz min / avg / max);
3. jak stabilny jest ten korytarz (współczynnik zmienności CV);
4. ile dodatkowego przychodu da zwiększenie budżetu o +10k / +25k / +50k UAH — w trzech scenariuszach;
5. od którego scenariusza wystartować, uwzględniając ograniczenia metody.

Raport zapisywany jest na Google Drive jako zwykły Google Doc, sformatowany według style guide’a Spilno Agency: Montserrat jako jedyny font, numerowane sekcje bez kropek w nagłówkach, liczby z separatorami tysięcy, liczby w tabelach wyrównane do prawej, tryb Pageless z rozwijanymi nagłówkami, osobny blok „Krótki wniosek” (TL;DR dla klienta). To nie jest „branding” w sensie designerskim — bez logo, firmowych kolorów i ozdobnych elementów — tylko tekstowy style guide, łatwy do odtworzenia w dowolnym Google Doc.

Jak wygląda szablon dokumentu

Poniżej — pełny przykład wypełnionego raportu dla hipotetycznego sklepu internetowego z budżetem Google Ads ~130k UAH/miesiąc. Tak właśnie wygląda to, co otrzymasz w Google Doc — wszystkie 10 sekcji z prawdziwymi liczbami:

W prawdziwym Google Doc zastosowane formatowanie ze style guide’a Spilno Agency: Montserrat, numerowane sekcje bez kropek, liczby z separatorami tysięcy (1 340 400), liczby w tabelach wyrównane do prawej, tryb Pageless z rozwijanymi nagłówkami. Sekcje „Szczegóły techniczne” i „Ograniczenia metody” są zwykle zwinięte — żeby klient od razu widział kluczowe liczby i wniosek. Logo, kolorów, nagłówka/stopki w raporcie nie ma — w umiejętności celowo zostawiliśmy czysty format tekstowy, który każda agencja może sforkować i dodać swoją oprawę wizualną.

Pobierz szablon i wypełnij ręcznie

Jeśli chcesz zrobić analizę bez Claude — dla tych, którzy lubią hardcore — poniżej puste szablony. Wypełnij 6 miesięcy z własnego GA4 i otrzymasz ten sam raport ręcznie.

Jak uzyskać Google Doc: pobierz DOCX → otwórz Google Drive → przeciągnij plik → prawy klik → „Otwórz w” → „Dokumenty Google”. Plik skonwertuje się automatycznie i zapisze na twoim Dysku. Tryb Pageless włącz przez Plik → Ustawienia strony → Bez stron.

Jakie uprawnienia są potrzebne

Umiejętność działa przez automatyzację UI Google Analytics 4 — nie korzysta z API i nie prosi o tokeny OAuth. Potrzebne:

1. Claude Code z aktywnym rozszerzeniem Claude for Chrome.
2. Konto Google z dostępem do property GA4 projektu (rola Viewer wystarczy).
3. Property GA4 ze skonfigurowanym e-commerce tracking i zdarzeniem purchase.
4. Połączenie GA4 ↔ Google Ads w Admin → Product Links → Google Ads links. Bez niego kolumna Cost będzie pusta.
5. MCP Google Drive (opcjonalnie, ale zalecane) — do zapisu gotowego Google Doc bezpośrednio na Dysk. Jeśli nie podłączony, umiejętność automatycznie przełącza się na lokalny plik DOCX — zobacz następną sekcję.

Tokeny OAuth, konta serwisowe, klucze API — nie są wymagane. Claude pracuje z tym samym GA4, które widzisz w przeglądarce.

Jak podłączyć Google Drive (i co się stanie, jeśli nie podłączysz)

Google Drive podłącza się do Claude jako serwer MCP w 1 minutę. To krok opcjonalny: umiejętność w pełni działa i bez Drive — raport po prostu będzie w formacie DOCX, który otwierasz w Word, LibreOffice lub w samym Google Docs (przez Drive → Otwórz w).

Podłączenie Google Drive — krok po kroku

1. Otwórz Claude Code → menu /mcp (lub w Claude.ai: Settings → Connectors).
2. W katalogu znajdź konektor Google Drive (oficjalny od Anthropic). Kliknij Connect.
3. W oknie OAuth wybierz konto Google, na które umiejętność zapisze raport. To twoje robocze konto — niekoniecznie to, które ma dostęp do GA4 klienta.
4. Zatwierdź wymagane uprawnienie: Drive file (tworzenie/odczyt plików utworzonych przez aplikację) — minimum potrzebne. Umiejętność nie ma dostępu do istniejących plików.
5. Na liście narzędzi Claude pojawi się mcp__<id>__create_file — to wywołanie używane przez umiejętność do zapisu raportu.

Po pierwszym podłączeniu Claude pamięta token — dalej umiejętność działa bez dodatkowych pytań. Wycofać dostęp można w każdej chwili: myaccount.google.com/permissions.

Co się dzieje, gdy Google Drive NIE jest podłączony

Na początku Kroku 7 umiejętność sprawdza, czy w Claude dostępne jest narzędzie typu mcp__*__create_file. Jeśli nie ma (lub wywołanie zwraca błąd auth) — przełącza się na scenariusz fallback:

1. Wywołuje wbudowaną umiejętność Anthropic anthropic-skills:docx z tą samą strukturą co Google Doc — Montserrat, numerowane sekcje, tabele z obramowaniem, liczby z separatorami tysięcy.
2. Zapisuje plik w bieżącym katalogu roboczym: Prognoza przychodu Google Ads [domena].docx.
3. W końcowym komunikacie podaje bezwzględną ścieżkę do pliku i krótką notkę: „Google Drive nie jest podłączony, więc wygenerowano lokalny plik Word. Jeśli potrzebujesz Google Doc — wgraj plik na swój Dysk i otwórz przez Google Documenty”.

Jeśli również anthropic-skills:docx jest z jakiegoś powodu niedostępna (rzadki przypadek) — trzeci fallback: umiejętność zwraca pełny raport jako sformatowany Markdown w czacie. Możesz go wkleić do Word lub Google Docs jednym ruchem.

Podsumowanie: umiejętność zawsze działa. Najwygodniejsza ścieżka — podłączony Drive i od razu Google Doc na dysku. Bez Drive — ten sam raport, tylko lokalny DOCX.

Jak działa — 8 kroków

Przed startem Claude zadaje 4 pytania doprecyzowujące: domena i trzy flagi „modelować +10k / +25k / +50k?”. Dalej automatyczny pipeline:

1. Znajduje property GA4. Otwiera analytics.google.com, w selektor property wprowadza domenę.
2. Przechodzi do raportu „Skuteczność konwersji”. Bezpośredni URL niestabilny — nawiguje przez sidebar: Reklama → Skuteczność konwersji.
3. Filtruje po zdarzeniu purchase. Odznacza wszystkie kluczowe zdarzenia poza [domena] purchase.
4. Zbiera dane z 6 miesięcy. Date picker → dwie daty → render → ekstrakcja tabeli przez JavaScript. Bierze Cross-network (Performance Max), Paid Shopping, Paid Search.
5. Liczy korytarz ROAS. Dla każdego miesiąca ROAS = Revenue / Cost. Po 6 punktach: MIN, AVG, MAX, σ, CV. CV <15% — stabilny; >25% — ostrzeżenie.
6. Buduje prognozę. Dla każdego scenariusza: pesymistyczny = Δ × MIN, bazowy = Δ × AVG, optymistyczny = Δ × MAX.
7. Tworzy Google Doc według style guide’a Spilno. Przez MCP Google Drive: HTML → Google Doc → Pageless mode. Montserrat, numerowane sekcje, liczby z separatorami tysięcy. Bez logo i kolorów — tylko formatowanie tekstu.
8. Prezentuje wynik. Klikalny URL do Doca + krótkie podsumowanie + lista zastrzeżeń.

Ograniczenia metody

„Korytarz ROAS” to szybkie i uczciwe narzędzie do rozmowy z klientem o skalowaniu reklamy, ale nie zastępuje pełnego planowania mediów. Sekcja 8 każdego raportu zawiera trzy ograniczenia:

1. Liniowa ekstrapolacja. Prognoza zakłada, że ROAS pozostaje w historycznym korytarzu przy każdym budżecie. Realnie marginalny ROAS jest zwykle niższy od średniego (prawo malejących przychodów). Faktyczny wzrost przy +25k / +50k może być o 20–40% niższy od scenariusza optymistycznego.
2. Konkurencja nie modelowana. Metoda nie uwzględnia działań konkurentów w aukcji Google Ads. Dla dokładnej oceny potrzebne Search Lost Impression Share (Rank) i Auction Insights z Google Ads UI.
3. Nasycenie rynku nie modelowane. GA4 nie pokazuje ile wyświetleń jest jeszcze dostępnych. Jeśli kampania wygrywa >80% udziału, dodatkowy budżet da minimalny przyrost. Sprawdzić w Google Ads → Search Lost IS (Budget).

Umiejętność nie analizuje też sezonowości (dla projektów sezonowych — 12 miesięcy), nie rozkłada ROAS po kategoriach produktów i używa domyślnej atrybucji GA4 (Data-Driven).

Instalacja — pobierz z GitHuba

Umiejętność jest open-source na licencji MIT. Można forkować i dostosować do własnej marki.

⚡ Pobierz umiejętność z GitHuba

Szybka instalacja w Claude Code:

git clone https://github.com/spilno-agency/spilno-agency-skills.git
cp -r spilno-agency-skills/ga4-roas-corridor-analysis ~/.claude/skills/

Zrestartuj Claude Code — umiejętność dostępna jako /ga4-roas-corridor-analysis. Pełna specyfikacja: SKILL.md.

Zamiast wniosku

To nasza pierwsza publiczna umiejętność Claude, ale na pewno nie ostatnia. W pracy — umiejętności do technicznego audytu SEO, analizy kanibalizacji zapytań, walidacji konfiguracji GTM, automatycznej generacji Title/Meta. Issues i pull requests mile widziane.