Merchant API Google PrestaShop

Google Merchant API - Profesjonalna integracja z Google Shopping

Zintegruj swój sklep PrestaShop z Google Merchant Center i zwiększ widoczność swoich produktów w Google Shopping. Moduł oferuje pełną automatyzację synchronizacji produktów z obsługą wariantów, stanów magazynowych i wielojęzyczności.

Główne funkcjonalności

Automatyczna synchronizacja produktów

Moduł automatycznie synchronizuje wszystkie produkty z PrestaShop do Google Merchant Center. Każda zmiana produktu - aktualizacja ceny, tytułu, opisu, zdjęć czy stanu magazynowego - jest natychmiast przekazywana do Google. System obsługuje zarówno proste produkty, jak i produkty z kombinacjami (warianty kolorów, rozmiarów, materiałów).

Dwukierunkowa autoryzacja

Wybierz metodę uwierzytelniania dostosowaną do Twoich potrzeb. OAuth 2.0 umożliwia szybką autoryzację przez przeglądarkę z automatycznym odświeżaniem tokenów. Service Account zapewnia bezobsługową integrację idealną dla automatyzacji. Obie metody gwarantują bezpieczne połączenie z Google Cloud.

Zarządzanie stanami magazynowymi

System automatycznie aktualizuje dostępność produktów w Google Shopping. Gdy stan magazynowy się zmienia, informacja trafia natychmiast do Google Merchant API. Obsługiwane statusy: dostępny w magazynie, dostępny na zamówienie, niedostępny. Synchronizacja obejmuje również ceny regularne i promocyjne.

Panel administracyjny

Intuicyjny interfejs w back office PrestaShop umożliwia pełną kontrolę nad synchronizacją. Dashboard pokazuje statystyki aktywnych produktów, błędów i oczekujących synchronizacji. Możliwość ręcznego uruchamiania synchronizacji dla wybranych produktów lub wszystkich naraz. Import produktów z PrestaShop jednym kliknięciem.

System logów

Kompleksowy system rejestrowania wszystkich operacji synchronizacji. Każda operacja jest zapisywana z dokładnymi informacjami o statusie, liczbie przetworzonych produktów i ewentualnych błędach. Historia logów pozwala na szybką diagnostykę problemów. Możliwość eksportu logów do pliku CSV oraz automatyczne czyszczenie starych wpisów.

Automatyzacja przez Cron

Skonfiguruj harmonogram automatycznej synchronizacji dostosowany do potrzeb sklepu. System przetwarza produkty oczekujące w kolejce zgodnie z ustawioną częstotliwością: co 15 minut, godzinę, 2 godziny, 6 godzin lub raz dziennie. Cron job działa w tle, nie obciążając sklepu podczas godzin szczytu.

Obsługa Multi-shop

Pełna kompatybilność z funkcją multi-shop PrestaShop. Każdy sklep może mieć osobną konfigurację z własnym kontem Google Merchant Center lub współdzielić jedno konto. Produkty są synchronizowane osobno dla każdego sklepu z zachowaniem różnic w cenach i stanach magazynowych. Łatwe przełączanie między kontekstami sklepów.

Obsługa Multi-język

Synchronizacja produktów we wszystkich aktywnych językach sklepu. Każdy język tworzy osobny wpis produktu w Google z właściwym tłumaczeniem nazwy, opisu i linku. Dzięki temu Twoje produkty są widoczne w Google Shopping dla klientów mówiących różnymi językami. Automatyczne generowanie odpowiednich URL dla każdej wersji językowej.

Mapowanie pól produktu

Wszystkie wymagane pola Google Product są automatycznie wypełniane danymi z PrestaShop. System mapuje tytuł, opis, link, zdjęcia główne i dodatkowe (do 10), cenę, cenę promocyjną, dostępność, GTIN, MPN, markę, stan produktu, wagę, kategorie Google i własne typy produktów. Inteligentne wykrywanie kategorii i automatyczne przypisywanie taxonomii Google.

Warianty produktów

Pełna obsługa kombinacji produktów PrestaShop jako warianty Google. System automatycznie grupuje warianty używając item_group_id i przypisuje atrybuty takie jak kolor, rozmiar, materiał. Każda kombinacja jest synchronizowana jako osobny produkt w Google z właściwym SKU, ceną i dostępnością. Zdjęcia wariantów są prawidłowo mapowane.

Promocje i ceny specjalne

Automatyczna synchronizacja cen promocyjnych z PrestaShop. Gdy produkt ma aktywną promocję, system wysyła do Google zarówno cenę regularną jak i obniżoną wraz z datą zakończenia promocji. Google Shopping wyświetla przekreślone ceny pokazując oszczędności dla klientów. Zwiększ konwersję dzięki widocznym zniżkom.

Tryb testowy

Bezpieczne testowanie modułu bez wysyłania danych do Google. Tryb testowy symuluje wszystkie operacje synchronizacji zapisując je w logach PrestaShop. Możesz sprawdzić strukturę danych, przetestować konfigurację i upewnić się że wszystko działa poprawnie przed włączeniem synchronizacji produkcyjnej. Idealne rozwiązanie dla środowisk deweloperskich.

Tryb debugowania

Zaawansowany system logowania dla deweloperów i administratorów. Tryb debug zapisuje szczegółowe informacje o każdym zapytaniu API, strukturze wysyłanych danych JSON i odpowiedziach z Google. Idealne narzędzie do diagnostyki problemów i optymalizacji konfiguracji. Możliwość włączenia tylko dla wybranych operacji bez wpływu na wydajność produkcji.

AJAX Batch Sync

Nowoczesny interfejs synchronizacji wsadowej z obsługą AJAX. Synchronizuj setki lub tysiące produktów bez przeładowania strony i timeout'ów przeglądarki. System dzieli duże zadania na mniejsze partie przetwarzane asynchronicznie. Pasek postępu w czasie rzeczywistym pokazuje liczbę przetworzonych produktów, błędów i pozostały czas. Możliwość wznowienia przerwanych operacji.

Filtrowanie synchronizacji

Precyzyjna kontrola nad tym, które produkty są synchronizowane z Google Shopping. Filtruj produkty według kategorii, producenta, ceny, stanu magazynowego czy statusu aktywności. Wykluczaj wybrane produkty z synchronizacji za pomocą prostego checkboxa w karcie produktu. Idealne dla sklepów z dużym asortymentem, które chcą reklamować tylko określone grupy produktów.

Custom Labels i atrybuty Google

Pełna obsługa zaawansowanych atrybutów Google Shopping. Moduł pozwala na mapowanie Custom Label 0-4 do cech produktu PrestaShop, co umożliwia tworzenie zaawansowanych kampanii w Google Ads. Automatyczne wykrywanie i wysyłanie GTIN (EAN-13, UPC), MPN, kategorii Google Product Category, typu produktu, grupy wiekowej, płci i koloru. Wszystkie pola zgodne z najnowszą specyfikacją Google Merchant API v1beta.

Zalety w porównaniu do eksportu XML

Brak ręcznych operacji

W przeciwieństwie do metody XML, nie musisz ręcznie exportować feedów produktowych, uploadować ich do Google poprzez FTP/SFTP ani konfigurować harmonogramów pobierania. Moduł wysyła dane bezpośrednio przez API automatycznie po każdej zmianie produktu. Zero ręcznej pracy.

Aktualizacje w czasie rzeczywistym

Pliki XML są przetwarzane przez Google z opóźnieniem (zazwyczaj kilka godzin). Merchant API działa natychmiast - zmiany cen, stanów magazynowych i produktów pojawiają się w Google Shopping w ciągu kilku minut. Twoi klienci zawsze widzą aktualne informacje.

Automatyczna walidacja

API Google zwraca błędy walidacji natychmiast podczas wysyłania produktu. Nie musisz czekać na raport z przetwarzania XML ani szukać błędów w feedzie. System pokazuje dokładnie, który produkt i jakie pole zawiera błąd. Błędy są logowane z szczegółowymi komunikatami ułatwiającymi ich naprawę.

Zero opóźnień publikacji

Metoda XML wymaga oczekiwania na cykliczne pobieranie i przetwarzanie feedu przez Google (często 1-2 razy dziennie). Merchant API publikuje produkty natychmiast. Nowy produkt dodany w sklepie może pojawić się w Google Shopping w ciągu 15-30 minut zamiast kilku godzin lub dni.

Lepsze zarządzanie błędami

Gdy plik XML zawiera błąd, cały feed może zostać odrzucony. API pozwala na synchronizację pojedynczych produktów - jeśli jeden produkt ma błąd, pozostałe są prawidłowo przetwarzane. System automatycznie ponawia nieudane synchronizacje i zapisuje szczegółowe logi dla każdego produktu osobno.

Zalety w porównaniu do Content API (deprecated)

Najnowsze Merchant API

Google oficjalnie wycofuje Content API for Shopping i zastępuje je nowoczesnym Merchant API. Nasz moduł już teraz używa najnowszej wersji, która będzie wspierana przez Google w 2025 roku i później. Nie musisz martwić się o przestarzałe API i wymuszoną migrację w przyszłości.

Wsparcie dla wszystkich nowych pól produktowych

Merchant API v1beta wprowadza nowe pola produktowe wymagane przez Google Shopping 2025+: rozszerzone Custom Labels (0-4), shipping dimensions, product highlights, certifications, energy labels i wiele innych. Content API nie będzie aktualizowane o te funkcje. Nasz moduł jest gotowy na przyszłość.

Lepsza struktura danych i wydajność

Merchant API używa nowoczesnego protokołu gRPC (oprócz REST) zapewniającego szybsze połączenia i mniejsze opóźnienia. Struktura danych jest lepiej zoptymalizowana, co przekłada się na szybszą synchronizację dużych katalogów produktów i mniejsze obciążenie serwera.

Zgodność z Google Cloud 2025+

Content API używa przestarzałej infrastruktury Google Cloud. Merchant API jest zbudowane na nowoczesnej architekturze z lepszym bezpieczeństwem, stabilnością i SLA (Service Level Agreement). Google gwarantuje długoterminowe wsparcie i rozwój tylko dla Merchant API.

Wymagania techniczne

• PrestaShop w wersji od 1.7.x do 9.x
• PHP w wersji 7.2 lub wyższej
• Aktywne konto Google Merchant Center
• Projekt w Google Cloud Console z włączonym Merchant API (v1beta)
• Dostęp do panelu administracyjnego PrestaShop

Instalacja i konfiguracja

Moduł jest dostarczany ze wszystkimi wymaganymi bibliotekami - nie potrzebujesz instalować dodatkowych zależności. Po skopiowaniu do katalogu modules wystarczy zainstalować moduł przez panel administracyjny PrestaShop. Konfiguracja wymaga utworzenia projektu w Google Cloud Console i połączenia go z Google Merchant Center.

Szczegółowa dokumentacja instalacji prowadzi krok po kroku przez proces konfiguracji konta Google, tworzenia credentials, weryfikacji domeny i pierwszej synchronizacji produktów. Moduł zawiera wbudowany test połączenia sprawdzający poprawność konfiguracji.

Bezpieczeństwo i wydajność

Wszystkie dane uwierzytelniające są szyfrowane i przechowywane bezpiecznie w bazie danych PrestaShop. System operacji zbiorczych minimalizuje liczbę wywołań API. Optymalizacja zapytań do bazy danych zapewnia płynne działanie nawet przy dużych katalogach produktów.

Wsparcie i aktualizacje

Moduł jest aktywnie rozwijany i aktualizowany zgodnie z najnowszymi wymaganiami Google Merchant API. Kompatybilność z nowymi wersjami PrestaShop jest regularnie testowana. Dokumentacja obejmuje instrukcje dla użytkowników końcowych oraz przewodnik dla deweloperów.

Korzyści dla Twojego biznesu

• Zwiększ widoczność produktów w wynikach wyszukiwania Google
• Dotrzyjcie do milionów potencjalnych klientów korzystających z Google Shopping
• Automatyzacja eliminuje ręczne aktualizacje katalogów produktów
• Oszczędzaj czas dzięki synchronizacji działającej w tle
• Aktualne ceny i stany magazynowe zwiększają zaufanie klientów
• Wsparcie dla wielu języków pozwala sprzedawać na rynkach międzynarodowych
• Multi-shop umożliwia zarządzanie wieloma sklepami z jednego miejsca

Dla kogo jest ten moduł

Idealny dla właścicieli sklepów PrestaShop, którzy chcą zwiększyć sprzedaż poprzez Google Shopping. Szczególnie przydatny dla średnich i dużych e-commerce z rozbudowanym katalogiem produktów wymagającym automatycznej synchronizacji. Doskonały wybór dla sklepów wielojęzycznych i multi-shop potrzebujących kompleksowego rozwiązania integracyjnego.

Zgodność

Moduł jest w pełni kompatybilny z domyślnym szablonem PrestaShop oraz popularnymi szablonami zewnętrznymi. Działa z wszystkimi metodami płatności i dostawy. Nie koliduje z innymi modułami. Obsługuje zarówno zwykłe produkty jak i produkty wirtualne. Kompatybilny z modułami zarządzania zapasami i importu produktów.