2Performant feed pro Shopify

Vlastní slova 2Performantu: CSV se do platformy přidává odkazem na soubor. Sdílíte URL a oni ji stahují třikrát až čtyřikrát denně, interval lze na vyžádání upravit. Jednorázové nahrání souboru (jejich starší průvodce ho omezuje na 10 MB) je záloha, ne norma. A smlouva o čerstvosti je formulovaná z vaší strany: feed musí být na URL a aktualizovat se automaticky při každé změně. Přesně to je model hostované URL Feedflocku.

Interval působí oběma směry: změny cen a skladu se k afiliátům dostanou během hodin, ale nefunkční URL znamená zastaralá data do příštího úspěšného stažení. Feedflock soubor hostuje na stabilní URL, generuje ho klidně každou hodinu a stahování sleduje, a když ustane, upozorní. A pokud už provozujete feed pro Google Merchant, 2Performant přijme i tu URL beze změny; tahle šablona je pro obchodníka, který chce vlastní sadu polí 2Performantu.

Pravidla pro soubor ze specifikace, citováno: jeden produkt na řádek; textový oddělovač jsou uvozovky, apostrof nebo zpětná uvozovka; oddělovač polí čárka, středník, tabulátor nebo svislítka; UTF-8. Feed může nést tolik informací, kolik potřebujete, a v jejich rozhraní je namapujete na povinná a volitelná pole. Právě proto hlavička šablony používá jejich názvy polí, shodné s jejich vlastním vzorovým CSV: mapování je jen potvrzení každého sloupce.

Starší průvodce přidává přísnost, kterou stojí za to znát: vnořené uvozovky se musí zdvojit, oddělovač řádků je Enter a mezery před řádky nebo jiné drobné chyby můžou znamenat neúspěch celého nahrání. Exportér Feedflocku uvozovkuje a zdvojuje přesně podle předpisu, takže uvozovka uvnitř popisu nikdy nerozbije řádek a rozbitý řádek nikdy potichu nerozbije soubor. Alternativou je XML: RSS i Atom jsou podporované, s doporučením uvádět všechny značky i prázdné.

Povinných je osm polí, s validacemi citovanými přímo ze stránky specifikace. Title je omezený na 255 znaků; Description bere text a jednoduché HTML z výběru (b, li, ul, ol, dl, dd, i, u, br); Category je strom bez uložené taxonomie, tedy cesta vašeho vlastního obchodu. Výchozí mapování šablony jsou ta poctivá: název spojuje produkt a variantu, takže se řádky variant nesrazí, a popis se očišťuje na prostý text.

Tři detaily si zaslouží péči. Sale price je holé číslo (desetinná tečka, bez oddělovače tisíců) a sloupec s měnou v jejich sadě polí nikde není: číslo se čte v měně programu, feed žádnou neuvádí. Product ID musí být číslo, proto je výchozí číselné ID varianty ze Shopify (URI ve tvaru gid:// by pravidlo porušilo; SKU funguje, jen když je číselné). A Availability má šestihodnotový slovník (0, 1, In Stock, Backorder, Out Of Stock, Preorder), přičemž vyprodané řádky ve feedu zůstávají jako 0, nemizí.

Za povinnou osmičkou nese Old price referenční cenu před slevou pod stejnými číselnými pravidly. Šablona ji mapuje z přeškrtnuté ceny v Shopify a nechává prázdnou, když produkt ve slevě není, protože trvale vyplněná stará cena by vymýšlela permanentní slevu. Brand a GTIN doplní identifikaci. Jedna kuriozita specifikace, poctivě zaznamenaná: uvedená validace GTIN (více než 8, méně než 14 znaků) by zamítla legitimní čtrnáctimístný GTIN, takže je v šabloně citovaná, ale záměrně se nevynucuje.

Pro všechno ostatní je tu Other data (JSON nebo YAML) a až čtyři vlastní pole po nejvýš 254 znacích. Stejně výmluvné je, co sada polí neobsahuje: žádného dopravce, žádnou cenu dopravy, žádnou dobírku. Doprava v 2Performant feedu vůbec není, stejně jako sloupec s měnou. Feed popisuje produkty; obchodní podmínky popisuje program.