Kwanko feed pro Shopify

Specifikační článek Kwanka jednou rukou dává: názvy sloupců či polí jsou volné, takže hlavičky šablony ve snake_case a v pořadí z článku jsou čistý výchozí bod, ne povinný pravopis. Samotný soubor je ploché CSV (pole oddělená jedním oddělovačem, text chráněný uvozovkami, UTF-8, první řádek hlavička) s dokumentovanou alternativou v XML (volně pojmenované značky).

A druhou rukou bere: jakmile je katalog vygenerován s poli v určitém pořadí, nemá se regenerovat s jiným. Žádná pole se bez předchozího upozornění Kwanka nepřidávají, neubírají ani nemění formát. Proto workflow šablony zní: nejdřív usadit výběr a pořadí sloupců ve Feedflocku, teprve pak předat URL account managerovi. Feedflock soubor vykresluje na stabilní veřejné URL a generuje ho klidně každou hodinu, takže každé stažení robotem čte aktuální ceny a sklad.

Většina kanálů chyby tiše přechází; Kwanko jmenuje dvě absolutní podmínky. Bez univerzální reference (EAN nebo ISBN) se feed neintegruje vůbec a jednotlivé produkty bez ní se publisherům nenabídnou. Bez jasných kategorií padá stejný ortel. Kategorie je váš vlastní strom, ale dorazit musí jako kompletní breadcrumb s podkategoriemi oddělenými znakem ‚>‘. Jejich příklad zní „Clothes and accessories > Shoes > Sport shoes > Tennis shoes“.

Pod podmínkami stojí vynucované deklarace, které šablona kontroluje při každém generování: popis omezený na 1 000 znaků (HTML povolené), dostupnost vázaná na slovník Googlu (in_stock, out_of_stock, preorder, backorder), condition na new / refurbished / used, adult na yes / no. Porušení uvidíte i s dotčenými produkty, a to dřív, než za ně zaplatí feed a jeho publisherská distribuce.

Kwanko žádný sloupec s měnou nemá: měna jede přímo v ceně. „This cost must include the currency in the ISO 4217 code… For example 9,99 USD“, tedy desetinná tečka nebo čárka, bez oddělovače tisíců, cena včetně daní. Šablona vysílá stejný tvar, „49.00 EUR“, u aktuální i přeškrtnuté ceny.

Přeškrtnutá cena si zaslouží péči: je povinná, přestože jde o referenci před slevou, „produkt bez slevy / akce / výprodeje“. Š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á přeškrtnutá cena by vymýšlela permanentní slevu, kterou zopakuje každý publisher. Kolem dvojice stojí užitečná pole: indikátor slevy (1 sleva / 2 normální / 3 slevové období), ekotaxa, záruka v letech a výkonnostní známka 1–20 podle vašich vlastních kritérií pro zvýraznění nejlepších produktů.

„Náš systém varianty neseskupuje, každá varianta produktu musí být považována za samostatný produkt s unikátní referencí.“ Jeden řádek za variantu je proto přesně správně a výchozí název šablony spojuje produkt a variantu, aby se řádky nesrazily. Interní reference má význam i mimo soubor: obsahuje-li vaše kampaň partnerský retargeting, musí to být právě kód, který pixel posílá. Výchozí mapování používá ID varianty ze Shopify, které se nemění.

Další dva mechanismy žijí mimo sloupce. Měření patří do URL, ne kolem nich: „měřicí informace integrujte přímo do přesměrovávacích URL produktů“, takže utm_source=affiliation a spol. cestují s každým odkazem. A sekce CSS nese odkaz na vstupní stránku, jednu minimální cenu dopravy (0 = doprava zdarma, proto ji šablona záměrně nenamapuje místo vás) a barvu, pohlaví, materiál a velikost, které bezplatné listingy módy vyžadují.