DataFirefly Google Shopping: pełny przewodnik

Prezentacja

DataFirefly Google Shopping to moduł dla PrestaShop 8 i 9, który generuje fluxy Merchant Center zgodne ze specyfikacją Google Shopping 2025 i automatycznie dostosowuje je do 6 kanałów (Google, Bing, Meta Catalog, Kelkoo, Idealo, LeGuide). Zawiera 5 asystentów AI (do wyboru Anthropic Claude, OpenAI GPT-4o albo Mistral AI), ocenę jakości 0-100, masowy edytor AJAX, audyt zdjęć przez AI Vision oraz narzędzia premium (testy A/B tytułów, prognoza sezonowa, eksport do Google Ads Editor).

Moduł tworzy 12 tabel z prefiksem dfgs_ i 9 zakładek back office w menu „Google Shopping”. Żadnego override core, żadnego zmodyfikowanego pliku PrestaShop.

Instalacja

1. W back office PrestaShop przejdź do Moduły → Menedżer modułów → Zainstaluj moduł.
2. Wgraj plik dfexportgoogleshopping.zip.
3. Kliknij Zainstaluj. Moduł tworzy swoje tabele, zakładki admina i domyślne wartości konfiguracji.

Wymagania: PrestaShop 8.0 do 9.x, PHP 8.1+, MySQL 5.7+ albo MariaDB 10.3+, włączone rozszerzenie cURL. Multistore i wielojęzyczność są obsługiwane natywnie.

Utworzenie pierwszego fluxu

1. Przejdź do Google Shopping → Fluxy i kliknij Dodaj flux.
2. Podaj nazwę, typ fluxu (Produkty, Local Inventory Ads albo Promocje), sklep, język, walutę i kraj docelowy.
3. Wybierz kanał docelowy: Google Shopping (domyślnie), Bing, Meta Catalog, Kelkoo, Idealo albo LeGuide. Format XML jest dostosowywany do kanału automatycznie (namespace, zmiany nazw atrybutów, limity długości).
4. Skonfiguruj filtry włączania: kategorie, producenci, wykluczanie produktów niedostępnych.
5. Zapisz, a następnie kliknij Generuj. Publiczny adres fluxu (zabezpieczony tokenem) pojawia się na liście, to właśnie jego deklarujesz w Merchant Center.

Mapowanie kategorii Google

W Google Shopping → Mapowanie kategorii przypisz każdą kategorię swojego sklepu do kategorii taksonomii Google (około 6000 wpisów, cache 30 dni). Dwie metody:

• Ręczna: wyszukiwanie z autouzupełnianiem w taksonomii.
• Automatyczne mapowanie AI: przycisk „Mapuj automatycznie” wysyła niezmapowane kategorie do asystenta AI, który proponuje najlepsze dopasowanie. Propozycje o wysokiej pewności są stosowane, pozostałe czekają na zatwierdzenie.

Mapowanie propaguje się na niezmapowane podkategorie. Atrybuty google_product_category i product_type są uzupełniane we fluxie automatycznie.

Nadpisania produktów

Zakładka Nadpisania produktów pozwala wymusić, produkt po produkcie (oraz per język i sklep), wartości we fluxie: tytuł, marka, GTIN, MPN, condition, kolor, rozmiar, materiał, custom labels 0-4, kategoria Google, wykluczenie z fluxu i tak dalej. Nadpisania zawsze mają pierwszeństwo przed wartościami pobranymi z katalogu.

Edycja masowa

Zakładka Edycja masowa wyświetla siatkę AJAX po 50 produktów na stronę, z wyszukiwaniem po nazwie, referencji albo ID. Działanie:

• Edycja inline: kliknij w komórkę, wpisz wartość, naciśnij Enter, zapis następuje natychmiast (zielone tło oznacza sukces).
• Akcja masowa: zaznacz wiele produktów, wybierz pole i wartość, kliknij Zastosuj. Przycisk „Usuń nadpisania” kasuje nadpisania z zaznaczonych produktów.

Import i eksport CSV oraz podgląd

Zakładka Import / Eksport / Podgląd łączy trzy narzędzia:

• Eksport CSV nadpisań albo mapowań kategorii (UTF-8 z BOM, separator średnik, zgodny z Excelem).
• Import CSV z jasną semantyką: pusta komórka oznacza brak zmiany, gwiazdka (*) oznacza wyczyszczenie pola.
• Podgląd XML: podaj ID produktu i flux, aby otrzymać dokładny XML tego produktu wraz z wykrytymi problemami walidacji. Idealne do debugowania odrzuconego produktu.

Asystenci AI

Najpierw skonfiguruj dostawcę w Google Shopping → Ustawienia: Anthropic (Claude), OpenAI (ChatGPT lub GPT-4o) albo Mistral AI, wraz z kluczem API i modelem. Modele zalecane: claude-haiku-4-5-20251001 albo gpt-4o-mini (szybkie i tanie), claude-sonnet-4-6 albo gpt-4o dla maksymalnej jakości.

Zakładka Asystenci AI steruje pięcioma asystentami:

• Mapowanie kategorii: przypisuje Twoje kategorie do taksonomii Google.
• Przepisywanie tytułów: optymalizuje tytuły według wykrytej branży (apparel, electronics, books, home, beauty, food) i wzorców zalecanych przez Google.
• Ekstrakcja atrybutów: wyprowadza color, size, material, pattern, age_group i gender z opisów (pewność co najmniej 0,80).
• Wyszukiwanie GTIN: odnajduje GTIN na podstawie marki, MPN i nazwy, z walidacją modulo 10 (pewność co najmniej 0,85).
• Korekta odrzuceń: analizuje każde odrzucenie w Merchant Center i proponuje ustrukturyzowaną poprawkę (albo stosuje ją automatycznie przy pewności co najmniej 0,85).

Każde wywołanie jest zapisywane w tabeli dfgs_ai_log (dostawca, model, tokeny wejściowe i wyjściowe, czas trwania), więc śledzisz budżet AI co do centa.

Ocena jakości 0-100

Przy każdej generacji fluxu produktowego moduł próbkuje 500 pozycji i wylicza 9 ważonych podocen: pokrycie GTIN (15 pkt), pokrycie zdjęciami (10), jakość zdjęć (10), jakość tytułów (15), jakość opisów (10), mapowanie kategorii (15), pokrycie highlights (10), brak otwartych odrzuceń krytycznych (10), obecność kosztów wysyłki (5). Suma daje ocenę od A plus do F wyświetlaną na pulpicie, z 5 rekomendacjami o największym wpływie na czele listy.

Alerty Slack i e-mail

W Ustawieniach podaj przychodzący webhook Slack albo adres e-mail. Trzy wyzwalacze: wykrycie nowych odrzuceń krytycznych podczas generacji, spadek oceny jakości o co najmniej 10 punktów względem poprzedniej generacji, nieudana generacja. Zabezpieczenie przed zalewem: maksymalnie 1 alert danego typu na 6 godzin.

Funkcje premium

Zakładka Premium łączy 5 narzędzi:

• Analiza Search Console: wgraj eksport CSV zapytań (Search Console → Wyniki wyszukiwania → Eksportuj). Moduł krzyżuje każde zapytanie z tytułami produktów i wylicza ocenę szansy (wyświetlenia razy słowa kluczowe nieobecne w tytule razy mnożnik pozycji). Wyświetlanych jest 20 najlepszych szans wraz z sugerowanym produktem.
• Testy A/B tytułów: dwa warianty rotują we fluxie w cyklach 7-dniowych. Zwycięzca jest ogłaszany, gdy każdy wariant osiągnie co najmniej 500 wyświetleń przy różnicy CTR co najmniej 5 procent, a następnie jest automatycznie stosowany jako nadpisanie.
• Prognoza sezonowa: analizuje 24 miesiące historii zamówień i taguje produkty w custom_label_4: upcoming_season (indeks sezonowy powyżej 1,5 na najbliższe 2 miesiące), bestseller (top 10 procent obrotu z 30 dni), declining_trend (spadek o co najmniej 20 procent w 6 miesięcy).
• Audyt jakości zdjęć: partiami po 25 AI Vision (Claude Vision albo GPT-4o, Mistral nieobsługiwany) wykrywa znaki wodne, teksty promocyjne, typ tła i obecność wielu produktów. Ocena 0-10 na zdjęcie, cache 30 dni.
• Eksport do Google Ads Editor: plik CSV gotowy do bezpośredniego importu, z grupami reklam pogrupowanymi po custom labels i mnożnikami stawek per tag (bestseller ×1,5, upcoming_season ×1,3, on_sale ×1,2, declining_trend ×0,5).

Automatyzacja przez cron

Każdy flux udostępnia adres generacji zabezpieczony tokenem, widoczny na liście fluxów. Przykład wpisu crontab regenerującego flux co 6 godzin:

0 */6 * * * curl -s "https://twoj-sklep.pl/module/dfexportgoogleshopping/cron?token=TWOJ_TOKEN&id_feed=1" > /dev/null

Generacja działa strumieniowo: katalogi liczące ponad 100 000 produktów przechodzą bez wysycenia pamięci.

Rozwiązywanie problemów

• Flux jest pusty: sprawdź filtry fluxu (kategorie, stan magazynowy) oraz to, czy produkty są aktywne i widoczne w sklepie powiązanym z fluxem.
• Produkty wykluczone przy generacji: zajrzyj do zakładki Diagnostyka, każde wykluczenie ma podaną przyczynę (nieprawidłowy GTIN, brak zdjęcia, cena zerowa i tak dalej). Do szczegółów konkretnego produktu użyj podglądu XML.
• Błąd wywołania AI: sprawdź klucz API i model w Ustawieniach. Dziennik dfgs_ai_log zapisuje niepowodzenia wraz z przyczyną.
• Audyt zdjęć kończy się błędem przy Mistralu: to zachowanie oczekiwane, funkcja vision wymaga Anthropic albo OpenAI.
• Po aktualizacji PrestaShop zakładka przestała się wyświetlać: zresetuj moduł (Moduły → dfexportgoogleshopping → Resetuj), aby odtworzyć zakładki admina bez utraty danych.

Deinstalacja

Deinstalacja usuwa 12 tabel dfgs_, zakładki admina i wartości konfiguracji DFGS_. Jeśli chcesz je zachować, wcześniej wyeksportuj nadpisania i mapowania do CSV.