--- title: "Skill agenta kampanii: marża po zwrotach, nie ROAS" url: "https://majchrzycki.com/blog/skill-agent-kampanii-handel-wielokanalowy" description: "Darmowy skill AI liczy marżę każdej kampanii po zwrotach, prowizjach, wysyłce i reklamie i stawia ją obok ROAS. W paczce dane ćwiczeniowe i wynik kontrolny." --- # Skill agenta kampanii: marża po zwrotach, nie ROAS 11 listopada 2026·5 min czytania·[Krzysztof Majchrzycki](https://majchrzycki.com/o-mnie) Temat: [Skille AI dla firmy](https://majchrzycki.com/blog/filar/skille-ai-dla-firmy) **Skill „rozliczenie-kampanii” liczy marżę każdej kampanii sklepu wielokanałowego po zwrotach, prowizjach, płatnościach, wysyłce i reklamie, a pobierzecie go za darmo z GitHuba.** Kampania może pobić rekord przychodu i mieć najwyższy zwrot z wydatków na reklamę (ROAS), a i tak prawie nic nie zarobić. Taki rachunek składa się dziś z trzech paneli i jednego arkusza księgowej, więc zarząd zna marżę kampanii z opóźnieniem. Skill robi ten rachunek na eksporcie miesiąca i kładzie go obok ROAS. Repozytorium: [moja-firma-handel na GitHubie](https://github.com/majchrzycki-com/moja-firma-handel). To pakiet branżowy otwartej paczki [moja-firma](https://github.com/majchrzycki-com/moja-firma). Rdzeń paczki opisujemy w osobnym tekście: [moja-firma, otwarte skille AI dla polskiej firmy](https://majchrzycki.com/blog/moja-firma-otwarte-skille-ai-dla-polskiej-firmy). ## Co robi skill, a czego nie zrobi Skill to procedura w formacie Agent Skills, zapisana w jednym pliku `SKILL.md`. Czyta trzy pliki: plan kampanii z kosztem reklamy, zamówienia z miesiąca i zwroty. Potem pracuje w sześciu krokach. 1. Grupuje zamówienia według kampanii. Zamówienia bez oznaczenia kampanii pokazuje osobno jako „bez kampanii”. 2. Dla każdej grupy liczy zamówienia, zwroty, przychód netto, zwroty netto, koszt towaru po zwrotach, prowizje, opłaty za płatności, wysyłkę, obsługę zwrotów i koszt reklamy. 3. Liczy marżę po wszystkich tych kosztach i marżę procentową od przychodu po zwrotach. ROAS liczy od przychodu przed zwrotami, tak jak pokazuje go panel reklamowy. 4. Oznacza kampanie: „rekord przychodu, słaba marża”, „na minusie” i „do wzmocnienia”. Progi są zapisane jawnie, więc marketing może je zmienić. 5. Przy oznaczonych kampaniach wskazuje dwie największe pozycje kosztu poza towarem. Gdy zwroty są wysokie, podaje produkt, który wraca najczęściej. 6. Przygotowuje rekomendację: co wzmocnić, co ograniczyć, co sprawdzić. Każdą propozycję uzasadnia liczbami i mówi, kto decyduje. Zwrot skill przypisuje do kampanii po numerze zamówienia, a nie po dacie. To ważne, bo zwroty z jednego miesiąca spływają przez cały następny. Skill liczy kodem na plikach i przy każdej sumie podaje, ilu wierszy dotyczy. Na koniec oddaje tabelę, oznaczenia, rekomendację i plik XLSX. Decyzje zostają przy ludziach. **Marketing** zarządza budżetem reklamowym i wyłącza kampanie. **Zarząd** decyduje o kampanii bez marży, którą firma chce utrzymać dla zasięgu. Skill niczego nie wyłącza, nie przesuwa budżetu, nie wysyła wiadomości i nie zmienia rekordów w systemach. Proponuje. ## Gdzie zwykła automatyzacja się myli Najczęstszy błąd siedzi w kalendarzu. Zwroty z kwietnia spływają przez cały maj. Gdyby rozliczyć kampanię marketplace 5 maja, widać by było 14 z 50 zwrotów i marżę 4 055,20 zł, czyli 5,3%. Po zamknięciu okna zwrotów zostaje z tego 827,93 zł. Reguła, która 5 maja automatycznie dołożyłaby budżet „rentownej” kampanii, dołożyłaby go do kampanii, która niemal nic nie zarobiła. Panel reklamowy tego nie pokaże, bo zwrotów nie widzi. ROAS tej kampanii wynosi 22,61 i nie zmienia się po żadnym zwrocie. W wyniku kontrolnym jest jeszcze jeden test. Pod koniec maja wracają dwie kosiarki uszkodzone w transporcie, których nie da się sprzedać ponownie. Po ich dopisaniu marża tej samej kampanii spada do −105,07 zł, czyli −0,2%. ROAS zostaje 22,61. Dwie paczki zamieniają rekordową kampanię w stratną. Drugi warunek dotyczy danych. Jeśli zamówienia w Waszym eksporcie nie mają oznaczenia kampanii, a ten sam produkt nosi inny indeks w każdym kanale, skill policzy marżę starannie, ale na złych przypisaniach. Najpierw jedno oznaczenie kampanii w zamówieniu i jeden indeks produktu, potem agent. ## Co jest w repozytorium - **Procedura** `skills/rozliczenie-kampanii/SKILL.md` w wersji 0.1.0, na licencji MIT. - **Dane ćwiczeniowe** w katalogu `dane-cwiczeniowe/`: `kampanie.csv`, `kampanie.xlsx`, `zamowienia.csv`, `zamowienia.xlsx`, `zwroty.csv`, `zwroty.xlsx`. Pliki CSV i XLSX mają tę samą treść. Opisują fikcyjny sklep ogrodowy: kwiecień 2026, pięć kampanii, 1015 zamówień i 88 zwrotów. - **Wynik kontrolny** w pliku `WYNIK-KONTROLNY.md`: liczby policzone niezależnie z tych samych plików i krok z rzeczywistością, czyli jedna zmiana w danych z oczekiwanym wynikiem. - **Paczki ZIP** dla poszczególnych narzędzi w zakładce Releases: [najnowsze wydanie](https://github.com/majchrzycki-com/moja-firma-handel/releases/latest). Te same paczki zbuduje skrypt `scripts/build.mjs`. Na własnych danych potrzebujecie trzech eksportów. Z platformy sklepowej, marketplace albo integratora: numer zamówienia, data, kanał, oznaczenie kampanii, indeks, wartość netto, prowizja, opłata za płatność i koszt wysyłki. Z ERP: koszt towaru na zamówieniu. Z obsługi zwrotów: numer zamówienia, wartość zwrotu, czy towar wrócił do sprzedaży i koszt obsługi. Plan kampanii z kosztem reklamy zwykle prowadzi marketing w arkuszu. Kolumny mogą nazywać się po Waszemu, bo skill pokaże przypisanie i zapyta, gdy coś jest niejednoznaczne. ## Jak zainstalować skill Przepisy krok po kroku na blogu pokazują budowę tego agenta od zera, z klikaniem w menu i wklejaniem instrukcji. Skill daje gotową procedurę, więc zostaje Wam instalacja i sprawdzenie wyniku. Nazwy menu zmieniają się często, więc w razie różnic sprawdźcie dokumentację narzędzia. **Anthropic Claude.** W Claude Code wpiszcie dwa polecenia: ``` /plugin marketplace add majchrzycki-com/moja-firma /plugin install moja-firma-handel@moja-firma ``` W aplikacji Claude dodajcie plik ZIP z wydania jako umiejętność w ustawieniach. Budowa od zera: [agent kampanii w Claude krok po kroku](https://majchrzycki.com/blog/agent-kampanii-w-claude-krok-po-kroku). **Microsoft 365 Copilot.** W Copilot Cowork wybierzcie Dostosuj, potem Umiejętności i Dodaj, a następnie zaimportujcie `SKILL.md`. W Agent Builderze wklejcie tekst z `dist/instrukcje/rozliczenie-kampanii.md` do pola instrukcji. Budowa od zera: [agent kampanii w Microsoft 365 Copilot](https://majchrzycki.com/blog/agent-kampanii-w-microsoft-365-copilot-krok-po-kroku). **OpenAI ChatGPT.** Wklejcie ten sam plik z `dist/instrukcje/` do instrukcji projektu albo GPT. W OpenAI Codex skopiujcie katalog skilla do katalogu skilli. Budowa od zera: [agent kampanii w ChatGPT](https://majchrzycki.com/blog/agent-kampanii-w-chatgpt-krok-po-kroku). **Google Gemini.** Otwórzcie Customize, potem Skills, Create i Upload, i wskażcie katalog procedury albo plik ZIP. Google zastępuje Gemy skillami, więc nowego agenta nie budujcie już jako Gema. Przepis dla tej platformy pokazuje wersję z Gemem: [agent kampanii w Gemini](https://majchrzycki.com/blog/agent-kampanii-w-gemini-krok-po-kroku). Weźcie z niego dane i sposób sprawdzenia wyniku, a procedurę wgrajcie jako skill. **OpenClaw.** Skopiujcie katalog `skills/rozliczenie-kampanii/` do katalogu skilli OpenClaw. Osobnego przepisu dla tej platformy nie ma. ## Jak sprawdzić skill, zanim użyjecie prawdziwych danych Dodajcie pliki ćwiczeniowe do wiedzy agenta albo załączcie je do rozmowy. Potem napiszcie: ``` Rozlicz kampanie z kwietnia 2026 według instrukcji projektu. Licz kodem na załączonych plikach. ``` Porównajcie odpowiedź z plikiem `WYNIK-KONTROLNY.md`. Trzy liczby mówią najwięcej: - kampania marketplace KMP-02 ma ROAS 22,61 i marżę 827,93 zł, czyli 1,3%, i dostaje oznaczenie „rekord przychodu, słaba marża”, - kampania w mediach społecznościowych KMP-03 wychodzi na minusie: −275,68 zł, - przy KMP-02 skill wskazuje kosiarkę elektryczną 40 cm: 25 z 50 zwrotów tej kampanii i 11 212,50 zł zwróconej wartości. Jeśli KMP-02 wychodzi z marżą kilku tysięcy złotych, agent prawdopodobnie pominął część zwrotów z maja. Albo nie połączył ich z zamówieniami po numerze. Stan testów opisujemy dokładnie. Procedurę sprawdziliśmy 2.11.2026 w Anthropic Claude na danych ćwiczeniowych i liczby zgodziły się z wynikiem kontrolnym. W Microsoft 365 Copilot, OpenAI ChatGPT i Google Gemini procedury nie testowaliśmy. Nie testowaliśmy jej też na prawdziwych danych firmy. Dlatego wynik kontrolny jest Waszym pierwszym sprawdzianem w każdym narzędziu. ## Skill to jeden z dwunastu agentów Darmowy poradnik [„Handel wielokanałowy jako jeden system”](https://majchrzycki.com/transformacja-agenci-ai/handel-wielokanalowy#pobierz) rozkłada drogę sklepu na dziesięć etapów, od kliknięcia do rozliczonej marży. Opisuje dwunastu agentów, którzy pracują na jednym modelu firmy, i pięć liczb dla zarządu. Agent kampanii pracuje w etapie 01, czyli przy ruchu, koszyku i zamówieniu. Mapa serii daje też uczciwą przestrogę. Agent kampanii kusi najbardziej, ale nie zawsze warto od niego zaczynać. Jeśli stany między kanałami rozjeżdżają się o godzinę, część zamówień i tak wróci jako sprzedaż ponad stan. Wtedy najpierw jeden stan i jedna karta produktu. Całą rozkładówkę znajdziecie we wpisie [handel wielokanałowy jako jeden system](https://majchrzycki.com/blog/handel-wielokanalowy-jako-jeden-system), a pozostałe teksty branży w filarze [handel wielokanałowy](https://majchrzycki.com/blog/filar/handel-wielokanalowy). Skille dla innych branż zbiera filar [skille AI dla firmy](https://majchrzycki.com/blog/filar/skille-ai-dla-firmy). ## Od czego zacząć w poniedziałek Zainstalujcie skill i uruchomcie go na danych ćwiczeniowych. Gdy liczby zgodzą się z wynikiem kontrolnym, weźcie ostatnią zakończoną kampanię z własnego sklepu. Najpierw przepuśćcie eksport przez procedurę `kontrola-danych` z rdzenia moja-firma. Pierwszy tydzień puśćcie agenta obok normalnej pracy jednej osoby i porównujcie wyniki. Wynik zawsze sprawdza osoba, która za niego odpowiada. - Handel wielokanałowy - Skille AI - Agent AI - GitHub ## Poradnik pokazuje, gdzie agent kampanii mieści się w całym sklepie. Darmowy poradnik „Handel wielokanałowy jako jeden system” pokazuje całą drogę od kliknięcia do rozliczonej marży, dwunastu agentów i pięć liczb, o które pyta zarząd. [Pobierz darmowy poradnik](https://majchrzycki.com/transformacja-agenci-ai/handel-wielokanalowy#pobierz) FAQ ## Najczęstsze pytania Czy skill sam wyłączy kampanię, która nie zarabia? Nie. Skill liczy marżę, oznacza kampanie i przygotowuje rekomendację z uzasadnieniem w liczbach. Budżetem i wyłączaniem kampanii zarządza marketing, a o kampanii bez marży, która ma budować zasięg, decyduje zarząd. Skill nie wysyła wiadomości i nie zmienia rekordów w systemach. Nasze kolumny w eksporcie nazywają się inaczej. Czy skill zadziała? Tak, jeśli przypisanie jest jednoznaczne. Skill pokazuje, którą kolumnę Waszego pliku traktuje jako którą, i liczy dalej. Gdy kolumna może znaczyć dwie rzeczy albo jej brakuje, prosi o potwierdzenie, zanim zacznie liczyć. Na start warto przepuścić eksport przez procedurę kontrola-danych z rdzenia moja-firma. Ile kosztuje skill? Nic. Procedura, skrypty i dane ćwiczeniowe są na licencji MIT. Płacicie tylko za narzędzie AI, w którym skill uruchomicie, według jego własnego cennika. ## Czytaj dalej - [Agent kampanii w Claude: rekord przychodu czy rekord marży?](https://majchrzycki.com/blog/agent-kampanii-w-claude-krok-po-kroku) - [Skill agenta zleceń: płatnik, marża i auto przed decyzją](https://majchrzycki.com/blog/skill-agent-zlecen-transportowych-logistyka) - [Skill agenta zgłoszeń: SLA, duplikaty i kolejka rano](https://majchrzycki.com/blog/skill-agent-zgloszen-serwisowych) - [Skill agenta zamówień B2B dla hurtowni: gotowa procedura](https://majchrzycki.com/blog/skill-agent-zamowien-b2b-dystrybucja)