ChatGPT produktový feed pro Shopify

Produktový feed OpenAI má jeden řádek na každou prodejnou položku nebo variantu a devět povinných polí: item_id, title, description, url, brand, seller_name, image_url, availability a price. Názvy mají nejvýš 150 znaků a popisy jsou prostý text do 5 000 znaků: věcný text, který odpovídá na otázky zákazníka, protože právě ten model čte.

OpenAI dává přednost formátu parquet a přijímá i jsonl.gz, csv.gz a tsv.gz, vše v UTF-8 s absolutními, veřejně dostupnými URL. Feedflock vykreslí podobu s tabulátory a kanonickými názvy sloupců OpenAI. Neznámé nepovinné hodnoty zůstávají prázdné, protože zástupné texty jako n/a nebo unknown specifikace zakazuje a prázdná buňka se nikdy nečte jako nula ani false.

item_id je závazek: stabilní, jedinečné pro každou položku či variantu a nikdy znovu použité pro jiný produkt. OpenAI páruje produkty podle item_id, ne podle názvu souboru, a drží ho i při změně ceny, skladu, názvu nebo obrázků. Feedflock používá SKU varianty, a když chybí, ID varianty.

Varianty jednoho produktu odcházejí jako samostatné řádky se společným group_id, které se liší od všech item_id, s nastaveným listing_has_variations a s variant_dict, který vyjmenuje vybrané volby, jako serializovaný JSON v buňce, jak specifikace vyžaduje. Každý řádek nese vlastní cenu, dostupnost, URL a obrázek. Pokud výrobce přiděluje GTIN, pošlete ho: přesně 8, 12, 13 nebo 14 číslic s platnou kontrolní číslicí, bez mezer a pomlček.

Reklamy v ChatGPT stavějí na stejném produktovém feedu. Řádek se ke zpracování pro reklamy přihlásí přes is_ads_eligible: true, nezávisle na způsobilosti pro vyhledávání, takže produkt můžete inzerovat, aniž byste změnili, jak se objevuje v organických odpovědích, nebo ho nechat dohledatelný bez reklamy. Ve Feedflocku je příznak ve výchozím stavu false; zapnete ho pro celý feed nebo po produktech, třeba jen u produktů se štítkem chatgpt-ads v Shopify.

Nákup přímo v ChatGPT vyžaduje vlastní integraci s OpenAI; samotný příznak ve feedu ho nezprovozní. Šablona proto posílá is_eligible_checkout s hodnotou false a zákazníci nakupují ve vašem obchodě. Pokud vám OpenAI nákup zapne, potřebuje navíc seller_privacy_policy a seller_tos, které Feedflock umí odvodit ze stránek se zásadami ve vašem Shopify.

Doručení funguje odesíláním, ne stahováním: OpenAI při onboardingu zřídí SFTP a vaše linka na něj nahrává kompletní export katalogu: snapshot, který platí jako zdroj pravdy, aspoň jednou denně, pod stabilním názvem souboru přepisovaným na místě. Značka dokončení neexistuje: jakmile se nahrávání na chvíli ustálí, OpenAI zpracuje všechny soubory v kořeni SFTP. Úlohou Feedflocku je samotný soubor, přegenerovaný každou hodinu na stabilní URL, takže cron skript, který ho stáhne a odešle, vždy nese aktuální ceny a sklad.

Produkt, který ve zpracovaném snapshotu chybí, se drží až 14 dní, takže jedno rozbité nahrání katalog nevyprázdní. A chcete-li položku vyřadit hned, nastavte is_eligible_search na false. Částky se zapisují jako číslo, mezera a kód ISO 4217 (79.99 USD) a sale_price platí, jen když je kladná, ostře nižší než price a ve stejné měně. Standardní nahrání cílí na USA; měna ani produktová URL samy jiný trh nevyberou.