Stav informací: 27. 8. 2026
Primární zdroje: OpenAI Developers – Product Feeds, OpenAI Developers – Products feed specification, OpenAI Help Center – Create Campaigns from Product Feeds a OpenAI Merchant Feed Terms.
Aktualizace článku: Tento návod používá stabilní flat-file specifikaci OpenAI a aktuální požadavky pro produktové reklamy. Rozhraní Ads Manageru, dostupné způsoby přenosu i schéma feedu se mohou měnit; před nasazením proto vždy znovu otevřete odkazované primární zdroje.
Příprava e-shopu na produktový feed pro ChatGPT Ads nezačíná exportem CSV. Začíná rozhodnutím, odkud budou pocházet pravdivé údaje o produktu, co bude stabilním identifikátorem varianty a jak zajistíte shodu mezi feedem a cílovou stránkou. Teprve z těchto pravidel má vzniknout soubor nebo automatizovaný přenos.
OpenAI popisuje produktový feed jako katalog, který udržuje aktuální názvy, popisy, ceny, dostupnost, obrázky a cílové URL. U kampaně z feedu nemusíte vytvářet samostatnou reklamu pro každou položku; systém může při doručení vybrat způsobilý produkt z připojeného katalogu. To ale funguje pouze tehdy, když jednotlivé řádky představují skutečné a udržované produkty nebo varianty.
Tento článek se proto soustředí na datovou a provozní připravenost e-shopu. Obecný postup založení feedové kampaně jsme popsali v předchozím dílu. Zde projdeme stabilní identifikátory, povinná pole, varianty, ceny, sklad, obrázky, URL, způsobilost pro reklamy, kontrolní pravidla a předávací checklist pro vývojáře i správce katalogu.
Rychlá odpověď
E-shop je připravený na produktový feed pro ChatGPT Ads tehdy, když umí pro každý produkt nebo variantu opakovaně vytvořit konzistentní záznam a při změně katalogu ho bezpečně aktualizovat. Pro Google-kompatibilní profil aktuální specifikace OpenAI uvádí jeden produkt nebo variantu na řádek a na každém řádku požaduje tato základní pole:
id,title,description,link,image_link,availability,price,brand.
Pro Ads zpracování je navíc potřeba u každého produktu určeného pro reklamu nastavit kanonické pole is_ads_eligible na hodnotu true. OpenAI výslovně upozorňuje, že pole is_ads_enabled se pro tento účel nepoužívá. Samotná způsobilost zároveň nezaručuje, že se produkt bude doručovat.
Největší část práce není pojmenování sloupců, ale řízení jejich zdrojů. Cena musí pocházet ze stejné obchodní logiky jako cena na detailu produktu, dostupnost ze stejného skladu, obrázek ze stejné varianty a cílová URL musí vést na funkční produktovou stránku. Pokud export skládá data z různých, časově nesladěných systémů, formálně validní feed může být obchodně chybný.
Nejdřív rozlište oficiální požadavek a vlastní provozní pravidlo
V praxi se snadno smíchají tři různé vrstvy:
- specifikace OpenAI určuje podporovaná pole, datové typy, povinnosti a validační pravidla,
- data e-shopu určují, co je skutečný produkt, varianta, cena, sklad a cílová stránka,
- redakční nebo provozní pravidla určují, jak často export běží, kdo řeší chyby a jaké kontroly musí projít.
Oficiální specifikaci nelze nahradit interním checklistem. Stejně tak ale samotná specifikace nenastaví vlastnictví dat ve firmě. Proto jsou následující části vždy označené podle toho, zda jde o fakt z dokumentace OpenAI, nebo o praktické doporučení pro implementaci.
1. Určete kanonický zdroj každého pole
Fakt OpenAI: stabilní specifikace definuje základní produktová data, média, cenu, dostupnost, varianty a další volitelné objekty. Každý nahraný řádek je samostatně validován a OpenAI může odmítnout jeden chybný produkt, zatímco ostatní platné řádky pokračují ve zpracování.
Praktický redakční postup: před tvorbou exportu si vytvořte datovou mapu. Pro každé pole zapište zdrojový systém, konkrétní atribut, transformační pravidlo, vlastníka a četnost aktualizace. Například:
idz variantního SKU nebo interního neměnného ID,titlez publikovaného názvu varianty,descriptionz čistého produktového popisu bez HTML,linkz kanonické URL detailu produktu nebo varianty,image_linkz hlavního obrázku konkrétní položky,availabilityze skladu nebo objednávkového pravidla,pricez cenové vrstvy použité na webu,brandze spravovaného atributu značky, nikoli z volného textu.
Pokud jeden údaj nemá jasný zdroj, exportér ho bude doplňovat odhadem, výchozí hodnotou nebo ručním přepisem. To je signál, že e-shop ještě není datově připravený.
2. Zvolte stabilní identifikátor produktu nebo varianty
Fakt OpenAI: v kanonickém schématu je item_id povinný, unikátní pro variantu, může mít nejvýše 100 znaků a musí zůstat stabilní v čase. U Google-kompatibilního vstupu se pole id mapuje na item_id.
Identifikátor nemá obsahovat cenu, skladovou dostupnost, název kampaně ani jiné proměnlivé hodnoty. Pokud se například cena změní z 990 na 1 090 Kč, produkt musí zůstat stejným produktem. Změna ID by z aktualizace udělala novou položku a ztížila by návaznost dat.
Praktický checklist:
- Je ID jednoznačné napříč celým exportem?
- Má každá varianta vlastní ID?
- Zůstane ID stejné po změně názvu, ceny, obrázku nebo kategorie?
- Nehrozí recyklace starého ID pro jiný produkt?
- Umí zákaznická podpora nebo vývojář dohledat podle ID konkrétní položku v e-shopu?
3. Rozhodněte, co je produkt a co varianta
Fakt OpenAI: flat-file profil používá jeden produkt nebo variantu na řádek. Pro související varianty specifikace doporučuje stabilní společné group_id, příznak listing_has_variations a objekt variant_dict. Pro oblečení jsou dále popsána pole jako barva, velikost a systém velikostí.
Praktický redakční postup: variantu oddělte tehdy, když se samostatně objednává, má vlastní sklad, cenu, obrázek nebo cílový stav. Typickým příkladem je velikost obuvi, barevná varianta batohu nebo kapacita elektronického zařízení. Naproti tomu čistě prezentační parametr bez vlivu na objednávku nemusí vytvářet nový řádek.
Nejčastější chyba vzniká, když export vytvoří jeden řádek pro nadřazený produkt, ale vezme cenu z první varianty, obrázek z druhé a sklad ze součtu všech variant. Takový záznam může vypadat úplně, ale nepopisuje žádnou konkrétní nabídku.
4. Připravte titulky a popisy jako čistá produktová data
Fakt OpenAI: kanonický title je povinný, má limit 150 znaků a dokumentace doporučuje vyhnout se textu psanému celý velkými písmeny. description je povinný, má limit 5 000 znaků a přijímá pouze čistý text. U Google-kompatibilního profilu se mají použít prosté hodnoty title a description; strukturované alternativy se nemapují.
Praktický redakční postup: název musí identifikovat položku, nikoli suplovat reklamní slogan. U varianty zahrňte vlastnost, která ji odlišuje, pokud je důležitá pro správné pochopení nabídky. Popis má být věcný a musí odpovídat cílové stránce. Z exportu odstraňte HTML značky, navigační texty, tlačítka, vložené formuláře a zbytky editoru.
Dobrou kontrolou je otázka: pochopí člověk z názvu a popisu, co se prodává, aniž by musel hádat podle obrázku? Pokud ne, datový záznam není připravený.
5. Udržujte cenu ve správném formátu a kontextu
Fakt OpenAI: price je povinná kladná částka s třípísmenným kódem měny podle ISO 4217. Specifikace popisuje omezenou výjimku pro podporované mobilní předplatné; běžný produkt nemá používat nulovou cenu. Volitelná sale_price musí být kladná, ve stejné měně a nižší než běžná cena. Pro časově omezenou akci jsou k dispozici datum začátku a konce v ISO 8601.
Praktický checklist:
- Obsahuje hodnota částku i správný kód měny?
- Odpovídá cena variantě a cílové stránce?
- Je akční cena skutečně nižší než běžná cena?
- Má časově omezená akce správné začátky a konce?
- Neexportuje se cena bez daně tam, kde stránka zobrazuje cenu s daní?
- Je při více trzích jasné, která cena patří k registrovanému feedu?
Poslední dvě otázky jsou provozní a právní kontrola e-shopu, nikoli univerzální pravidlo OpenAI pro české ceny. Cílem je zabránit rozporu mezi reklamním záznamem a skutečnou nabídkou.
6. Překládejte sklad do podporovaných stavů
Fakt OpenAI: kanonické pole availability je povinné a podporuje hodnoty in_stock, out_of_stock, pre_order, backorder a unknown. Pro pre_order je vyžadované budoucí availability_date. Google-kompatibilní mapování kopíruje in_stock, out_of_stock a backorder a mapuje preorder na pre_order.
Praktický redakční postup: vytvořte explicitní mapovací tabulku mezi interními stavy e-shopu a hodnotami feedu. Interní označení jako „skladem u dodavatele“, „na dotaz“, „do tří dnů“ nebo „předobjednávka“ nelze bez rozhodnutí pouze překopírovat. Musíte určit, který podporovaný stav skutečně popisuje možnost nákupu.
Mapování má vlastnit člověk, který rozumí objednávkovému procesu, ne pouze autor exportéru. Vývojář může implementovat pravidlo, ale neměl by odhadovat obchodní význam interního stavu.
7. Zajistěte veřejné a správné URL
Fakt OpenAI: kanonická produktová url je povinná, musí vrátit HTTP 200 a dokumentace preferuje HTTPS. U Google-kompatibilního profilu se používá link a platné HTTP nebo HTTPS URL. Nahraná URL obsahující uživatelské jméno nebo heslo vede k odmítnutí řádku; přihlašovací údaj OpenAI ve validačních detailech rediguje.
Praktický checklist:
- Vede URL přímo na odpovídající produkt nebo variantu?
- Vrací bez přihlášení stav 200?
- Nekončí na přesměrování do jiné země, jazyka nebo měny?
- Neobsahuje dočasný podepsaný parametr s krátkou platností?
- Nevede smazaný produkt na obecnou kategorii nebo domovskou stránku?
- Souhlasí název, cena, dostupnost a obrázek s feedem?
Kontrolu dělejte automaticky i ručně na vzorku. Samotný HTTP 200 neprokazuje, že stránka obsahuje správný produkt.
8. Připravte obrázky jako produktová data, ne dekoraci
Fakt OpenAI: kanonické image_url je povinné; specifikace uvádí JPEG nebo PNG a preferuje HTTPS. V Google-kompatibilním profilu se image_link mapuje na hlavní veřejnou URL obrázku. Volitelné dodatečné obrázky se předávají v samostatném poli.
Praktický redakční postup: hlavní obrázek musí odpovídat přesně tomu produktu nebo variantě, kterou řádek popisuje. Nepoužívejte dočasnou administrační URL, soubor přístupný jen po přihlášení ani obecnou fotografii celé kategorie. Při změně varianty zkontrolujte, že se mění i obrázek, pokud je vizuální rozdíl pro zákazníka důležitý.
Do technického QA zahrňte dostupnost obrázku, MIME typ, rozumnou velikost, stabilní HTTPS adresu a kontrolu, zda server nevrací místo obrázku HTML chybovou stránku. Tyto body jsou praktickým doporučením; přesné technické limity vždy přebírejte z aktuální specifikace OpenAI.
9. Zapněte Ads způsobilost správným polem
Fakt OpenAI: Ads feed používá stejné základní schéma jako stabilní produktový feed a navíc vyžaduje is_ads_eligible=true pro každý produkt, který mají reklamy zpracovat. Starší alias is_eligible_ads je přijímán, ale pro nové feedy má být použito kanonické pole. is_ads_enabled Ads ingest nečte.
Příznak nepřidávejte bez rozmyslu ke každému řádku pouze proto, aby upload prošel. V e-shopu mohou být produkty, které nechcete propagovat, nemají vyhovující cílovou stránku, nemají spolehlivý sklad nebo nespadají do podporované reklamní kategorie.
Praktický redakční postup: definujte pravidlo způsobilosti před exportem. Může zahrnovat aktivní produkt, platnou cenu, veřejnou stránku, dostupný obrázek, povolenou kategorii a interní souhlas s propagací. OpenAI zároveň uvádí, že způsobilost je nutná, ale nezaručuje doručení produktu.
10. Připravte metadata pro budoucí členění reklamních skupin
Fakt OpenAI: volitelné ads_metadata přijímá objekt s textovými klíči a textovými hodnotami. Dokumentace uvádí příklady bidding_tier a product_line. Help Center doporučuje toto pole využít, pokud běžné produktové filtry nestačí pro zamýšlené členění produktů v reklamní skupině.
Praktický redakční postup: metadata navrhněte jako stabilní obchodní klasifikaci, ne jako náhodnou poznámku. Dobré hodnoty se dají konzistentně dopočítat a dlouhodobě udržovat. Produktová řada, sezóna nebo interní kategorie mohou být užitečné; dočasný ruční štítek bez vlastníka se rychle rozpadne.
Tomuto tématu se podrobně věnuje další díl série o produktových reklamních skupinách a filtrech. V přípravné fázi stačí zajistit, že e-shop dokáže potřebné členění do feedu spolehlivě dodat.
11. Vyberte přenos podle skutečného provozu
Fakt OpenAI: Help Center pro Ads Manager popisuje ruční upload CSV nebo TXT, hostovanou stabilní HTTPS URL a SFTP připojení. Zároveň uvádí, že položky expirují po dvou týdnech, a proto doporučuje hostovanou URL nebo automatizované SFTP aktualizace. Samostatná vývojářská dokumentace pro Ads API popisuje vytvoření feedového spojení v Ads Manageru, přenos katalogu na zobrazené SFTP a následné dílčí aktualizace existujících variant přes Delta Feeds API.
Tyto zdroje popisují různé pracovní cesty. Pro ruční obsluhu v Ads Manageru se řiďte možnostmi, které vidíte v konkrétním účtu. Pro integraci přes veřejné Advertiser API se řiďte vývojářskou dokumentací; ta výslovně uvádí, že veřejné API nevytváří feed connection ani nenahrává katalogový soubor přes běžný endpoint pro kreativní assety.
Praktický výběr:
- ruční CSV/TXT pro malý pilot a občasné změny, pokud má někdo odpovědnost za aktualizaci,
- hostovaná HTTPS URL pro pravidelně generovaný export dostupný na stabilní adrese, pokud je tato možnost v účtu dostupná,
- SFTP pro řízený serverový přenos a automatizaci podle nastavení Ads Manageru,
- Delta Feeds API pro podporované dílčí změny existujících variant po úvodním katalogovém uploadu v dokumentovaném API workflow.
12. Zaveďte validaci před odesláním
Fakt OpenAI: podporovaný flat-file formát používá UTF-8, jednu hlavičku s kanonickými malými názvy polí oddělenými podtržítkem a jeden produkt nebo variantu na řádek. Podporovaný Google-kompatibilní profil přijímá tabulátorem oddělené TXT/TSV nebo čárkou oddělené CSV a také vybrané gzip varianty. Kompatibilní cesta ale nepokrývá každý program, trh, atribut nebo reprezentaci feedu.
Praktický redakční checklist validátoru:
- Soubor je v UTF-8 a obsahuje právě jednu hlavičku.
- Každý řádek má unikátní a stabilní ID.
- Všechna povinná pole jsou vyplněná.
- Textová pole neobsahují nečekané HTML nebo řídicí znaky.
- URL produktu a obrázku jsou syntakticky platné a veřejně dostupné.
- Cena obsahuje částku a měnu; akční cena splňuje podmínky.
- Dostupnost patří mezi podporované hodnoty a podmíněná data jsou doplněná.
- Varianty mají vlastní ID a správné seskupení.
- Produkty určené pro reklamy mají
is_ads_eligible=true. - Počet řádků a rozdělení stavů nevybočuje proti předchozímu běhu.
Poslední bod je čistě provozní pojistka. Když katalog přes noc klesne z deseti tisíc položek na padesát, validní formát není důvod takový export automaticky publikovat.
13. Otestujte malý reprezentativní vzorek
První test nemá obsahovat jen nejjednodušší produkt. Vyberte vzorek, který pokrývá různé datové situace:
- jednoduchý produkt bez variant,
- produkt s více variantami,
- produkt v akci,
- položku skladem a mimo sklad,
- předobjednávku, pokud ji používáte,
- produkt s odlišným hlavním obrázkem pro variantu,
- produkt, který má být z Ads vyloučen.
Fakt OpenAI: po uploadu může zpracování podle velikosti trvat od několika minut po několik hodin a stav i chyby jsou dostupné v Upload History. Pro kontrolu připravenosti při tvorbě reklamní skupiny je důležitý počet produktů, které prošly filtry; záložka Products je reportovací pohled a nemusí zobrazit celý nahraný katalog.
Praktický redakční postup: u každé testovací položky porovnejte zdrojový záznam, exportovaný řádek, výsledek validace, náhled v Ads Manageru a veřejnou cílovou stránku. Teprve když tato cesta sedí, rozšiřte export na celý katalog.
14. Nastavte provoz, ne pouze jednorázový export
Produktový feed je průběžná integrace. Změny cen, skladu, URL a sortimentu musí mít vlastní rytmus a dohled. OpenAI uvádí dvoutýdenní expiraci položek v Ads Manager workflow, takže ruční soubor bez kalendáře a odpovědnosti není dlouhodobé řešení.
Praktický provozní model:
- e-shop nebo katalog vytvoří konzistentní snapshot,
- exportér transformuje data do aktuálního schématu,
- validátor zastaví soubor s kritickou chybou nebo nečekaným výkyvem,
- schválený feed se předá dokumentovanou cestou,
- Upload History se zkontroluje a chyby se přiřadí vlastníkovi,
- náhodný vzorek se porovná s webem,
- výsledek a čas běhu se uloží do provozního logu.
Rozdělte odpovědnosti. Vývojář vlastní export a technický přenos, správce e-shopu kvalitu katalogu, marketing způsobilost a členění pro reklamy a provozní vlastník reakci na chyby. Konkrétní rozdělení je interní rozhodnutí, ne požadavek OpenAI.
Minimální předávací zadání pro vývojáře
Následující blok je praktická redakční šablona, kterou lze upravit pro konkrétní e-shop:
- Vytvořit export podle aktuální stabilní OpenAI product feed specification.
- Použít jeden produkt nebo variantu na řádek.
- Zajistit stabilní unikátní ID varianty.
- Mapovat povinná produktová pole z kanonických zdrojů e-shopu.
- Přidat
is_ads_eligible=truepouze pro schválené položky. - U variant použít stabilní seskupení a správné variantní atributy.
- Exportovat čistý text, veřejné URL, správnou cenu s měnou a podporovanou dostupnost.
- Validovat soubor, řádky, URL, obrázky a podmíněná pole před přenosem.
- Logovat počet položek, chyby, čas běhu a výsledek odeslání.
- Připravit bezpečný mechanismus opakování a upozornění při selhání.
Kontrolní seznam před prvním plným feedem
- Má každý produkt nebo varianta vlastní stabilní ID?
- Jsou název a popis čisté, věcné a v limitech aktuální specifikace?
- Vede každá URL na správný produkt a vrací HTTP 200?
- Je každý hlavní obrázek veřejný a patří konkrétní položce?
- Souhlasí běžné a akční ceny s cílovými stránkami?
- Je interní sklad správně mapovaný na podporované stavy?
- Mají předobjednávky požadované datum dostupnosti?
- Jsou varianty správně seskupené?
- Mají položky určené pro reklamy kanonické
is_ads_eligible=true? - Jsou vyloučené produkty opravdu označené jako nezpůsobilé?
- Prošel malý reprezentativní vzorek Upload History a ruční kontrolou?
- Je nastavená frekvence obnovy před expirací položek?
- Je jasné, kdo řeší chyby katalogu, exportu a přenosu?
Nejčastější chyby při přípravě e-shopu
ID se skládá z proměnlivých údajů
Změna ceny nebo názvu vytvoří nové ID. Tím se aktualizace mění v novou položku. ID má vycházet ze stabilní identity produktu nebo varianty.
Jeden řádek směšuje více variant
Obrázek, cena a sklad pak nemusí popisovat stejnou nabídku. Varianta, která se samostatně objednává, má mít vlastní konzistentní záznam.
Feed přebírá HTML popis z editoru
Specifikace u popisu vyžaduje čistý text. Exportér musí odstranit značky a obsah, který není součástí produktového popisu.
Ads příznak má chybný název
Pro nové feedy použijte is_ads_eligible. OpenAI výslovně uvádí, že is_ads_enabled se nečte.
Úspěšný upload se zamění za obchodní správnost
Validátor může přijmout syntakticky správnou cenu, která ale neodpovídá webu. Formátová a věcná kontrola jsou dvě samostatné vrstvy.
Ruční export nemá vlastníka
Po prvním nahrání se ceny a sklad přestanou aktualizovat a položky mohou po dvou týdnech expirovat. Ruční režim potřebuje kalendář, odpovědnost a kontrolu výsledku.
Závěr
Připravený e-shop nevytváří pouze soubor, který projde validací. Vytváří katalog, ve kterém jeden řádek jednoznačně popisuje jeden skutečný produkt nebo variantu, používá stabilní identitu, správnou cenu, aktuální dostupnost, odpovídající obrázek a funkční cílovou stránku.
Oficiální základ poskytuje stabilní OpenAI feed specification a samostatný požadavek is_ads_eligible=true pro položky určené k Ads zpracování. Praktickou připravenost pak určuje vaše datová mapa, validace, testovací vzorek, odpovědnosti a pravidelná obnova. Až po zvládnutí těchto vrstev dává smysl řešit jemnější členění produktů do reklamních skupin a filtrů.