GrowMatch

1. Wprowadzenie

GrowMatch to aplikacja Shoper App Store dla sklepów, które sprzedają zamienniki i odpowiedniki — perfumy „inspirowane" znanymi markami, kosmetyki, części, akcesoria. Dokłada na karcie produktu i na liście produktów elegancką sekcję z powiązanymi propozycjami: pokazujesz klientowi, że masz tańszy odpowiednik tego, czego szuka, podpierasz to ceną oryginału i pozwalasz wybrać kolor / wariant kropką (swatchem). Cel jest jeden: klient widzi alternatywę i kupuje u Ciebie, zamiast wracać do wyszukiwarki.

2. Instalacja

Aplikację zainstalujesz z poziomu Shoper App Store:

1. 1W panelu administracyjnym Twojego sklepu przejdź do Dodatki i integracje → App Store.
2. 2Wyszukaj „GrowMatch".
3. 3Kliknij „Zainstaluj". GrowMatch potrzebuje tylko odczytu produktów i kategorii. Nie prosi o zamówienia, klientów ani zapis produktów.
4. 4Shoper pokaże cenę i okres wybranego pakietu przed potwierdzeniem. Jeżeli trwa promocja, zobaczysz ją bezpośrednio przy zakupie aplikacji.
5. 5Aplikacja pojawia się w Dodatki i integracje → Aplikacje — kliknij jej ikonę, by otworzyć panel GrowMatch.

3. Pierwsze uruchomienie

Po otwarciu GrowMatch zobaczysz panel z 4 zakładkami. Każda odpowiada za jeden krok pracy:

Zalecana ścieżka startowa

1. 1Wejdź w Reguły i włącz auto-regułę „Inspirowane" (jeśli sprzedajesz odpowiedniki perfum) — od razu pogrupuje produkty po naśladowanej marce.
2. 2Sprawdź podgląd na sucho (dry-run) — zobaczysz, ile powiązań powstanie i na jakich produktach, zanim cokolwiek zatwierdzisz.
3. 3Przejdź do Widgety, wybierz preset (np. „Perfumy / Zamiennik") i dostosuj tekst oraz kolory pod swój sklep.
4. 4Zapisz i opublikuj wygląd, a następnie otwórz produkt, który ma aktywne powiązania — sekcja pojawi się na Storefroncie.

4. Powiązania — przegląd i edytor live

Zakładka Powiązania to serce aplikacji — tabela ze wszystkimi powiązaniami w sklepie. To źródło prawdy: GrowMatch trzyma powiązania we własnej bazie, a dane produktów (ceny, zdjęcia, nazwy) czyta na bieżąco ze sklepu.

Co jest w tabeli

Edytor live

Wszystko edytujesz wprost w tabeli — bez osobnych formularzy. Klikasz komórkę, zmieniasz markę, cenę-anchor, kolor czy przypisany widget i zapisujesz. To wygodne, gdy chcesz ręcznie dopieścić kilka produktów po tym, jak auto-reguła stworzyła resztę.

• Cofnij / Ponów (Ctrl+Z / Ctrl+Y) — każda zmiana jest odwracalna jednym kliknięciem.
• Dodaj powiązanie ręcznie — wybierasz produkt główny i przypisujesz mu zamienniki.
• Filtr i wyszukiwanie — szybko znajdziesz produkt po nazwie albo kodzie.

5. Auto-reguły Pro

Reguła to zasada, która sama tworzy powiązania na podstawie tego, co już masz w sklepie. Ustawiasz ją raz, a GrowMatch grupuje produkty automatycznie — koniec ręcznego klikania powiązań produkt po produkcie. Każda reguła ma podgląd na sucho (dry-run): zanim cokolwiek zatwierdzisz, widzisz dokładnie, ile powiązań powstanie i na jakich produktach.

4 tryby reguł

Priorytety i podgląd

Możesz mieć kilka reguł naraz — ustawiasz im priorytety, żeby wiedzieć, która wygrywa, gdy produkt pasuje do więcej niż jednej. Przed każdym uruchomieniem reguła pokazuje podgląd na sucho: lista produktów, które dostaną powiązania, i liczba powiązań do utworzenia. Dopiero gdy potwierdzisz, reguła zapisuje wynik do bazy powiązań.

6. Import / eksport CSV Pro

Jeśli wolisz przygotować powiązania w Excelu albo masz je już w pliku z innego źródła — wgraj je masowo przez CSV. Eksport działa w drugą stronę: pobierzesz obecne powiązania, poprawisz w arkuszu i wgrasz z powrotem.

Format pliku

Kluczowa kolumna to related_products — lista ID lub kodów produktów powiązanych, rozdzielonych znakiem | lub ,. Opcjonalnie dodajesz kolumny z marką, kolorem i ceną-anchor.

Podgląd zmian i Cofnij

• Podgląd przed zapisem — zanim cokolwiek trafi do bazy powiązań, widzisz, co zostanie dodane i zmienione. Nic nie jest zapisywane, dopóki nie potwierdzisz.
• Cofnij (Undo) jednym kliknięciem — każdy import możesz cofnąć, przywracając poprzedni stan powiązań.
• Historia 7 dni — operacje są przechowywane przez tydzień, więc masz czas na decyzję o cofnięciu.

7. Cena oryginału (anchor)

Anchor to cena oryginału pokazywana obok Twojej ceny — np. „Oryginał ok. 690 zł — Ty płacisz mniej". To prosta psychologia ceny: klient widzi, ile kosztuje markowy oryginał, i Twoja cena od razu wygląda na okazję. To jeden z najmocniejszych argumentów przy sprzedaży zamienników i odpowiedników.

Skąd brana jest cena oryginału

8. Wygląd widgetu (Widgety)

W zakładce Widgety ustalasz, jak sekcja powiązanych wygląda w Twoim sklepie. Działa na silniku presetów: zaczynasz od gotowego stylu i dostosowujesz go pod swoją markę — z podglądem na żywo, więc widzisz zmiany od razu.

Presety wbudowane — „Wybierz z domyślnych"

Obok presetów wbudowanych masz zakładkę „Twoje" — tu lądują style, które sam zapisałeś po personalizacji, gotowe do ponownego użycia.

Pełna personalizacja

• Tekst (etykiety) — zmienisz nagłówek sekcji, treść badge, podpis przy cenie oryginału.
• Kolory — dopasujesz akcenty, tło i obramowania do palety swojego sklepu.
• Układ — liczba kolumn, rozmieszczenie, sposób pokazania ceny i kropek kolorów.
• Podgląd na żywo — każdą zmianę widzisz natychmiast, zanim trafi na sklep.

9. Widget na sklepie (Storefront)

Wraz z aplikacją automatycznie instalowany jest standardowy moduł integracyjny. Aby pokazać widget na karcie produktu i liście produktów, wybierz powiązania i wygląd, zapisz go i kliknij Publikuj. Nie potrzebujesz planu Premium, nie musisz nic kopiować ani grzebać w szablonie.

Gdyby widget się nie pokazał

W rzadkich przypadkach (np. mocno zmodyfikowany szablon) trzeba ręcznie wkleić jednorazowy snippet. Znajdziesz go w panelu GrowMatch, w Ustawienia → karta „Instalacja na sklepie", razem z przyciskiem Kopiuj:

Snippet wklejasz w panelu Shoper w sekcji: Wygląd → Kod własny → Frontstore (stopka). Po zapisaniu odśwież sklep — widget się pojawi.

10. Świeżość danych

GrowMatch pobiera nazwy, ceny i zdjęcia z katalogu Shopera. Opcjonalne webhooki product.create i product.edit skracają czas od zmiany produktu do odświeżenia danych w widgecie.

• Ceny — odświeżony cache aktualizuje cenę produktu i kotwicę w trybie from_related_price.
• Zdjęcia — odświeżenie produktu aktualizuje miniatury i swatche zdjęciowe.
• Nazwy — odświeżenie aktualizuje etykiety w sekcji powiązanych.

11. Plany i cennik

Cenę i okres rozliczeniowy ustala pakiet widoczny w Shoper App Store. Przed zakupem Shoper pokazuje pełne warunki, a aktywna subskrypcja odblokowuje cały zakres GrowMatch. Instrukcja celowo nie powiela kwoty, ponieważ promocje i pakiety mogą się zmieniać.

Co obejmuje aktywna subskrypcja

Po wygaśnięciu dostępu panel blokuje zmiany, a publiczny widget przestaje pobierać dane. Po odnowieniu pakietu podpisany webhook Shopera przywraca dostęp do daty końca nowego okresu.

12. FAQ — Najczęściej zadawane pytania

13. Bezpieczeństwo i RODO

Co widzi aplikacja

• Dane produktów w trybie tylko do odczytu: nazwy, ceny, zdjęcia, warianty, kategorie, atrybuty, natywne powiązania
• Dane sklepu: ID, URL, nazwa
• Dane administratora: email (do komunikacji o aplikacji i ewentualnych incydentach)
• Powiązania, które sam utworzyłeś — przechowywane we własnej bazie GrowMatch (źródło prawdy)

Czego aplikacja NIE robi i NIE widzi

• Nie ma dostępu do danych płatniczych klientów (numerów kart, danych bramek) — Shoper nie udostępnia ich przez API
• Nie zna haseł administratora ani klientów
• Nie zmienia Twoich produktów ani cen — czyta je wyłącznie do wyświetlenia w widgecie
• Nie zapisuje nic do natywnego pola „Produkty powiązane" Shopera; może je wyłącznie odczytać jako opcjonalne źródło

Infrastruktura

• Serwery w Unii Europejskiej (Niemcy) — zgodne z RODO
• SSL/TLS dla wszystkich połączeń aplikacja ↔ sklep ↔ przeglądarka
• Sesja iframe kryptograficznie powiązana ze sklepem (nie da się jej przejąć z innego okna)
• Bez korzystania z zewnętrznych usług analitycznych / AI / marketingowych dla Twoich danych
• Regularne audyty bezpieczeństwa kodu i kopie zapasowe bazy

14. Kontakt i wsparcie

Masz pytania, napotkałeś błąd, potrzebujesz pomocy przy konfiguracji powiązań? Jesteśmy do dyspozycji.