Rakuten Advertising feed pro Shopify

Dokumentovaný tok Rakuten běží jedním směrem: inzerent nahraje produktová data, Rakuten je zpracuje, ke každému produktu vytvoří odpovídající měřicí URL pro publishlery a výsledek zpřístupní publisherům přes SFTP. Jestli Rakuten umí místo toho pravidelně stahovat hostovanou URL, je popsané jen v inzerentské dokumentaci za přihlášením, proto berte URL feedu, kterou Feedflock vytvoří, jako soubor, který Rakuten předáváte cestou, již vám účet nabízí, ne jako endpoint, který vložíte a zapomenete.

Stojí za vědění: soubor, který publisher stáhne, mluví úplně jiným slovníkem (Product Name, SKU Number, Primary Category, Retail Price, Sale Price, Currency) a dostupnost v něm je s pomlčkami, in-stock a out-of-stock. To jsou úložné tvary Rakuten, ne to, co posíláte. Vývojář, který viděl jen publisherský soubor, se vám feed pokusí „opravit“ do špatného pravopisu.

Všechny názvy atributů ve specifikaci Rakuten jsou googlovské, ale tři uzavřené výčty ne: condition bere New, Refurbished nebo Used, gender Male, Female nebo Unisex a age_group jen Adult nebo Kids: dvě hodnoty tam, kde Google má pět. Zkopírovaný funkční feed z Googlu sem přiveze tři potichu špatné sloupce, a proto šablona kontroluje přesný pravopis.

Další pravidla jsou přísnější než u Googlu. item_group_id je povinné na všech kanálech a slouží ke sloučení variant jednoho produktu do jednoho objektu. Seznam pro gtin je UPC-12, EAN-13 a JAN o 8 či 13 číslicích. Čtrnáctimístný čárový kód je mimo něj a šablona ho nahlásí místo odeslání. Názvy končí na 70 znacích; číslo 255, které jste možná viděli, je velikost úložiště publisherského souboru, ne váš limit.

Jedna věta ve specifikaci Rakuten nese víc peněz než všechny ostatní dohromady: id musí odpovídat identifikátoru položky použitému ve značkování na webu. Id z feedu je spojovník mezi produktovým výpisem a změřeným prodejem. Když konverzní tag hlásí ID varianty ze Shopify a feed posílá SKU, každý prodej zůstane bez přiřazení. Šablona proto ve výchozím stavu bere id ze SKU v Shopify, s ID varianty jako zálohou, když SKU chybí.

Na id záleží ještě dvakrát. Hodnota se po vytvoření položky nesmí změnit: stabilní SKU, nikdy rotující klíč. A duplicity se slučují na první výskyt v souboru, takže obchod, který recykluje jedno SKU napříč variantami, potichu přichází o řádky.

Cenová dvojice Rakuten běží proti intuici: price je původní cena položky a sale_price ta aktuální, povinná vždy, když se liší od běžné ceny. Obě nesou hodnotu i měnu: 19.99 USD. Šablona pracuje s přeškrtnutou cenou: běžná cena jde do price a sale_price se zapíše jen tehdy, když je varianta skutečně ve slevě. DPH Rakuten v celé dokumentaci nikde nezmiňuje.

Obrázky musí mít aspoň 600 × 600 px a až deset dalších jde do additional_image_link, v souboru s tabulátory oddělených čárkou. Doprava a daň mají atributy ve tvaru Googlu, ale Rakuten sám doporučuje nastavit obojí v Google Merchant Center mimo feed, a proto je šablona nechává nenamapované. A provize (náklad, který v affiliate síti rozhoduje) žijí v podmínkách vašeho programu u jednotlivých publisherů, ne ve feedu.