Od katalogu Shopera do bezpiecznego feedu

1. Instalacja i pierwszy profil

1. Zainstaluj GrowFeed z Shoper App Store i otwórz aplikację z panelu sklepu.
2. Pierwsza instalacja otrzymuje jednorazowo 14 dni planu Start. Ponowna instalacja nie uruchamia nowego okresu próbnego.
3. GrowFeed tworzy profil główny. W planie Pro możesz dodać maksymalnie pięć profili dla różnych rynków lub kampanii.
4. Ustaw nazwę profilu, dwuliterowy rynek, na przykład PL, oraz locale, na przykład pl_PL.

Waluta nie jest wpisywana ręcznie. Każdy przebieg potwierdza ją z konfiguracji Shopera.

2. Wybór modelu oferty

Jeden wpis na produkt

To bezpieczny tryb domyślny dla Storefront i starszego RWD. GrowFeed publikuje jeden identyfikator i jeden link produktu.

Każdy wariant osobno

Użyj wyłącznie dla Storefront z jedną osią wariantu, gdy natywny fragment #variantOptions po świeżym wejściu wybiera właściwy wariant, cenę i stan. Zaznaczenie potwierdzenia w panelu jest obowiązkowe.

3. Kanały i reguły katalogu

Włącz Google Merchant, Meta Catalog i Ceneo niezależnie. Błąd dotyczący tylko Ceneo, na przykład brak wymaganego podmiotu GPSR, nie powinien zatrzymać poprawnych plików Google i Meta.

Profil może ograniczać katalog przez:

• minimalną i maksymalną cenę;
• minimalny stan magazynowy;
• listy ID kategorii i producentów do uwzględnienia lub wykluczenia;
• wymagane i wykluczone tagi.

Wartości ID rozdziel przecinkami. Reguły nie zmieniają katalogu, lecz decydują, które oferty trafią do budowanego pliku.

4. Etykiety kampanii w planie Pro

Dla pól custom_label_0 do custom_label_4 wybierz sygnał: bestseller, nowość, promocję, poziom stanu, tag campaign:* albo brak wartości. Etykiety są emitowane do Google i Meta; Ceneo ich nie używa.

Plan Start korzysta ze stałego bezpiecznego mapowania tych pięciu sygnałów. Plan Pro pozwala zmienić ich kolejność albo wyłączyć wybrane pole.

5. Zapis i preflight

1. Wybierz Zapisz profil. Komunikat po przeładowaniu potwierdzi trwały zapis.
2. Wybierz Sprawdź i przebuduj.
3. GrowFeed pobierze stronicami produkty, stocki, ceny, obrazy, słowniki i walutę.
4. Obserwuj postęp w panelu lub w Dzienniku przebiegów.

Preflight zatrzymuje kandydata między innymi przy cenie 0, sprzecznym kontrakcie ceny, braku wymaganych danych, duplikacie identyfikatora oraz gwałtownym ubytku ofert. Zatrzymany kandydat nie podmienia ostatniego poprawnego pliku.

6. Odczyt wyniku

• Artefakt gotowy: plik przeszedł kontrolę, ma SHA i może być pobierany ze stabilnego adresu.
• Kandydat zatrzymany: popraw wskazany kod problemu w Shoperze. Poprzedni dobry plik pozostaje aktywny.
• Kanał przetwarza lub przyjął: stan wymaga osobnego, świeżego dowodu z danego kanału.

Sekcja różnic pokazuje liczbę ofert dodanych, usuniętych i zmienionych względem poprzedniej dobrej wersji. Pełny przebieg oraz wynik każdego kanału są dostępne w Dzienniku.

7. Podłączenie stabilnych adresów

1. W wierszu kanału wybierz Kopiuj.
2. Dodaj URL jako zaplanowane źródło danych w Google Merchant Center, źródło feedu w Meta Commerce Manager albo źródło/import w Ceneo.
3. Ustaw harmonogram pobierania po planowanej przebudowie GrowFeed.
4. Po imporcie sprawdź liczbę przyjętych, odrzuconych i oczekujących ofert w panelu kanału.

Adres jest sekretem dostępowym. Nie publikuj go w dokumentacji, zgłoszeniu ani zrzucie ekranu. Nginx GrowFeed nie zapisuje ścieżek feedów w logu dostępu.

8. Potwierdzenie odbioru

Dla Ceneo po poprawnym ręcznym imporcie wybierz Potwierdź import z panelu. Przycisk zapisuje potwierdzenie związane z aktualnym SHA i liczbą ofert. Nie używaj go po odrzuceniu lub częściowym imporcie.

Google i Meta wymagają właściwych danych diagnostycznych. Dopóki integracja nie dostarczy kompletnego dowodu dla bieżącego SHA i dokładnego zestawu ofert, panel pozostaje przy stanie niepotwierdzonym. W Meta warianty wymagają także realnego dopasowania content_ids ze zdarzeń Pixel lub CAPI.

9. Harmonogram i alerty

Plan Start przebudowuje profil najwyżej co 24 godziny. Plan Pro pozwala wybrać 6, 12 lub 24 godziny. Automatyzację uruchamiaj dopiero po poprawnym pierwszym imporcie i sprawdzeniu wyników kanałów.

GrowFeed wysyła operacyjny alert na kontakt sklepu z Shopera, gdy nowy plik zostanie zatrzymany, oraz jedno potwierdzenie po powrocie do poprawnego artefaktu. Ten sam problem ma 12-godzinny cooldown. Wiadomości nie zawierają produktów ani adresu feedu.

10. Unieważnienie adresu

Jeśli URL wyciekł, wybierz Unieważnij adres przy właściwym kanale. Stary URL natychmiast przestanie działać, a panel pokaże nowy. Następnie zaktualizuj źródło danych w kanale.

Najczęstsze problemy

• Cena 0 lub błąd ceny: sprawdź typ i operand ceny stocku oraz cenę obliczoną w Shoperze.
• Wariant bez zdjęcia: popraw własne zdjęcie wariantu albo usuń błędne powiązanie gfx_id.
• Brak GPSR w Ceneo: uzupełnij producenta i, gdy jest wymagany, odpowiedzialny podmiot z siedzibą w UE.
• Duplikat GTIN: popraw identyfikator w Shoperze. GrowFeed nie wybiera arbitralnie jednej z ofert.
• Nagły ubytek ofert: sprawdź zakres reguł i kompletność odczytu. Ochrona last-good celowo blokuje podmianę.
• Adres zwraca 404: upewnij się, że profil i kanał są aktywne oraz że po rotacji skopiowano nowy URL.
• Plan wygasł: feedy i mutacje panelu są blokowane do aktywacji planu. Nie kupuj ponownie, jeśli panel pokazuje „Aktywacja w toku”.

Pomoc

Napisz na support@app.growcommerce.pl. Podaj domenę sklepu, numer przebiegu, kanał i kod problemu. Nie przesyłaj tokenów OAuth, stabilnego URL-a feedu ani danych klientów.