Merchant API Google PrestaShop

Google Merchant API dla PrestaShop – integracja z Google Shopping

Google Merchant API to moduł PrestaShop umożliwiający bezpośrednią integrację sklepu z Google Merchant Center. Automatyzuje synchronizację produktów, cen, stanów magazynowych, wariantów oraz danych produktowych, ograniczając konieczność korzystania z tradycyjnych plików XML.

Moduł został przygotowany z myślą o sklepach PrestaShop, które chcą sprawnie przesyłać katalog produktów do Google Shopping i utrzymywać aktualne dane bez ręcznego przygotowywania oraz przesyłania feedów produktowych.

Automatyczna synchronizacja produktów z Google Merchant Center

Moduł synchronizuje produkty z PrestaShop bezpośrednio z wykorzystaniem Google Merchant API. Zmiany dotyczące produktu, takie jak cena, opis, zdjęcia czy dostępność, mogą zostać przekazane do Google bez konieczności generowania i przesyłania pliku XML.

Obsługiwane są zarówno produkty standardowe, jak i produkty posiadające kombinacje, takie jak kolor, rozmiar czy materiał.

Synchronizacja obejmuje między innymi:

• nazwę i opis produktu,
• adres produktu w sklepie,
• zdjęcia produktu,
• cenę regularną i promocyjną,
• dostępność produktu,
• GTIN / EAN-13 / UPC,
• MPN,
• markę producenta,
• kategorię Google Product Category,
• typ produktu,
• wagę,
• atrybuty i dane wariantów.

Obsługa wariantów produktów PrestaShop

Moduł obsługuje kombinacje produktów PrestaShop jako warianty produktów w Google Merchant Center. Poszczególne kombinacje są przesyłane z odpowiednimi informacjami dotyczącymi ceny, dostępności, SKU oraz zdjęć.

Warianty są grupowane za pomocą item_group_id, dzięki czemu Google może prawidłowo rozpoznać produkty należące do jednej grupy wariantów.

Automatyczna aktualizacja stanów magazynowych i cen

Zmiana dostępności produktu w PrestaShop może zostać automatycznie przekazana do Google Merchant Center. Moduł obsługuje produkty dostępne w magazynie, dostępne na zamówienie oraz niedostępne.

Synchronizowane są również ceny regularne i promocyjne. W przypadku aktywnej promocji do Google przekazywana jest cena regularna oraz cena obniżona wraz z informacją o promocji.

Google Merchant API zamiast tradycyjnego feedu XML

Bezpośrednia integracja przez API pozwala zrezygnować z wielu czynności związanych z klasycznym feedem XML. Nie trzeba przygotowywać pliku produktowego, przesyłać go na serwer ani konfigurować w Google cyklicznego pobierania danych.

Najważniejsze różnice względem XML:

• bezpośrednie przesyłanie danych do Google Merchant Center,
• automatyczna aktualizacja produktów po zmianach w sklepie,
• brak konieczności ręcznego generowania feedów,
• szczegółowe informacje o błędach zwracanych przez API,
• możliwość synchronizacji pojedynczych produktów,
• kolejkowanie i ponawianie nieudanych operacji,
• lepsza kontrola nad synchronizacją dużych katalogów.

Panel administracyjny PrestaShop

Moduł udostępnia panel administracyjny, w którym można kontrolować proces synchronizacji produktów z Google Merchant Center.

Panel pozwala między innymi na uruchamianie synchronizacji, przeglądanie statusów produktów oraz kontrolowanie błędów i operacji oczekujących w kolejce.

Panel umożliwia:

• ręczne uruchomienie synchronizacji,
• synchronizację wszystkich produktów,
• synchronizację wybranych produktów,
• podgląd liczby zsynchronizowanych produktów,
• podgląd błędów synchronizacji,
• kontrolowanie produktów oczekujących w kolejce.

Automatyczna synchronizacja przez Cron

Proces synchronizacji może działać automatycznie w tle za pomocą zadania Cron. Harmonogram można dostosować do potrzeb sklepu.

Dostępne interwały obejmują między innymi synchronizację co 15 minut, godzinę, 2 godziny, 6 godzin lub raz dziennie.

Produkty oczekujące w kolejce są przetwarzane automatycznie, dzięki czemu administrator nie musi ręcznie uruchamiać synchronizacji po każdej zmianie w katalogu.

Obsługa wielu języków

Moduł umożliwia synchronizację produktów w wielu językach aktywnych w sklepie PrestaShop. Dla poszczególnych wersji językowych mogą być przesyłane odpowiednie nazwy, opisy oraz adresy URL produktów.

Dzięki temu jeden sklep może przygotować ofertę dla klientów korzystających z różnych wersji językowych Google Shopping.

Obsługa PrestaShop Multi-shop

Moduł jest przystosowany do pracy w środowisku PrestaShop Multi-shop. Poszczególne sklepy mogą korzystać z oddzielnych konfiguracji Google Merchant Center lub współdzielić jedno konto.

Produkty są synchronizowane niezależnie dla poszczególnych kontekstów sklepowych, z uwzględnieniem różnic w cenach, dostępności oraz konfiguracji katalogu.

Mapowanie danych produktów

Moduł automatycznie pobiera dane produktów z PrestaShop i przypisuje je do odpowiednich pól wymaganych przez Google Merchant Center.

Obsługiwane dane obejmują:

• tytuł produktu,
• opis produktu,
• link do produktu,
• zdjęcie główne,
• dodatkowe zdjęcia produktu,
• cenę,
• cenę promocyjną,
• dostępność,
• GTIN / EAN,
• MPN,
• markę,
• kategorię Google,
• typ produktu,
• wagę,
• atrybuty produktu.

Custom Labels i dodatkowe atrybuty Google

Moduł umożliwia wykorzystanie pól Custom Label 0–4. Pozwala to dodatkowo uporządkować produkty w Google Merchant Center i wykorzystać własne oznaczenia podczas tworzenia kampanii produktowych w Google Ads.

Obsługiwane są również wybrane atrybuty Google, takie jak GTIN, MPN, marka, kategoria Google, grupa wiekowa, płeć oraz kolor.

Filtrowanie produktów do synchronizacji

Nie każdy produkt musi być przesyłany do Google Shopping. Moduł umożliwia ograniczenie synchronizowanego katalogu według wybranych parametrów.

Produkty można filtrować między innymi według:

• kategorii,
• producenta,
• ceny,
• stanu magazynowego,
• statusu aktywności.

Wybrane produkty można również wykluczyć z synchronizacji bezpośrednio z poziomu ich konfiguracji w PrestaShop.

Promocje i ceny specjalne

Aktywne promocje produktów PrestaShop mogą być automatycznie przekazywane do Google Merchant Center. Moduł przesyła zarówno cenę regularną, jak i promocyjną.

Pozwala to prezentować w Google aktualne ceny produktów oraz informacje o obowiązujących promocjach.

AJAX Batch Sync – synchronizacja dużych katalogów

Moduł wykorzystuje mechanizm synchronizacji wsadowej AJAX, który pozwala przetwarzać duże katalogi produktów bez konieczności jednorazowego przesyłania całego katalogu.

Produkty są dzielone na mniejsze partie, a proces może być kontynuowany bez przeładowywania całej strony. Interfejs pokazuje postęp synchronizacji oraz liczbę przetworzonych produktów i błędów.

Mechanizm jest szczególnie przydatny w sklepach posiadających setki lub tysiące produktów oraz dużą liczbę kombinacji.

System logów i diagnostyka błędów

Każda operacja synchronizacji może zostać zapisana w systemie logów. Administrator otrzymuje informacje o statusie operacji, liczbie przetworzonych produktów oraz ewentualnych błędach zwróconych przez Google Merchant API.

Historia logów ułatwia znalezienie produktu lub pola, które powoduje problem podczas synchronizacji.

Logi mogą być eksportowane do pliku CSV, a starsze wpisy mogą być automatycznie usuwane zgodnie z konfiguracją modułu.

Tryb testowy

Tryb testowy umożliwia sprawdzenie działania modułu przed rozpoczęciem produkcyjnej synchronizacji z Google.

Operacje mogą zostać zasymulowane i zapisane w logach, dzięki czemu administrator może zweryfikować konfigurację oraz strukturę przygotowywanych danych bez wysyłania ich do Google Merchant Center.

Tryb debugowania dla administratorów i deweloperów

Rozbudowany tryb debugowania pozwala analizować komunikację pomiędzy PrestaShop a Google Merchant API.

W logach mogą być zapisywane informacje dotyczące zapytań API, wysyłanych danych JSON oraz odpowiedzi zwracanych przez Google. Ułatwia to diagnozowanie problemów z konfiguracją i synchronizacją produktów.

Bezpieczna autoryzacja Google

Moduł umożliwia wykorzystanie odpowiedniej metody uwierzytelniania podczas połączenia z usługami Google. Obsługa Service Account pozwala skonfigurować integrację przeznaczoną do automatycznej pracy w tle.

Dane uwierzytelniające są przechowywane po stronie sklepu i wykorzystywane do komunikacji z Google Merchant API.

Wymagania techniczne

• PrestaShop 1.7.x – 9.x
• PHP 7.0 lub nowsze
• aktywne konto Google Merchant Center
• projekt w Google Cloud z włączonym Google Merchant API
• dostęp do panelu administracyjnego PrestaShop.

Instalacja i konfiguracja

Moduł instaluje się standardowo z poziomu panelu administracyjnego PrestaShop. Do prawidłowego działania należy skonfigurować połączenie z Google Merchant Center oraz odpowiednie dane uwierzytelniające.

Po skonfigurowaniu połączenia można przeprowadzić test integracji, a następnie rozpocząć synchronizację produktów.

Google Merchant API dla dużych sklepów PrestaShop

Moduł sprawdzi się zarówno w mniejszych sklepach, jak i w rozbudowanych sklepach internetowych posiadających duże katalogi produktów, wiele wariantów lub kilka wersji językowych.

Połączenie bezpośrednio z Google Merchant Center, automatyczna synchronizacja, kolejka produktów, obsługa wariantów oraz szczegółowe logi pozwalają ograniczyć pracę administracyjną związaną z utrzymaniem aktualnego katalogu produktów.

Najważniejsze zalety modułu

• Bezpośrednia integracja z Google Merchant Center przez Merchant API.
• Automatyczna synchronizacja produktów, cen i dostępności.
• Obsługa kombinacji PrestaShop jako wariantów produktów Google.
• Synchronizacja wielojęzyczna dla sklepów sprzedających na różnych rynkach.
• Obsługa Multi-shop w PrestaShop.
• Filtrowanie produktów przeznaczonych do synchronizacji.
• Custom Labels 0–4 do dodatkowego oznaczania produktów.
• Synchronizacja wsadowa AJAX dla dużych katalogów.
• Automatyzacja przez Cron.
• System logów i diagnostyki ułatwiający rozwiązywanie problemów.
• Tryb testowy i debugowania.
• Obsługa cen promocyjnych i stanów magazynowych.

Dla kogo jest moduł Google Merchant API?

Moduł jest przeznaczony dla właścicieli i administratorów sklepów PrestaShop, którzy chcą zautomatyzować przesyłanie produktów do Google Merchant Center i ograniczyć zależność od tradycyjnych feedów XML.

Szczególnie dobrze sprawdzi się w sklepach posiadających duży katalog produktów, liczne kombinacje, częste zmiany cen i stanów magazynowych, wiele języków lub konfigurację Multi-shop.