SemaFeed

Joomla rozšíření (package = komponenta + plugin) pro export produktového XML feedu z VirtueMartu do Google Merchant Center. Ceny počítá přímo VirtueMart, takže odpovídají tomu, co vidí zákazník na stránce produktu.

2. Instalace

Získání instalačního balíčku

Stáhněte ZIP soubor pkg_semafeed-X.Y.Z.zip ze SemaHubu (Semakin.cz).

Postup instalace

1. Přihlaste se do administrace Joomla.
2. Přejděte do System > Install > Extensions.
3. Nahrajte ZIP soubor.
4. Joomla nainstaluje oba díly najednou:
   • Komponenta: com_semafeed (Components > SemaFeed)
   • Plugin: plg_task_semafeed (skupina task, pro plánované generování)
5. Instalátor založí šest tabulek #__sema_feed_* a složku images/semafeed/, kam se ukládají hotové feedy.

Upgrade: Stejný postup jako instalace. Joomla použije method="upgrade", takže profily, mapování i log běhů zůstanou zachovány.

4. První profil feedu

Profil je jedno nastavení exportu: které produkty, v jakém formátu, v jaké měně a pod jakou adresou. Profilů může být víc – například jeden pro Merchant Center a jeden pro jiný jazyk webu.

1. Přejděte do Components > SemaFeed.
2. Klikněte na Nový.
3. Vyplňte kartu Základní a uložte.

Karta Základní

Zákaznická skupina rozhoduje o cenách ve feedu. Necháte-li pole prázdné, počítá se cena jako pro nepřihlášeného návštěvníka – a přesně to Google očekává. Velkoobchodní skupina by do feedu poslala ceny, které běžný zákazník na webu nikdy neuvidí, a Merchant Center takový rozpor hlásí jako nesoulad ceny.

Adresa feedu

Soubor vzniká v images/semafeed/ pod názvem {alias}-{token}.xml, takže adresa vypadá takto:

https://vas-eshop.cz/images/semafeed/google-3f8c1e9a7b204d55.xml

Adresu najdete ve sloupci URL feedu v seznamu profilů. Právě ji zadáte v Merchant Centeru.

Token je jediná ochrana adresy. Feed leží ve veřejné složce, aby si ho Google mohl stáhnout bez přihlášení. Neuhádnutelný název je to, co brání komukoli jinému stáhnout celý váš ceník. Tlačítkem Nový token v seznamu profilů se adresa změní – pak ji ale musíte změnit i v Merchant Centeru.

Změna aliasu změní URL feedu se stejným důsledkem. Administrace na to upozorňuje.

Základní URL webu

Pole Základní URL webu (karta Výstup) určuje kořen adres v odkazech na produkty i na obrázky. Prázdné = adresa podle konfigurace Joomly, což je správně na drtivé většině webů.

Nepřidávejte jazykový prefix typu /cs. Jazyk feedu se předává přímo v odkazu na produkt; prefix v základní URL by rozbil adresy obrázků. Pole vyplňujte jen u webů za reverzní proxy, kde Joomla svou veřejnou adresu nezná.

6. Identifikace položek (g:id)

Karta Identifikace určuje, z čeho se skládá jednoznačné ID položky ve feedu.

Zdroj g:id neměňte, jakmile feed jednou běží. Google si podle něj drží historii položky – změna ID vypadá jako smazání starých produktů a založení nových.

8. Výstup – dávky, gzip, délka názvu

Velikost dávky je první věc, kterou snížit, pokud generování končí bílou stránkou nebo chybou 500. Na běžném sdíleném hostingu se osvědčila hodnota 50.

10. Kategorie

Obrazovka Kategorie dělá dvě věci najednou: určuje, které kategorie do feedu patří, a přiřazuje jim Google kategorii.

Dědění

Většina kategorií zůstane na Dědit z nadřazené. Stačí tedy nastavit kořenové kategorie a zbytek se odvodí. U zděděných hodnot administrace vypisuje, odkud pocházejí (vyloučeno podle nadřazené, zděděno z nadřazené: 5013).

Zkopírovat do podkategorií

Tlačítko Zkopírovat do podkategorií uloží tabulku a přepíše Google kategorii a zařazení do feedu u celé větve pod danou kategorií.

Vlastní g:product_type se nekopíruje. Je to cesta kategorií – cesta rodiče je pro potomka věcně špatně.

g:google_product_category a g:product_type nejsou totéž. První je Googlem daný číselník a rozhoduje o zařazení nabídky, druhý je vaše vlastní cesta kategorií a slouží hlavně k rozdělení kampaní.

12. Výjimky u jednotlivých produktů

Výjimka přebije hodnoty jednoho produktu ve feedu, nebo ho z feedu úplně vyřadí. Hodí se na jednotlivé opravy – plošné změny patří do mapování atributů.

1. Otevřete obrazovku Výjimky.
2. Klikněte na Přidat výjimku a najděte produkt podle názvu, SKU nebo ID.
3. Buď zaškrtněte Vyřadit z feedu, nebo vyplňte hodnoty, které se mají přebít.
4. Uložte.

Přebít lze title, description, link, image_link, brand, gtin, mpn, condition, google_product_category, product_type, color, size, material, pattern, age_group, gender a všech pět vlastních štítků.

Výjimka je trvalá. Opravíte-li mezitím data v e-shopu, výjimka je dál přebíjí. Vyplatí se je občas projít.

14. Test cen

Obrazovka Test cen ukazuje, co z profilu vyjde, ještě než se feed vygeneruje. Je to nejrychlejší způsob, jak odhalit špatně nastavenou zákaznickou skupinu nebo filtr.

Diagnostika

V horní části najdete verzi VirtueMartu, počet kandidátů na export, zákaznickou skupinu použitou pro výpočet a spotřebu paměti na dávku.

Tabulka cen

U prvních produktů se vypisuje základní cena bez DPH i s DPH, cena po slevách, sazba DPH a výsledek (Do feedu, nebo důvod vynechání).

Sloupec „Základní s DPH" je to, co půjde do feedu jako g:price. Porovnejte ho s cenou, kterou u téhož produktu vidí nepřihlášený návštěvník – musí sedět na haléř. Nesedí-li, je špatně zákaznická skupina.

Cena za jednotku – co se rozpoznalo

Je-li cena za jednotku zapnutá, přibude přehled pokrytí (u kolika produktů se množství rozpoznalo a z jakého zdroje) a ukázka produktů bez rozpoznaného množství.

Produkty bez hodnoty se odešlou bez ceny za jednotku – to je v pořádku. Nebezpečná je hodnota rozpoznaná špatně, a tu odhalíte jen pohledem na ukázku.

16. Plánované generování

Automatické generování zajišťuje plugin plg_task_semafeed přes Naplánované úlohy Joomly.

1. Povolte plugin (viz sekce 3).
2. Přejděte do System > Naplánované úlohy > Nová.
3. Zvolte typ SemaFeed – generování feedu.
4. Vyplňte ID profilu feedu (najdete ho ve sloupci ID v seznamu profilů) a časový rozpočet v sekundách.
5. Nastavte frekvenci – jednou denně obvykle stačí.

Časový rozpočet nastavte bezpečně pod limit hostingu. Vyčerpá-li se, běh se přeruší uprostřed a pokračuje při dalším spuštění úlohy – feed se tedy dogeneruje i na hostingu, kde by jeden běh nikdy neprošel.

Naplánované úlohy Joomly potřebují cron nebo „lazy cron". Pro spolehlivý provoz nastavte serverový cron:

*/5 * * * * php /cesta/k/joomla/cli/joomla.php scheduler:run > /dev/null 2>&1

18. Napojení na Google Merchant Center

1. Vygenerujte feed a zkopírujte jeho URL ze seznamu profilů.
2. V Merchant Centeru přejděte do Produkty > Zdroje dat a přidejte zdroj typu Naplánované načtení souboru.
3. Vložte adresu feedu a nastavte frekvenci stahování – ideálně o něco řidčeji, než jak často feed generujete.
4. Počkejte na první zpracování a projděte Diagnostiku.

Nastavte v Merchant Centeru stejnou zemi a měnu, jaké má profil. Nesoulad měny je nejčastější důvod, proč se po prvním načtení nezobrazí ani jedna položka.

Co feed obsahuje

SemaFeed zapisuje tyto atributy:

• Povinné: g:id, title, description, link, g:image_link, g:price, g:availability, g:condition
• Identifikace: g:brand, g:gtin, g:mpn, g:identifier_exists
• Zařazení: g:google_product_category, g:product_type
• Varianty: g:item_group_id, g:color, g:size, g:material, g:pattern, g:age_group, g:gender
• Doplňky: g:sale_price, g:additional_image_link, g:shipping_weight, g:expiration_date, g:unit_pricing_measure, g:unit_pricing_base_measure, g:custom_label_0 až 4

g:sale_price se zapíše jen tehdy, když je cena po slevě skutečně nižší než základní. Google ji zobrazuje jako přeškrtnutou původní cenu, takže shodné hodnoty by vypadaly jako klamavá sleva.

20. Řešení problémů

Generování skončí bílou stránkou nebo chybou 500

1. Snižte velikost dávky (například na 50 nebo 30).
2. Zkontrolujte spotřebu paměti na obrazovce Test cen – porovná se s limitem VirtueMartu.
3. Pro velké katalogy použijte naplánovanou úlohu s časovým rozpočtem: běh se rozdělí přes několik spuštění.

Ceny ve feedu nesouhlasí se stránkou produktu

1. Otevřete Test cen a porovnejte sloupec „Základní s DPH" s cenou u nepřihlášeného návštěvníka.
2. Nesedí-li, vyprázdněte zákaznickou skupinu v profilu – nejčastěji je vyplněná velkoobchodní.
3. Zkontrolujte, že profil má správnou měnu.

Feed je prázdný nebo má míň položek, než čekáte

1. Test cen ukáže počet kandidátů na export a u prvních produktů důvod vynechání.
2. Zkontrolujte přepínač Jen zboží skladem, cenový rozsah a režim kategorií.
3. V režimu Whitelist se exportují jen zaškrtnuté kategorie – snadno se zapomene na nově založenou.
4. Produkty bez kategorie se ve výchozím stavu vylučují.

Merchant Center hlásí nedostupné obrázky

• Otevřete adresu obrázku z feedu v prohlížeči. Nestačí, že adresa vypadá správně – musí vrátit obrázek, ne stránku 404.
• Nejčastější příčina je vyplněná Základní URL webu s jazykovým prefixem. Pole vyprázdněte.

Nejde vybrat Google kategorie

• Pro zvolený jazyk není naimportovaná taxonomie – viz sekce 9.
• Blokuje-li hosting odchozí spojení, stáhněte soubor ručně a nahrajte ho.

Naplánovaná úloha neběží

1. Ověřte, že plugin Task – SemaFeed je povolený.
2. Ověřte, že v úloze je vyplněné ID profilu.
3. Ověřte, že profil je publikovaný.
4. Spusťte úlohu tlačítkem Spustit test – výsledek se objeví v Logu běhů profilu.
5. Nemá-li web cron, Joomla úlohy spouští jen při návštěvě stránky („lazy cron") – na málo navštěvovaném webu to nestačí.

Varianty se ve feedu tváří jako samostatné produkty

• Zkontrolujte, že produkty jsou ve VirtueMartu opravdu vedené jako potomci jednoho rodiče.
• Barvu a velikost namapujte na obrazovce Atributy – bez nich Google varianty nerozliší, i když g:item_group_id sedí.

Kontrolní seznam pro spuštění

• Komponenta nainstalována, plugin Task – SemaFeed povolen (pro plánované běhy)
• Profil vytvořen a publikován
• Jazyk a měna profilu odpovídají e-shopu i účtu Merchant Center
• Zákaznická skupina prázdná (nebo vědomě nastavená)
• Google taxonomie naimportovaná pro jazyk profilu
• Kořenové kategorie namapované na Google kategorie
• Značka namapovaná na obrazovce Atributy
• Barva a velikost namapované (pokud e-shop prodává varianty)
• Test cen: „Základní s DPH" sedí s cenou na stránce produktu
• Test cen: pokrytí ceny za jednotku prohlédnuto (pokud je zapnutá)
• Feed vygenerován a tlačítkem Zkontrolovat feed prověřen
• Namátkou otevřen odkaz na produkt a adresa obrázku z feedu
• Naplánovaná úloha vytvořena a otestována tlačítkem Spustit test
• Zdroj dat v Merchant Centeru přidán a první zpracování prošlo