Od pierwszego logowania
do sprawdzonego katalogu.

1. Przygotuj wymagane dane

Potrzebujesz dostępu do konta GrowAds, publicznego adresu HTTPS sklepu, nazwy sprzedawcy, polityki zwrotów i waluty katalogu. V1 obsługuje PLN, EUR i USD oraz pojedynczy kraj docelowy z listy w panelu. Nie przesyłaj plików klientów ani zamówień.

Do testu reklam potrzebny jest klucz Ads API przypisany do Twojego konta OpenAI Ads. Pomiar korzysta z oddzielnego Conversions API key i Pixel ID. Klucz API modeli ani abonament ChatGPT nie zastępują tych dostępów.

2. Zaloguj się i zabezpiecz dostęp

Otwórz panel GrowAds. Wybierz „Zaloguj się”. Rejestracja jest dostępna wyłącznie, gdy została otwarta dla wydania. Podczas tworzenia konta użyj hasła mającego co najmniej 12 znaków i zachowaj jednorazowy kod odzyskiwania w swoim menedżerze haseł. Kod jest pokazywany tylko raz.

Gdy zapomnisz hasła, wybierz „Odzyskaj dostęp”, podaj e-mail, kod i nowe hasło. Kod zostanie zużyty, a dotychczasowe sesje cofnięte. Zapisz pokazany nowy kod odzyskiwania przed ponownym logowaniem. W tej wersji nie wysyłamy linków do resetu e-mailem. Sesja panelu trwa do 2 godzin.

3. Zapisz dane sklepu

W „Pierwsze kroki” wybierz „Uzupełnij dane sklepu”. Wpisz nazwę sprzedawcy, adres sklepu, adres polityki zwrotów, walutę, kraj sklepu i kraj docelowy. Kliknij „Zapisz dane sklepu”. Adresy muszą używać HTTPS. Zmiana tych danych unieważnia wcześniej przygotowany eksport.

4. Sprawdź katalog i przygotuj CSV

1. Otwórz „Katalog produktów” i „Wczytaj plik CSV”. Wybierz UTF-8, separator przecinek i nagłówki: item_id,title,description,url,brand,image_url,price,availability. Dodatkowe pola sprzedawcy mogą pochodzić z zapisanych danych sklepu.
2. Cenę zapisz np. 79.00 PLN. Dostępność: in_stock, out_of_stock, pre_order, backorder albo unknown. Opis ma być zwykłym tekstem, bez HTML. Każdy produkt musi mieć odrębne, stałe ID.
3. Kliknij „Sprawdź katalog”. Panel pokaże zadanie w kolejce. Sprawdzenie zużywa jedną operację z limitu; jego automatyczne ponowienie nie zużywa następnej.
4. Przejrzyj wynik i tabelę błędów. Popraw dane w swoim pliku i wczytaj poprawioną wersję. Nie zmieniamy katalogu sklepu automatycznie.
5. Gdy wszystkie wiersze są poprawne, kliknij „Przygotuj eksport”, a następnie „Pobierz CSV”. Eksport jest dostępny przez 24 godziny od sprawdzenia, przy aktywnym planie.

Kontrola adresów potwierdza ich format; nie jest audytem dostępności wszystkich zdjęć i kart produktu. Poprawny plik nie jest dowodem przyjęcia katalogu przez OpenAI. Wysłanie wymaga osobnego, udostępnionego przez OpenAI połączenia SFTP oraz kontroli historii uploadu.

5. Adapter Shoper — stan przygotowania

Adapter jest administracyjny i przygotowany do testów instalacji. Nie deklarujemy go jako aktywnej integracji przed pełnym E2E. Po udostępnieniu wpisu AppTools instalacja użyje oficjalnego callbacku i OAuth. Scope'y: odczyt produktów, producentów i walut. Aplikacja nie potrzebuje dostępu do klientów, zamówień ani edycji produktów.

Podpisany link w panelu Shopera otwiera GrowAds. W „Dane i dostęp” można wtedy utworzyć osobne dane logowania do panelu standalone. Przy odczycie katalogu brak potwierdzenia ceny widocznej w sklepie lub wariant wymagający wyboru blokuje eksport danego wyniku. Nie zastępuj takiego błędu ręcznym potwierdzeniem poprawności niezweryfikowanej ceny.

6. Połącz konto reklamowe i sprawdź pomiar

1. Otwórz „Połączenia i pomiar”. W sekcji „Konto OpenAI Ads” wpisz klucz Ads API i kliknij „Sprawdź i połącz”. Po udanym odczycie sprawdź nazwę konta, walutę i strefę czasową.
2. W sekcji „Test pomiaru” wpisz Pixel ID i osobny klucz Conversions API. Kliknij „Zapisz dostęp do pomiaru”. Ten zapis nie oznacza jeszcze, że dostawca zaakceptował klucz.
3. Kliknij „Pokaż podgląd testu”. Sprawdź nazwę zdarzenia, wartość 1 jednostki waluty, tryb validate_only i informację o braku danych klienta.
4. Wybierz „Wykonaj test walidacyjny”. To jedna operacja z limitu testów, bez zwiększenia budżetu reklamowego. Wynik HTTP potwierdza odpowiedź endpointu; test nie zapisuje konwersji i nie dowodzi atrybucji.

V1 nie instaluje Pixela i nie wysyła rzeczywistych zakupów. Produkcyjny pomiar zakupów wymaga osobnej konfiguracji zgód, przechwytywania identyfikatorów i deduplikacji przeglądarka–serwer. Nie używaj zgody na newsletter jako zgody na pomiar reklamowy.

7. Przygotuj lokalny szkic kampanii

W „Szkice kampanii” podaj nazwę, łączny limit budżetu i kraj. Kliknij „Pokaż szkic”. Zobaczysz walutę, pełny limit i status „Lokalny szkic”. W strukturze kampanii status pozostaje paused. Nie tworzymy kampanii na koncie reklamowym. Identyfikator lokalizacji, reklamy i pozostałe ustawienia należy zweryfikować w Ads Managerze przed ewentualnym ręcznym startem.

8. Typowe problemy

9. Odłącz integracje lub usuń konto

W „Dane i dostęp” wybierz „Odłącz i usuń dane robocze”, wpisując ODŁĄCZ. Operacja usuwa lokalne klucze, katalogi, szkice, kolejkę i sesje, zachowując zużycie triala oraz dane konta do ponownego logowania. Wpis aplikacji w Shoperze odinstaluj także w jego panelu. Zewnętrzne klucze Ads możesz osobno unieważnić u dostawcy.

„Usuń konto” wymaga wpisania USUŃ i usuwa również dane logowania. Minimalne pseudonimowe zapisy zużycia triala i odebranych callbacków pozostają do ochrony przed ponownym użyciem. Kopie bezpieczeństwa wygasają po 7 dniach. Szczegóły opisuje polityka prywatności.