# Gapli Google Merchant

> Moduł WordPress/WooCommerce GAPLI (`gapli-google-merchant`) · kategoria: Marketing · aktualna wersja 1.1.3 · WordPress 6.0+ · WooCommerce 10.0+ · PHP 8.0+  
> Wersja HTML: https://gapli.com/docs/google-merchant

Generuje plik XML z produktami dla Google Merchant Center (darmowe wyniki i reklamy w Google Zakupy) i dodaje na kartach produktów dane strukturalne Product (JSON-LD).

## Gdzie go znajdziesz

Gapli → 🛒 Google Merchant, zakładki: Ustawienia, Kategorie, Atrybuty, Status feeda, Filtry.

## Pierwsze uruchomienie

1. Włącz moduł. Feed i dane strukturalne są domyślnie włączone, a feed odświeża się co 6 godzin.
2. Na zakładce Kategorie przypisz kategoriom WooCommerce kategorie Google — przycisk podpowiedzi dobiera je automatycznie.
3. Na zakładce Atrybuty sprawdź źródła danych: marka z atrybutu pa_brand, GTIN/EAN z pola _gtin (moduł sprawdza też _ean, _global_unique_id, _barcode), MPN z SKU.
4. Na zakładce Status feeda skopiuj adres feedu: https://<domena-sklepu>/gapli-feed/google-merchant.xml.
5. W Google Merchant Center dodaj źródło danych produktów typu „plik pod adresem URL” i wklej ten adres.

## Co dzieje się automatycznie

- Odświeża feed co 1, 3, 6 lub 12 godzin albo raz dziennie (domyślnie co 6 godzin). W feedzie są tylko opublikowane produkty.
- Pomija produkty bez zdjęcia (domyślnie) — opcjonalnie także produkty bez GTIN.
- Gdy pliku jeszcze nie ma, generuje go przy pierwszym wejściu na adres feedu.

## Wymagania i powiązane moduły

- Gapli Full Dropshipping — bez niej ekran modułu nie pojawi się w menu.
- Rozszerzenie PHP XMLWriter.
- Zalecany Gapli AI Hub — przy nim podpowiedzi kategorii Google robi AI, bez niego moduł dopasowuje po nazwie.
- Gdy działa Yoast SEO, Rank Math lub SEOPress, moduł nie dodaje własnych danych JSON-LD, żeby ich nie dublować.

## Gdy coś nie działa

- **„Wymagane jest rozszerzenie PHP XMLWriter”** — Poproś hosting o włączenie rozszerzenia XMLWriter.
- **„WP-Cron jest wyłączony na tym serwerze”** — Ustaw u hostingu systemowy cron albo generuj feed ręcznie przyciskiem „Regeneruj feed teraz” na zakładce Status feeda.
- **Pod adresem feedu jest odpowiedź „Feed is being generated”** — Feed jest właśnie tworzony. Spróbuj ponownie za kilka minut.