Dokumentacja netroas
Wersja robocza — wymaga przeglądu prawnego / Draft — pending legal review
Obowiązuje od: [DATA]
netroas prowadzi kampanie Google Ads z poziomu asystenta AI: czyta dane, liczy audyty, proponuje zmiany i wykonuje je po Twoim potwierdzeniu.
Do czego służy
Dla sprzedawców i agencji, którzy chcą sprawdzać i poprawiać Google Ads w rozmowie z asystentem. Narzędzia zwracają dane z konta; asystent opisuje je po ludzku. Poza Google Ads (GA4, Search Console, Merchant Center) netroas tylko czyta.
Jak podłączyć
Dodaj w asystencie konektor z publicznym adresem /mcp (OAuth), a potem zaloguj się kontem Google z dostępem do Google Ads. Instrukcje dla Claude, ChatGPT, Cursor, VS Code, Claude Code i Codex:
Logowanie Google musi działać — bez niego netroas nie ma dostępu do danych. W pilotażu bywa chwilowo niedostępne; dodany konektor zostaje i zadziała po zalogowaniu.
Narzędzia
Lista z rejestru serwera (aktualna przy każdym wyświetleniu strony):
| Narzędzie | Tytuł | Rodzaj |
|---|---|---|
ping | Check connection | odczyt |
audit | Audit account | odczyt |
plan | Build improvement plan | odczyt |
report | Google Ads report | odczyt |
status | Account status | odczyt |
get_policy | Read policy and goal | odczyt |
set_goal | Set campaign goal | zapis (zmienia stan konta Google Ads albo ustawienia netroas) |
set_policy | Set strategy limits | zapis (zmienia stan konta Google Ads albo ustawienia netroas) |
strategy_template | Strategy template | odczyt |
mode | Read or set work mode | zapis (zmienia stan konta Google Ads albo ustawienia netroas) |
propose_change | Propose change | propozycja (zapis tylko w netroas; do Google wyłącznie test validateOnly) |
apply | Apply confirmed change | zapis (zmienia stan konta Google Ads albo ustawienia netroas) |
reconcile_change | Reconcile interrupted change | zapis (zmienia stan konta Google Ads albo ustawienia netroas) |
undo | Undo change | zapis (zmienia stan konta Google Ads albo ustawienia netroas) |
changes | Change log | odczyt |
playbook | Account playbook | odczyt |
weekly_review | Weekly review | odczyt |
feed_check | Check Merchant feed | odczyt |
propose_campaign | Propose new campaign | propozycja (zapis tylko w netroas; do Google wyłącznie test validateOnly) |
validate_copy | Validate ad copy | propozycja (zapis tylko w netroas; do Google wyłącznie test validateOnly) |
create_campaign | Create confirmed campaign | zapis (zmienia stan konta Google Ads albo ustawienia netroas) |
performance_review | Compare performance | odczyt |
full_report | Full PDF report | odczyt |
merchant_check | Merchant Center check | odczyt |
site_check | GA4 site check | odczyt |
data_sources | Data sources | odczyt |
search_demand | Search demand (Search Console) | odczyt |
Potwierdzanie i cofanie zmian
- propose_change albo propose_campaign przygotowuje podgląd i nic nie zmienia; serwer sprawdza politykę i limity, a Google waliduje zmianę na sucho (validateOnly).
- Asystent pokazuje podgląd; po Twoim „tak” dla tej propozycji wywołuje apply (albo create_campaign). Propozycja jest ważna 24 godziny.
- undo cofa wykonaną zmianę, jeśli jest odwracalna i stan konta się nie zmienił; changes pokazuje dziennik; reconcile_change sprawdza w Google wynik zmiany przerwanej w trakcie i uzupełnia dziennik (nigdy nie ponawia zapisu).
- Plan Free: do 5 potwierdzonych zmian w miesiącu; cofnięcie nie zwraca limitu.
Tryby i limity
- Tryby: obserwacja, potwierdzanie (domyślny), autopilot. Autopilot włączasz tylko na stronie netroas, po co najmniej 14 dniach potwierdzania, z ustawionym celem.
- Limity serwera: budżet ±20 % na zmianę, cel tROAS/tCPA ±10 %, 7 dni między zmianami strukturalnymi kampanii, łącznie do 35 % budżetu w 30 dni, sufit dzienny z Twojej polityki.
- Odmowa serwera to decyzja, nie błąd — asystent ma ją przekazać wprost.
Rozwiązywanie problemów
- Nie widzę konektora: sprawdź, czy jest włączony w ustawieniach asystenta i w danej rozmowie; w Claude Team/Enterprise konektor dodaje właściciel organizacji.
- Błąd logowania Google: spróbuj ponownie później (w pilotażu logowanie bywa niedostępne); upewnij się, że konto Google ma dostęp do Google Ads.
- Brak danych GA4, Search Console albo Merchant Center: na ekranie zgody Google zaznacz wszystkie zakresy, a konto Google musi mieć dostęp do danej usługi; potem połącz ponownie.
- Odłączenie i ponowne połączenie: odbierz dostęp na https://myaccount.google.com/permissions, usuń konektor w asystencie i dodaj go ponownie według instrukcji instalacji.
Prywatność i wsparcie
Wsparcie: [E-MAIL WSPARCIA].