Feed Manager AI: konfiguracja w Shopify krok po kroku

Co przygotować

• Sklep Shopify z opublikowanymi produktami.
• Klucz API do AI — tylko jeśli chcesz treści AI lub tłumaczenia. Obsługiwani dostawcy: Anthropic (Claude) i OpenAI (GPT). Sam feed działa bez klucza.
• Dostęp do Google Merchant Center / Meta Commerce Manager — tam wkleisz adres feedu.

Aplikacja prosi o dwa uprawnienia, oba tylko do odczytu: produkty i zamówienia. Niczego w sklepie nie zmienia — tytuły i opisy AI trafiają do feedu, nie do kart produktów w Shopify.

Instalacja i pierwsze kroki

1. Zainstaluj AI Feed Manager z Shopify App Store i zaakceptuj uprawnienia.

2. Na ekranie „Start” kliknij „Synchronizuj ze sklepem”. Po chwili zobaczysz podsumowanie: ile wariantów pobrano, ile jest nowych, ile zmian cen i dostępności.

3. Zaznacz kanały, do których publikujesz. Domyślnie włączone są Google i Meta.

4. Skopiuj adres z sekcji „Adresy feedów” i wklej go w panelu kanału — opis niżej: Podpięcie feedu w Google i Meta.

Karta „Pierwsze kroki” na ekranie Start odhacza cztery etapy: synchronizacja, klucz AI, wygenerowanie treści, wklejenie adresu feedu. Znika, gdy wszystkie są zrobione.

Ekrany aplikacji

Kanały i adresy feedów

• Adres feedu ma postać …/feeds/<identyfikator-sklepu>/google.xml. Gotowe adresy kopiujesz z ekranu Start.
• Wersja językowa to ten sam adres z dopiskiem, np. google.xml?lang=de.
• Wyłączony kanał zwraca błąd 404. Jeśli wyłączysz kanał podpięty w Merchant Center, Google zgłosi błąd pobierania.
• Aplikacja nie pozwala wyłączyć ostatniego aktywnego kanału.
• Walidacja zdjęć sprawdza tylko wymagania zaznaczonych kanałów.

Podpięcie feedu w Google i Meta

Nazwy pozycji w panelach Google i Meta zmieniają się co jakiś czas — poniżej ścieżka aktualna na dzień publikacji.

Google Merchant Center

1. Otwórz Merchant Center → Ustawienia → Źródła danych → dodaj źródło produktów.

2. Wybierz dodanie produktów z pliku i podaj link do pliku — adres google.xml z aplikacji.

3. Ustaw harmonogram pobierania na codzienny, najlepiej rano — aplikacja synchronizuje produkty ze sklepem w nocy.

Meta Commerce Manager

1. Otwórz Commerce Manager → Twój katalog → Źródła danych → dodaj produkty → plik danych (data feed).

2. Wybierz zaplanowany plik i wklej adres meta.xml (albo meta.csv).

3. Ustaw harmonogram codzienny.

Jak sprawdzić, że platforma pobrała feed: ekran „Historia” → „Pobrania feedu przez platformy”. Aplikacja rozpoznaje, kto pobrał plik (Google, Meta, Pinterest, TikTok, Klaviyo, Seznam) i kiedy. To samo w skrócie pokazuje ekran Start: „Ostatnie pobranie przez…”.

Klucz AI i model

1. Wygeneruj klucz u dostawcy: Anthropic — console.anthropic.com → Settings → API keys; OpenAI — platform.openai.com → API keys.

2. W aplikacji otwórz „Ustawienia” → „Klucze AI”, wklej klucz w pole „Klucz API” i kliknij „Zapisz i zweryfikuj”. Klucz Anthropic zaczyna się od sk-ant-, klucz OpenAI od sk-.

3. Aplikacja sprawdza klucz u dostawcy w chwili zapisu. Poprawny potwierdza komunikat „Klucz zapisany i zweryfikowany.”

4. W sekcji „Model AI” wybierz model i kliknij „Zapisz model”. Po pierwszym zapisie klucza aplikacja ustawia model zalecany; listę odświeżysz przyciskiem „Odśwież listę modeli”.

• Za tokeny płacisz bezpośrednio dostawcy. Abonament aplikacji nie obejmuje kosztu AI.
• Klucz jest przechowywany w postaci zaszyfrowanej. Po zapisie aplikacja pokazuje tylko jego początek i końcówkę.
• Możesz zapisać oba klucze i przełączać modele.
• Treści AI wymagają planu Basic lub wyższego.

Generowanie treści AI

1. Zanim uruchomisz cały katalog, otwórz „Prompty AI” i kliknij „Testuj na 3 losowych produktach”. Wynik testu nie jest zapisywany — służy do dostrojenia instrukcji.

2. Na ekranie Start kliknij „Generuj treści AI”. Pasek postępu pokazuje liczbę gotowych wariantów; w każdej chwili możesz kliknąć „Anuluj generowanie”.

3. Sprawdź wynik na ekranie „Podgląd” — wybierz kanał i język, kliknij kartę produktu, żeby zobaczyć wszystkie pola feedu.

Co powstaje:

• Tytuł — do 150 znaków.
• Opis — 300–500 znaków.
• Highlights — 4–6 krótkich punktów dla Google Merchant Center.
• Custom labels — custom_label_0 (półka cenowa), custom_label_3 (sezon), custom_label_4 (grupa docelowa). custom_label_1 jest zarezerwowany dla bestsellerów.

Warianty: produkt z wieloma wariantami dostaje jeden wspólny opis i osobny tytuł dla każdego wariantu. Warianty jednego produktu dzielą jedno zapytanie, więc koszt liczy się za produkt, nie za wariant.

Regeneruj wszystko przepisuje treści AI dla wszystkich produktów poza zablokowanymi i zużywa tokeny — aplikacja pyta o potwierdzenie. Poprzednich wersji tytułów i opisów nie da się przywrócić.

Ręczne poprawki i blokada

• Na ekranie „Produkty” kliknij „Edytuj” i wpisz własny tytuł lub opis. Ręczna treść jest traktowana jak wygenerowana — nocny automat jej nie nadpisze.
• Żeby ochronić produkt także przed „Regeneruj wszystko”, kliknij „Zablokuj”.

Prompty AI

• Cztery pola: prompt dla tytułu, opisu, highlights i custom labels. „Przywróć domyślny” wraca do instrukcji wyjściowej.
• W polu „Kanał” możesz ustawić osobne prompty dla wybranego kanału — nadpisują tytuł i opis tylko w feedzie tego kanału (np. krótsze dla Meta). Puste pole oznacza, że kanał używa treści domyślnych.
• Po zmianie promptów nowe treści używają nowych instrukcji. Istniejące przepiszesz przyciskiem „Regeneruj wszystko”.

Języki i tłumaczenia

1. Otwórz „Języki”. Ustaw „Język źródłowy produktów” i „Domyślny język feedu”.

2. Zaznacz pola do tłumaczenia: Tytuł, Opis, Highlights.

3. Wybierz język docelowy, kliknij „Dodaj”, potem „Zapisz ustawienia”.

4. Przy dodanym języku kliknij „Tłumacz brakujące”. Licznik pokazuje postęp, a link „feed” prowadzi do gotowego adresu z ?lang=.

Dostępne języki: polski, angielski, niemiecki, czeski, słowacki, francuski, hiszpański, włoski, niderlandzki, portugalski, szwedzki, duński, norweski, fiński, węgierski, rumuński, ukraiński. Tłumaczenia idą w kolejce — jeden język naraz. Liczba języków zależy od planu.

Transformacje

• Poprawki zgodności (GMC): usuwanie HTML z opisów, zamiana CAPS LOCK na normalne słowa, dopisanie waluty do cen bez waluty, nadpisanie marki, uzupełnienie age_group i gender, gdy ich brak.
• Znajdź / zamień: reguły dla pól Tytuł, Opis, Marka, Link, Zdjęcia, Kategoria.
• Mapowanie kategorii Google: przycisk „Mapuj kategorie (AI)” dopasowuje Twoje kategorie do oficjalnej taksonomii Google. Każde dopasowanie możesz usunąć. Wymaga klucza AI.

Wykluczenia

• Reguły podstawowe: niedostępne, bez zdjęcia, bez ceny, z ceną 0, poniżej ceny minimalnej, powyżej maksymalnej.
• Kategorie i słowa kluczowe: wyklucz wskazane albo dopuść tylko wskazane — wartości po przecinku. Puste pole „Tylko…” oznacza wszystkie.
• Baner u góry pokazuje, ile produktów reguły wykluczają. Zmiany zapisujesz przyciskiem „Zapisz reguły”.

Zdjęcia

• Kliknij zdjęcie, żeby ustawić je jako główne — wybór obowiązuje dla wszystkich wariantów produktu.
• „Sprawdź zdjęcia” porównuje format, wymiary i rozmiar każdego zdjęcia z wymaganiami zaznaczonych kanałów. Wadliwe zdjęcie jest pomijane, jeśli produkt ma inne, poprawne.
• Konwersja zdjęć na JPG (Meta) — funkcja w Ustawieniach, domyślnie wyłączona. Meta przyjmuje tylko JPEG i PNG; po włączeniu zdjęcia w feedzie Meta są podawane jako JPG. Zmienia to adresy zdjęć, więc Meta jednorazowo przeładuje cały katalog.

Bestsellery

Aplikacja zlicza sprzedane sztuki z zamówień Shopify i nadaje wariantom etykiety A/B/C w polu custom_label_1. Ustawiasz okno w dniach i próg „Top %”. Etykiety odświeżają się co noc; ręcznie — przyciskiem „Synchronizuj sprzedaż”. W kampaniach produktowych możesz dzięki temu wydzielić bestsellery do osobnej grupy.

Ustawienia

• Funkcje — przełączniki: Tytuły AI, Opisy AI, Highlights, Custom labels, Tłumaczenia, Bestsellery ze sprzedaży, Automat nocny, Walidacja zdjęć, Konwersja zdjęć na JPG (Meta). Wyłączone funkcje nie zużywają tokenów AI.
• Identyfikatory w feedzie — domyślnie identyfikator wariantu jako g:id. Jeśli przenosisz się z kanału Google & YouTube w Shopify, wybierz „Format Shopify” (shopify_KRAJ_produkt_wariant) i podaj kod kraju — zachowasz historię produktów w Merchant Center.
• Tagowanie UTM — dopisuje do linków utm_source zależny od kanału; utm_medium i utm_campaign są opcjonalne.

Co dzieje się w nocy

Przy włączonej funkcji „Automat nocny” aplikacja codziennie około 4:00 synchronizuje produkty, odświeża bestsellery, generuje treści AI dla nowych produktów i uzupełnia brakujące tłumaczenia. Automat jest dostępny od planu Basic.

• Plik feedu powstaje w chwili pobrania, na podstawie ostatniej synchronizacji; odpowiedź jest buforowana przez 5 minut.
• Zabezpieczenie przed pustym feedem: jeśli sklep zwróci znacznie mniej produktów niż poprzednio, aplikacja nie wyłącza brakujących i zostawia feed kompletny.

Plany i limity

• Plany płatne mają 3 dni okresu próbnego. Plan Free jest bez limitu czasu.
• Limit wariantów obcina feed. Gdy katalog jest większy niż limit planu, nadwyżka nie trafia do feedu — ekran „Plan” pokazuje wykorzystanie.
• Plan wybierasz przyciskiem „Wybierz plan”; płatność i okres rozliczeniowy obsługuje Shopify.

Typowe problemy

Odinstalowanie i dane

• Po odinstalowaniu aplikacja wstrzymuje automat nocny dla sklepu. Jeśli nie chcesz, żeby platformy dalej pobierały feed, usuń jego adres w Merchant Center i Commerce Managerze.
• Konfiguracja zostaje do czasu, aż Shopify zgłosi usunięcie danych sklepu (48 godzin po odinstalowaniu) — ponowna instalacja w tym oknie przywraca ustawienia.
• Po tym zgłoszeniu aplikacja usuwa wszystko, co przechowuje dla sklepu: produkty, tłumaczenia, historię, ustawienia i klucze AI.
• Klucz AI możesz usunąć w każdej chwili przyciskiem „Usuń” w Ustawieniach.