Produktový feed pro OpenAI (ChatGPT) ze Shopify: co obsahuje a jak ho připravit ve Feedyiu

Když se někdo zeptá ChatGPT, co si má koupit, může dostat odpověď s konkrétními produkty, cenami a odkazy. Pokud vaše produkty ze Shopify nejsou v datech, se kterými ChatGPT pracuje, v jeho odpovědích se neobjeví, ať je váš e-shop jakkoli dobrý. OpenAI tato data dostává od obchodníků jako strukturovaný produktový soubor. Formát má blízko ke Google Shopping feedu, rozdílů je ale dost (příznaky způsobilosti, pole o prodejci, pravidla pro trhy, limity délky), takže obyčejný export CSV ze Shopify nestačí. V článku projdeme, co feed pro OpenAI obsahuje, co znamenají pole způsobilosti, jak soubor ze Shopify připravit ve Feedyiu a na jakých chybách řádky nejčastěji neprojdou.

Hned na začátku jedna věc, ať později nevznikne nedorozumění: Feedyio vygeneruje CSV a hostuje ho na URL vašeho feedu. Do OpenAI ho ale nenahrává ani neodesílá. Předání souboru do OpenAI je krok, který děláte na straně OpenAI. Co k tomu aktuálně říká jejich dokumentace, najdete níže.

Jak se produkty dostanou do ChatGPT

Podle dokumentace OpenAI pro commerce je napojení produktových feedů do ChatGPT zatím dostupné jen schváleným partnerům. Žádost podáte přes formulář, na který odkazuje úvodní návod OpenAI (Get Started). Po schválení máte dvě cesty, jak produktová data posílat: nahrání souboru a API. Pro e-shop na Shopify s nástrojem na feedy dává smysl cesta přes soubor a OpenAI obecně doporučuje posílat celý feed jednou denně jako soubor.

Návod OpenAI k nahrávání souborů v tuto chvíli popisuje odesílání souborů do OpenAI přes SFTP, se stálým názvem souboru, který se přepisuje aktuálním stavem, a to minimálně jednou denně. Podrobnosti předání se mohou měnit a mohou záviset na tom, co s OpenAI domluvíte při onboardingu, proto se při odesílání řiďte jejich aktuálními pokyny. Úkolem Feedyia je mít na stálé URL připravený správný a aktuální soubor.

Co feed pro OpenAI obsahuje

OpenAI přijímá dva profily souboru. Feedyio sestavuje ten kompatibilní s Googlem: CSV oddělené čárkami s hlavičkou, názvy sloupců malými písmeny a pole pojmenovaná jako v Google Shopping, jen bez prefixu g:. Pokud jste někdy připravovali feed pro Google Merchant Center, většinu sloupců poznáte. Specifikace OpenAI uvádí, že tento profil použijete, jakmile ho OpenAI pro váš registrovaný feed potvrdí, a že každý řádek musí mít vyplněné id, title, description, link, image_link, availability, price a brand.

Co šablona „OpenAI (ChatGPT)“ ve Feedyiu do každého řádku vloží a odkud hodnotu bere:

Sloupec	Zdroj hodnoty
id	Ve výchozím stavu ID varianty (lze přepnout na SKU nebo vlastní vzor)
title	Ve výchozím stavu název produktu
description	Popis produktu jako prostý text, zkrácený na 4 900 znaků
link	URL produktu na zvolené doméně
image_link, additional_image_link	Hlavní obrázek a až 10 dalších obrázků
price, sale_price	Cena s kódem měny, např. 79.99 EUR; sale_price jen tehdy, když je cena před slevou (compare-at) vyšší
brand	Výrobce (vendor) produktu
gtin, mpn	Čárový kód varianty a SKU varianty
availability	in_stock nebo out_of_stock
condition, identifier_exists	new; identifier_exists má hodnotu no jen u varianty bez čárového kódu i bez SKU
product_type, google_product_category	Typ produktu ze Shopify; kategorie z vašeho párování kategorií, a pokud se žádné nepoužije, kategorie produktu ze Shopify
item_group_id	Seskupuje varianty jednoho produktu
seller_name	Název vašeho obchodu
target_countries	Kód cílové země feedu (výchozí je země vašeho obchodu)

Další nepovinná pole přidáte v části Additional fields for feed: color, size, gender, age_group, material, pattern, availability_date, seller_privacy_policy a seller_tos. Hlavně u módy se vyplatí posílat barvu a velikost, bez nich jsou skupiny variant mnohem méně užitečné.

Pole způsobilosti v praxi

Šablona má rovnou přidaná tři pole způsobilosti. Jde o běžná pole, takže můžete změnit výchozí hodnotu nebo ji pomocí podmínek nastavit jinak pro konkrétní produkty.

• Eligible for ChatGPT search (is_eligible_search), výchozí hodnota true. Označuje produkt, který chcete zobrazovat ve vyhledávání ChatGPT. OpenAI upozorňuje, že způsobilost zobrazení nezaručuje.
• Eligible for ChatGPT checkout (is_eligible_checkout), výchozí hodnota false. Zařazuje produkt do nákupu přímo v ChatGPT. OpenAI ho bere v úvahu jen tehdy, když je zároveň zapnutá způsobilost pro vyhledávání a když máte checkout u své integrace povolený, což je samostatná dohoda s OpenAI. Dokud ji nemáte, nechte pole vypnuté.
• Eligible for ChatGPT ads (is_ads_eligible), výchozí hodnota true. Označuje produkty pro reklamní systém OpenAI. OpenAI ho vyhodnocuje nezávisle na způsobilosti pro vyhledávání.

Důležitá výhrada z aktuální specifikace OpenAI: u feedů v profilu kompatibilním s Googlem mají přijaté produkty vyhledávání zapnuté a checkout vypnutý a nahrané sloupce způsobilosti na tom nic nemění. Způsobilost pro reklamy se na této cestě řídí nastavením feedu registrovaným u OpenAI a jako prodejce OpenAI použije vaše registrované jméno, ne hodnotu ze sloupce seller_name. Berte proto tyto sloupce jako jasně vyjádřený záměr v souboru a při onboardingu si s OpenAI ověřte, jak je váš registrovaný feed čte. Pokud nějaký produkt v ChatGPT být nemá vůbec, spolehlivá cesta je vyřadit ho ze souboru filtrem (viz část o chybách).

Pokud vám OpenAI checkout zapne, uvádí seller_privacy_policy a seller_tos jako podmíněně povinná pole pro checkout. Přidejte obě v Additional fields jako vlastní hodnotu s odkazem na veřejné stránky se zásadami ochrany osobních údajů a obchodními podmínkami.

Postup ve Feedyiu krok za krokem

1. Založte feed. Na úvodní stránce nebo v sekci Feeds klikněte na Create feed, vyhledejte „OpenAI (ChatGPT)“ a klikněte na Select. Feed se hned uloží s výchozím nastavením kanálu, takže soubor i jeho URL existují od této chvíle.
2. Zkontrolujte obecné nastavení. Nastavte Domain url, na kterou mají vést odkazy na produkty (můžete vybrat některou z domén v Shopify Markets), dále zdroj cen, zemi a měnu a Language pro názvy a popisy. Jeden feed nese jeden ceník a jeden jazyk. Pokud prodáváte na více trzích, feed zduplikujte a změňte trh a jazyk.
3. Projděte pole způsobilosti. V nastavení feedu mají všechna tři pole způsobilosti vlastní sekce s výchozími hodnotami. Změňte výchozí hodnotu, nebo přidejte podmínku (case), aby třeba produkty z jedné kolekce dostaly jinou hodnotu. Pole color, size a další nepovinná přidáte v části Additional fields for feed.
4. Vyřešte kategorie. Bez dalšího nastavení posílá feed jako google_product_category kategorii produktu ze Shopify. Pokud kategorie v Shopify chybí nebo jsou příliš obecné, vytvořte sdílené párování v sekci Category mappings (podle kategorií Shopify, typů produktů, kolekcí nebo pravidel) a připojte ho v Category settings volbou Use categories from category mapping. Párování je ruční nebo pravidlové, Feedyio kategorie neodhaduje. Udržujte také smysluplné typy produktů v Shopify: podle specifikace OpenAI má vyplněný product_type přednost před google_product_category.
5. Vyřaďte, co se zobrazovat nemá. V Exclude Products a Exclude by filter odeberte dárkové poukazy, produkty bez obrázků nebo cokoli dalšího, co v ChatGPT nechcete.
6. Uložte a zkontrolujte URL feedu. Každé uložení soubor znovu sestaví. V Preview feed si prohlédněte několik produktů, přes Open link stáhněte celé CSV a na záložce Analytics uvidíte zařazené, vyřazené a varované položky. URL zkopírujete tlačítkem Copy Public link.
7. Předejte soubor do OpenAI. Při odesílání se řiďte aktuálními pokyny OpenAI. Feedyio drží soubor stále na stejné URL a po každé synchronizaci produktů ho přegeneruje.

K načasování: placené tarify mohou synchronizovat produkty každou hodinu, tarif Free denně nebo týdně. OpenAI doporučuje obnovovat soubor alespoň jednou denně. Hodinová aktualizace na straně Feedyia pomůže jen tolik, kolik stačí vaše předávání souboru do OpenAI.

Nejčastější chyby

GTIN, které nejsou GTIN

Feedyio posílá jako gtin pole Barcode u varianty. OpenAI očekává přesně 8, 12, 13 nebo 14 číslic s platnou kontrolní číslicí, se zachovanými úvodními nulami a bez mezer či pomlček. E-shopy, které mají v poli pro čárový kód interní skladové kódy, tak mají neplatný GTIN na každém řádku. Opravte čárové kódy v Shopify, nebo sloupec gtin skryjte, pokud skutečné kódy nemáte. Pozor také na to, že identifier_exists má hodnotu no jen u varianty bez čárového kódu i bez SKU a že SKU se posílá jako mpn. Podrobněji to rozebírá náš návod ke GTIN a identifier_exists.

Dostupnost, která nestíhá e-shop

Varianta je out_of_stock, když má sklad nula nebo méně a v Shopify je nastavené zastavení prodeje. Varianty s volbou „Continue selling when out of stock“ a varianty bez sledování skladu zůstávají in_stock. Vyprodané položky se u tohoto kanálu ve výchozím stavu nevyřazují, což je obvykle správně, pokud je soubor čerstvý. Skutečný problém je zastaralý soubor: když se sklad rychle mění a soubor se do OpenAI dostane jednou denně, ChatGPT ukazuje včerejší dostupnost. Víc v článku o přesných cenách a skladu díky hodinové synchronizaci.

Obrázky, které nejdou stáhnout

Adresy obrázků musí být veřejné a OpenAI odmítne řádek, jehož URL obsahuje uživatelské jméno nebo heslo. Obrázky z CDN Shopify jsou v pořádku. Obvyklé potíže jsou produkty úplně bez obrázku a zástupné obrázky. Produkty bez obrázku vyřadíte v Exclude by filter podmínkou na obrázky produktu nebo obrázek varianty s operátorem „is empty“. Pokud máte originály obrovské, Image optimizer je zmenší přes obrázkovou CDN Shopify a originály nechá beze změny.

Prázdné popisy nebo popisy plné značek

OpenAI chce prostý text o délce nejvýš 5 000 znaků. Feedyio posílá popis jako prostý text, zalomení řádků nahradí mezerami, dvojité uvozovky jednoduchými a text zkrátí na 4 900 znaků. Jako zdroj popisu nechte Product description; varianta s HTML by do pole dostala značky, které tam nepatří. Větší riziko jsou prázdné popisy, protože description je povinný na každém řádku. Vyřaďte je v Exclude by filter podmínkou na popis produktu s operátorem „is empty“, nebo je raději dopište. Pro názvy platí ve specifikaci OpenAI limit 150 znaků a Feedyio názvy nezkracuje, takže dlouhé názvy zkontrolujte přímo v Shopify.

Slevové ceny, které nesedí

sale_price musí být ostře nižší než price a ve stejné měně, jinak OpenAI řádek odmítne. Feedyio ho vyplní jen tehdy, když je cena před slevou vyšší než aktuální cena, a v takovém případě pošle jako price právě cenu před slevou. Pokud máte ceny před slevou zastaralé nebo nižší než aktuální cenu, opravte je v Shopify.

Časté otázky

Odešle Feedyio můj feed do OpenAI?

Ne. Feedyio vygeneruje CSV a hostuje ho na URL vašeho feedu. Do OpenAI soubor předáte vy podle jejich aktuálních pokynů.

Mohu feed použít i pro jiné země než USA?

Šablona nabízí stejný globální seznam 87 zemí jako Google Merchant Center a pole target_countries vyplní kódem cílové země feedu, což je ve výchozím stavu země vašeho obchodu (nebere se z ceníku ani trhu feedu). Specifikace OpenAI ale aktuálně uvádí, že standardní nahrávání cílí na USA a další trhy platí až poté, co je OpenAI pro vaši integraci potvrdí včetně povolených zemí a měn. Než začnete stavět feedy pro další trhy, ověřte si to s OpenAI.

Už mám feed pro Google Merchant Center. Mohu ho použít?

Názvy polí se z velké části shodují, ve Feedyiu si ale založte samostatný feed „OpenAI (ChatGPT)“. Přidá sloupce pro OpenAI, používá CSV a upraví popisy. Sdílené párování kategorií můžete připojit k oběma feedům, takže kategorie nastavíte jen jednou. Jak spolu obě pole s kategorií souvisí, vysvětluje článek Google product category vs. product type.

Když zapnu „Eligible for ChatGPT checkout“, mohou zákazníci nakupovat přímo v ChatGPT?

Samo o sobě ne. Checkout je samostatná integrace, kterou povoluje OpenAI. Pole jen označí produkty, které do něj mají spadat, jakmile ji máte.

Jak často se soubor aktualizuje?

Feedyio přegeneruje všechny feedy po každé synchronizaci produktů: na placených tarifech každou hodinu, na tarifu Free denně nebo týdně. OpenAI doporučuje posílat čerstvý soubor alespoň jednou denně.

Podrobnosti o kanálu, seznam polí a poznámky k nastavení najdete na stránce feedu pro OpenAI (ChatGPT).

Chcete produktový soubor pro ChatGPT sestavený z vašeho katalogu na Shopify? Vyzkoušejte Feedyio zdarma na Shopify App Store.