Jak przygotować i podłączyć feed produktowy

1. Instalacja i pierwszy profil

1. Po instalacji wejdź w Aplikacje i integracje → Zainstalowane aplikacje → GrowFeed. W starszym układzie panelu wybierz Dodatki i integracje → Moje aplikacje → GrowFeed.
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, rynek i wersję językową, na przykład Polska oraz język polski.

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 jednym rodzajem wariantu i dopiero po teście linku: po otwarciu musi być wybrany właściwy wariant, cena oraz dostępność. 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.

3a. Wykluczenia: promocje, nowości, bestsellery

W ustawieniach, w sekcji „Które produkty trafią do feedu”, możesz wyłączyć z feedu produkty w promocji, nowości lub bestsellery. Przy każdej opcji widzisz, ile ofert z ostatniego gotowego pliku wypadnie. Gdy ta liczba nie jest widoczna w pliku (np. etykieta własna nie niesie sygnału bestsellera), GrowFeed pisze to wprost zamiast zgadywać; dokładny wynik pokaże następna kontrola.

Jeśli reguła usunie ponad 25% ofert naraz, kontrola wstrzyma nową wersję, a dotychczasowy plik nadal działa. To zabezpieczenie przed przypadkowym opróżnieniem feedu.

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.

4a. Tytuły ofert

W ustawieniach profilu, w karcie Tytuły ofert, wybierz gotowy wzór (nazwa z Shopera, marka i nazwa, nazwa z wariantem i marką) albo złóż własny ze znaczników {nazwa}, {marka}, {wariant} i {kategoria}. Wzór musi zawierać {nazwa}. Przykład pod wyborem pokazuje na żywo, jak będzie wyglądał tytuł; Google zaleca do 150 znaków.

Zmiana dotyczy tylko plików feedu we wszystkich kanałach, nie produktów w Shoperze. Gdy pusty znacznik zostawia po sobie myślnik albo kreskę, GrowFeed sam ją usuwa. Jeśli po złożeniu tytuł wyjdzie pusty, kontrola zatrzyma nową wersję, a poprzedni plik nadal działa.

5. Zapis i sprawdzenie profilu

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

Kontrola zatrzyma nową wersję między innymi przy cenie 0, braku wymaganych danych, powtórzonym identyfikatorze albo gwałtownym ubytku ofert. Błędna wersja nie zastąpi ostatniego poprawnego pliku.

6. Odczyt wyniku

• Plik gotowy: feed przeszedł kontrolę i może być pobierany spod stałego adresu.
• Nowa wersja zatrzymana: popraw wskazany problem w Shoperze. Poprzedni poprawny 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.

6a. Podgląd pozycji w pliku

Karta Podgląd pozycji w pliku pozwala wpisać nazwę lub numer produktu i zobaczyć obok siebie pozycję, którą dostają Google, Meta i Ceneo, razem z krótkim wyjaśnieniem każdego pola. Podgląd czyta ostatni gotowy plik, więc nie pokazuje jeszcze niezapisanych zmian i niczego nie zmienia w sklepie.

Przy zatrzymanej wersji lista przyczyn jest pogrupowana: każda ma oznaczenie „Blokuje plik” albo „Ostrzeżenie”, liczbę produktów i podpowiedź Jak naprawić w Shoperze z miejscem w panelu.

7. Podłączenie stabilnych adresów

Na górze panelu „Najbezpieczniejszy start” prowadzi przez cztery kroki: kanały, zakres produktów, kontrola, wklejenie adresu. Sekcja Gdzie wkleić adres opisuje kolejne kliknięcia w Google, Meta i Ceneo; nazwy menu w kanałach mogą się trochę różnić. Skopiowanie adresu nie oznacza jeszcze przyjęcia pliku przez kanał.

1. W wierszu kanału wybierz Kopiuj.
2. Dodaj skopiowany adres jako zaplanowane źródło danych w Google Merchant Center, źródło feedu w Meta Commerce Manager albo źródło importu 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 pozwala pobrać Twój feed. Nie publikuj go w dokumentacji, zgłoszeniu ani na zrzucie ekranu.

8. Potwierdzenie odbioru

Dla Ceneo po poprawnym ręcznym imporcie wybierz Potwierdź import z panelu. Nie używaj tej opcji po odrzuceniu lub tylko częściowym imporcie.

Google i Meta potwierdzają odbiór na podstawie danych zwracanych przez swoje panele. Dopóki GrowFeed nie otrzyma wyniku dla bieżącej wersji i właściwego zestawu ofert, pokazuje stan niepotwierdzony. Przy wariantach w Meta sprawdź też, czy identyfikatory produktów raportowane przez sklep są zgodne z katalogiem.

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 alert na kontakt sklepu z Shopera, gdy nowy plik zostanie zatrzymany, oraz potwierdzenie po powrocie do poprawnego stanu. Ten sam niezmieniony problem nie generuje kolejnych wiadomości co chwilę. Wiadomości nie zawierają produktów ani adresu feedu.

10. Unieważnienie adresu

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

FAQ i 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 widoczny komunikat. Nie przesyłaj adresu feedu ani danych klientów.